From a8c209fce10b5b3208451987782fd38e0a840624 Mon Sep 17 00:00:00 2001 From: Tom Lane Date: Wed, 11 Nov 2015 19:19:14 -0500 Subject: [PATCH] Do a round of copy-editing on the 9.5 release notes. Also fill in the previously empty "major enhancements" list. YMMV as to which items should make the cut, but it's past time we had something more than a placeholder here. (I meant to get this done before beta2 was wrapped, but got distracted by PDF build problems. Better late than never.) --- doc/src/sgml/release-9.5.sgml | 271 +++++++++++++++++++++------------- 1 file changed, 167 insertions(+), 104 deletions(-) diff --git a/doc/src/sgml/release-9.5.sgml b/doc/src/sgml/release-9.5.sgml index 64057c3f8a..110ba40c4d 100644 --- a/doc/src/sgml/release-9.5.sgml +++ b/doc/src/sgml/release-9.5.sgml @@ -23,7 +23,50 @@ - ... to be filled in ... + Allow INSERTS + that would generate constraint conflicts to be turned into + UPDATEs or ignored + + + + + + Add GROUP BY analysis functions GROUPING SETS, + CUBE and + ROLLUP + + + + + + Add row-level security control + + + + + + Allow labeling of + the origin of logical replication changes, and provide mechanisms + for tracking the progress of replication + + + + + + Add Block Range Indexes (BRIN) + + + + + + Substantial performance improvements for sorting + + + + + + Substantial performance improvements for multi-CPU machines @@ -88,6 +131,11 @@ Change pg_ctl's default shutdown mode from smart to fast (Bruce Momjian) + + + This means the default behavior will be to forcibly cancel existing + database sessions, not simply wait for them to exit. + @@ -255,8 +303,10 @@ max_wal_size = (3 * checkpoint_segments) * 16MB - BRIN indexes are very compact and cheap to update by - storing min/max values for a range of heap blocks. + BRIN indexes store only summary data (such as minimum + and maximum values) for ranges of heap blocks. They are therefore + very compact and cheap to update; but if the data is naturally + clustered, they can still provide substantial speedup of searches. @@ -273,9 +323,9 @@ max_wal_size = (3 * checkpoint_segments) * 16MB Previously, a common table expression was required to return a - large number of rows ordered by bounding-box distance, and then - filtered further with a more accurate non-bounding-box distance - calculation. + large number of rows ordered by bounding-box distance, and the + result then had to be filtered further with a more accurate + non-bounding-box distance calculation. @@ -335,9 +385,9 @@ Add GUC and storage parameter to set the maximum size of GIN pending list. 2015-05-13 [78efd5c] Robert..: Extend abbreviated key infrastructure to datum .. --> - Improve the speed of sorting VARCHAR, TEXT, - and NUMERIC fields (Peter Geoghegan, Andrew Gierth, - Robert Haas) + Improve the speed of sorting of varchar, text, + and numeric fields via abbreviated keys + (Peter Geoghegan, Andrew Gierth, Robert Haas) @@ -358,10 +408,9 @@ Add GUC and storage parameter to set the maximum size of GIN pending list. 2014-09-10 [45f6240] Heikki..: Pack tuples in a hash join batch densely, to sa.. 2014-09-12 [8cce08f] Robert..: Change NTUP_PER_BUCKET to 1 to improve hash joi.. 2014-10-13 [30d7ae3] Kevin ..: Increase number of hash join buckets for undere.. -FIXME: bad description? Should talk about hash joins --> - Improve in-memory hash performance (Tomas Vondra, Robert Haas) + Improve performance of hash joins (Tomas Vondra, Robert Haas) @@ -369,11 +418,10 @@ FIXME: bad description? Should talk about hash joins Improve concurrency of shared buffer replacement - (Robert Haas, Amit Kapila) + (Robert Haas, Amit Kapila, Andres Freund) @@ -397,12 +445,8 @@ FIXME: Add Andres 2015-01-19 [2d115e4] Andres..: Fix various shortcomings of the new PrivateRefC.. --> - Make backend local tracking of buffer pins memory efficient (Andres Freund) - - - - Previously each session allocated an array with space for every buffer - in shared_buffers. + Make per-backend tracking of buffer pins more memory-efficient + (Andres Freund) @@ -425,8 +469,8 @@ FIXME: Add Andres 2014-07-15 [f15821e] Tom Lane: Allow join removal in some cases involving a le.. --> - Allow the optimizer to remove unnecessary references to left - outer join subqueries (David Rowley) + Allow the optimizer to remove unnecessary references to left-joined + subqueries (David Rowley) @@ -435,7 +479,7 @@ FIXME: Add Andres 2014-06-27 [d222585] Tom Lane: Allow pushdown of WHERE quals into subqueries w.. --> - Allow pushdown of query restrictions into window functions, where appropriate (David Rowley) @@ -498,19 +542,20 @@ FIXME: Add Andres - - Speed up CREATE INDEX by avoiding unnecessary memory copies (Robert Haas) + + Speed up CREATE INDEX by avoiding unnecessary memory + copies (Robert Haas) - + Increase the number of buffer mapping partitions (Amit Kapila, Andres Freund, Robert Haas) @@ -534,12 +579,9 @@ FIXME: Add Andres 2015-04-03 [4ff695b1] Alvaro..: Add log_min_autovacuum_duration per-table option --> - Add per-table autovacuum logging control via - log_min_autovacuum_duration (Michael Paquier) - - - - NOT DOCUMENTED? + Add per-table autovacuum logging control via new + log_min_autovacuum_duration storage parameter + (Michael Paquier) @@ -677,17 +719,6 @@ FIXME: Add docs about restartpoint behaviour change - - Add configuration parameter to - control compression of full page images stored in WAL - (Rahila Syed, Michael Paquier) - - - - - @@ -736,7 +767,7 @@ FIXME: Add docs about restartpoint behaviour change This means that assertions can no longer be turned off if they were enabled at compile time, allowing for more - efficient code optimization. This change also removed the postgres @@ -789,7 +820,8 @@ FIXME: Add docs about restartpoint behaviour change Add pending_restart to the system view pg_settings to - indicate a change is pending a restart (Peter Eisentraut) + indicate a change has been made but will not take effect until a + database restart (Peter Eisentraut) @@ -804,7 +836,8 @@ FIXME: Add docs about restartpoint behaviour change - This command removes the setting from postgresql.auto.conf. + This command removes the specified setting + from postgresql.auto.conf. @@ -881,6 +914,23 @@ FIXME: Add docs about restartpoint behaviour change + + Allow compression of full-page images stored in WAL + (Rahila Syed, Michael Paquier) + + + + This feature reduces WAL volume, at the cost of more CPU time spent + on WAL logging and WAL replay. It is controlled by a new + configuration parameter , which + currently is off by default. + + + + + @@ -910,12 +960,11 @@ FIXME: Add docs about restartpoint behaviour change Allow labeling of - the origin progress of logical replication changes (Andres Freund) + the origin of logical replication changes, and provide mechanisms + for tracking the progress of replication (Andres Freund) @@ -926,7 +975,6 @@ FIXME: Correct description Report the processes holding replication slots in - Add new SELECT option + Add SELECT option SKIP LOCKED to skip locked rows (Thomas Munro) @@ -1216,12 +1264,11 @@ FIXME: Correct description - Commands include ALTER - USER, - ALTER + This includes ALTER + USER, ALTER GROUP, ALTER ROLE, GRANT, - and various ALTER OBJECT / OWNER TO commands. + and various ALTER object OWNER TO commands. @@ -1256,8 +1303,8 @@ FIXME: Correct description - Previously only UPDATE, DELETE, and - TRUNCATE privileges allowed this. + Previously this required UPDATE, DELETE, or + TRUNCATE privileges. @@ -1440,7 +1487,7 @@ FIXME: Better description? 2014-09-09 [57b1085] Peter ..: Allow empty content in xml type --> - Allow the XML data type + Allow the xml data type to accept empty or all-whitespace values (Peter Eisentraut) @@ -1455,7 +1502,7 @@ FIXME: Better description? 2014-10-21 [6f04368] Peter ..: Allow input format xxxx-xxxx-xxxx for macaddr .. --> - Allow MACADDR input + Allow macaddr input using the format xxxx-xxxx-xxxx (Herwin Weststrate) @@ -1467,7 +1514,7 @@ FIXME: Add more specifics? --> Tighten syntax of INTERVAL precision + linkend="datatype-interval-input">interval precision specifications (Bruce Momjian) @@ -1483,12 +1530,26 @@ FIXME: Add more specifics? --> Add selectivity estimators for INET/CIDR operators and improve + linkend="datatype-inet">inet/cidr operators and improve estimators for text search functions (Emre Hasegeli, Tom Lane) + + + + Add data + types regrole + and regnamespace + that simplify pretty-printing the OID of a role or + namespace (Kyotaro Horiguchi) + + + @@ -1515,8 +1576,8 @@ FIXME: Add more specifics? 2014-12-12 [7e354ab] Andrew..: Add several generator functions for jsonb that .. --> - Add several generator functions for JSONB that already - existed for JSON (Andrew Dunstan) + Add several generator functions for jsonb that already + existed for json (Andrew Dunstan) @@ -1541,8 +1602,8 @@ FIXME: Add more specifics? --> Reduce casting requirements to/from JSON and JSONB (Tom Lane) + linkend="datatype-json">json and jsonb (Tom Lane) @@ -1551,9 +1612,9 @@ FIXME: Add more specifics? 2015-06-11 [908e234] Andrew..: Rename jsonb - text[] operator to #- to avoid a.. --> - Allow TEXT, TEXT array, and INTEGER + Allow text, text array, and integer values to be subtracted - from JSONB documents (Dmitry Dolgov, Andrew Dunstan) + from jsonb documents (Dmitry Dolgov, Andrew Dunstan) @@ -1562,8 +1623,8 @@ FIXME: Add more specifics? 2015-05-12 [c694701] Andrew..: Additional functions and operators for jsonb --> - Add JSONB operator || + Add jsonb || operator (Dmitry Dolgov, Andrew Dunstan) @@ -1577,7 +1638,7 @@ FIXME: Add more specifics? linkend="functions-json-processing-table">json_strip_nulls() and jsonb_strip_nulls() - functions to remove JSON null values from documents + functions to remove json null values from documents (Andrew Dunstan) @@ -1599,7 +1660,7 @@ FIXME: Add more specifics? --> Add generate_series() - for NUMERIC values (Plato Malugin) + for numeric values (Plato Malugin) @@ -1759,7 +1820,7 @@ FIXME: Add more specifics? - This represents the last time the snapshot files was written to + This represents the last time the snapshot file was written to the file system. @@ -1774,18 +1835,6 @@ FIXME: Add more specifics? to compute multi-xid age (Bruce Momjian) - - - - - Add data types regrole regnamespace that returns - the OID of a role (Kyotaro Horiguchi) - - @@ -1800,9 +1849,9 @@ FIXME: Add more specifics? 2014-08-28 [6c40f83] Tom Lane: Add min and max aggregates for inet/cidr data t.. --> - Add MIN()/MAX() aggregates - for INET/CIDR data types (Haribabu + Add min()/max() aggregates + for inet/cidr data types (Haribabu Kommi) @@ -1813,8 +1862,8 @@ FIXME: Add more specifics? 2015-03-20 [959277a] Andres..: Use 128-bit math to accelerate some aggregation.. --> - Use 128-bit integers, where supported, as aggregate accumulators - (Andreas Karlsson) + Use 128-bit integers, where supported, as accumulators for some + aggregate functions (Andreas Karlsson) @@ -1851,7 +1900,7 @@ FIXME: Add more specifics? --> Reduce lossiness of PL/Python floating value + linkend="plpython">PL/Python floating-point value conversions (Marko Kreen) @@ -1943,6 +1992,11 @@ FIXME: Add more specifics? and pg_xlogdump from contrib to src/bin (Peter Eisentraut) + + + This should result in these programs being installed by default in + most installations. + @@ -1977,14 +2031,14 @@ FIXME: Add more specifics? 2014-11-18 [c4f99d2] Fujii ..: Add ––synchronous option to pg_receivexlog, for.. --> - Allow the pg_receivexlog - to synchronously flush WAL to storage using - - Without this, WAL files are fsynced only on close. + Without this, WAL files are fsync'ed only on close. @@ -1994,7 +2048,7 @@ FIXME: Add more specifics? --> Allow vacuumdb to - vacuum in parallel using @@ -2084,9 +2138,9 @@ FIXME: Add more specifics? 2014-09-02 [51bb795] Andres..: Add psql PROMPT variable showing which line of .. --> - Add psql PROMPT variables option - (%l) to display the multiline statement line number + Add new option %l in psql's PROMPT variables + to display the current multiline statement line number (Sawada Masahiko) @@ -2153,7 +2207,7 @@ FIXME: Add more specifics? - variables outputs psql variables + variables shows psql's special variables and options shows command-line options. \? commands is the default output. This help information can also be output via --help=section. @@ -2249,9 +2303,8 @@ FIXME: Add more specifics? The remote snapshot must have been exported by pg_export_snapshot() or logical replication slot - creation. This can be used by another pg_dump to - use a share a consistent snapshot across pg_dump - processes. + creation. This can be used to share a consistent snapshot + across multiple pg_dump processes. @@ -2480,6 +2533,16 @@ FIXME: Improve description, link + + Improve the representation of transaction commit and abort WAL + records (Andres Freund) + + + + + @@ -2666,8 +2729,8 @@ FIXME: Improve description, link 2014-07-12 [8d9a0e8] Magnus..: Support ––with-extra-version equivalent functi.. --> - Allow configure's -