From a5985a96a82d96704984377a96c1945bcf914646 Mon Sep 17 00:00:00 2001 From: Tom Lane Date: Fri, 11 May 2012 18:53:12 -0400 Subject: [PATCH] Explain compatibility item about language names a bit more. Since we've got an "open items" list item about this, apparently some people are pretty worried about it. In passing remove a lot of trailing whitespace. --- doc/src/sgml/release-9.2.sgml | 699 +++++++++++++++++----------------- 1 file changed, 351 insertions(+), 348 deletions(-) diff --git a/doc/src/sgml/release-9.2.sgml b/doc/src/sgml/release-9.2.sgml index 374ffb4599..fb603d2342 100644 --- a/doc/src/sgml/release-9.2.sgml +++ b/doc/src/sgml/release-9.2.sgml @@ -57,19 +57,19 @@ escapes special characters in string values (Florian Pflug, Radoslaw Smogura) - + Without this it is possible to output illegal XML. - + Remove hstore's => operator (Robert Haas, David Wheeler) - + Users should now use hstore(text, text). Since PostgreSQL 9.0, a warning message is @@ -78,20 +78,20 @@ another use. - + Have pg_relation_size() and friends return NULL if the object does not exist (Phil Sorber) - + This prevents queries that call these functions from returning errors during concurrent drop operations. - + Remove the pg_tablespace (Magnus Hagander, Tom Lane) - + This field was duplicative of the symbolic links already present in the data directory. This allows tablespace @@ -108,11 +108,11 @@ symbolic links. - + - Temporal Functions + Temporal Functions @@ -123,27 +123,27 @@ a non-timezone-aware value measure the epoch from local midnight, not UTC midnight (Tom Lane) - + Having these computations depend on UTC was inconsistent. The old behavior is available by casting the value to timestamp with time zone. - + Properly parse time strings with trailing yesterday, today, and tomorrow (Dean Rasheed) - + Previously, SELECT '04:00:00 yesterday'::timestamp returned yesterday's date at midnight. - + Fix to_timestamp() to wrap incomplete dates toward 2020 (Bruce Momjian) - + Previously, supplied years and year masks of less than four digits wrapped inconsistently. @@ -174,24 +174,27 @@ DOMAIN from working on non-domain types (Peter Eisentraut) - + Owner and schema changes were previously possible on non-domain types. - + No longer auto-lowercase procedural language names (Robert Haas) - + - While unquoted language identifiers are still lowercased, double - and single-quoted identifiers are no longer down-cased. + While unquoted language identifiers are still lowercased, strings + and quoted identifiers are no longer forcibly down-cased. + Thus for example CREATE FUNCTION ... LANGUAGE 'C' + will no longer work; it must be spelled 'c', or better + omit the quotes. - + @@ -208,14 +211,14 @@ linkend="APP-PSQL">psql meta-command arguments (Tom Lane) - + Previously, such usage was only properly expanded when isolated by whitespace, e.g. 'FOO'BAR was output as FOO BAR. - + No longer treat reindexdb table and index names as double-quoted (Bruce Momjian) - + Users must supply double-quotes in the command arguments to accomplish double-quoting behavior. @@ -239,32 +242,32 @@ Kupershmidt) - + No longer have createuser prompt for settings (Peter Eisentraut, Josh Kupershmidt) - + Previously createuser prompted regarding various user settings. - + Remove initdb support for the crypt authentication method (Peter Eisentraut) - + This was removed from the backend years ago. - - + + @@ -277,43 +280,43 @@ Remove the postgresql.conf setting silent_mode (Heikki Linnakangas) - + This behavior could already be accomplished with pg_ctl -l postmaster.log. - + Remove GUC wal_sender_delay, as it is no longer needed (Tom Lane) - + The new "latch" capability made this setting unnecessary. - + Remove the custom_variable_classes postgresql.conf parameter (Tom Lane) - + The checking provided by this setting was dubious. Now any setting can be prefixed by any class name. - + Add GUC parameters for specifying the locations of server-side SSL files (Peter Eisentraut) - + This allows changing the location of the files that were previously hard-coded to server.crt, server.key, @@ -322,7 +325,7 @@ names, and if specified, these files must exist. - + @@ -338,19 +341,19 @@ to pid, to match other system tables (Magnus Hagander) - + Create a separate pg_stat_activity column to report state information, e.g. idle (Scott Mead, Magnus Hagander, Greg Smith) - + The last query values are preserved, allowing for enhanced analysis. - + Rename pg_stat_activity.current_query to @@ -358,13 +361,13 @@ completes (Magnus Hagander) - + Change all SQL-level statistics timing values to float8-stored milliseconds (Tom Lane) - + The columns affected are: pg_stat_user_functions.total_time, @@ -373,7 +376,7 @@ pg_stat_xact_user_functions.self_time. - + Change pg_stat_statements' @@ -381,7 +384,7 @@ (Tom Lane) - + @@ -409,7 +412,7 @@ Allow queries to retrieve data only from indexes, avoiding heap access (Robert Haas, Ibrar Ahmed, Tom Lane) - + This is often called "index-only scans" or "covering indexes". This is possible for heap pages with exclusively all-visible @@ -424,7 +427,7 @@ lightweight lock mechanism (Robert Haas, Jeff Davis) - + Move the frequently accessed members of the PGPROC @@ -432,35 +435,35 @@ Deolasee, Heikki Linnakangas, Robert Haas) - + Reduce overhead of creating virtual transaction id locks (Robert Haas, Jeff Davis) - + Reduce overhead for shared invalidation cache messages (Robert Haas, Noah Misch) - + Improve performance of transactions using many savepoints (Simon Riggs, Robert Haas) PARTIALLY REVERTED. KEEP? - + Improve COPY performance by adding tuples to the heap in batches (Heikki Linnakangas) - + Improve GiST box and point index performance by producing better @@ -468,21 +471,21 @@ Heikki Linnakangas, Kevin Grittner) - + Allow hint bits to be set sooner for temporary and unlogged tables (Robert Haas) - + Reduce checkpoints and WAL traffic on low activity servers (Simon Riggs) - + Allow sorting to be performed by inlined and faster, @@ -490,34 +493,34 @@ Geoghegan, Robert Haas, Tom Lane) - + Add the SP-GiST (Space-Partitioned GiST) index access method (Teodor Sigaev, Oleg Bartunov, Tom Lane, Robert Haas) - + SP-GiST is comparable to GiST in flexibility, but supports non-balanced partitioned search structures rather than balanced trees. CLARIFY? - + Improve GiST index build times (Alexander Korotkov) - + Take fewer MVCC snapshots, for performance (Robert Haas, Dimitri Fontaine) - + Have the number of clog buffer count scale based on - + Reduce the overhead of serializable isolation level locks (Dan Ports, Heikki Linnakangas) - + Improve performance of WAL writes using group commit (Peter Geoghegan, Simon Riggs, Heikki Linnakangas) - + Improve PowerPC and Itanium spinlock performance (Manabu Ori, Tom Lane, Robert Haas) - + @@ -561,19 +564,19 @@ Create a dedicated worker process to perform checkpoints (Simon Riggs, Dickson Guedes) - + Formerly the background writer did dirty page writing and checkpointing. - + Improve asynchronous commit behavior by waking up sooner (Simon Riggs) - + Previously, only wal_writer_delay @@ -582,18 +585,18 @@ writes. - + Allow backends to detect postmaster death via a pipe read failure, rather than polling (Peter Geoghegan, Heikki Linnakangas) - + The wait events are internally called "latches". - + Allow the bgwriter, @@ -602,24 +605,24 @@ and checkpointer to sleep more efficiently during periods of inactivity (Peter Geoghegan, Heikki Linnakangas, Tom Lane) - + This reduces CPU wake-ups, which dramatically reduces power consumption on idle servers. - + Pass the safe number of file descriptors to Windows processes (Heikki Linnakangas) - + This allows Windows sessions to cache more open file descriptors. - + @@ -634,7 +637,7 @@ Improve the ability of the planner to choose parameterized plans (Tom Lane) - + A prepared statement is now parsed, analyzed, and rewritten, but not necessarily planned. When the prepared plan is executed @@ -643,55 +646,55 @@ of a constant-specific plan. CLARIFY - + Allow the optimizer to use CHECK constraints defined on tables referenced in subqueries in planning decisions (Tom Lane) - + This is only enabled when constraint_exclusion = on. - + Allow indexedcol op ANY(ARRAY[...]) conditions to be used in plain indexscans (Tom Lane) - + Improve heuristics for determining the type of unknown values by considering other data types involved in the operation (Tom Lane) - + Allow better matching of index columns with non-default operator qualifications (Tom Lane) - + Improve the planner's ability to use nested loops with inner index scans (Tom Lane) - + Support MIN/MAX index optimizations on boolean columns (Marti Raudsepp, Abhijit Menon-Sen) - + @@ -704,39 +707,39 @@ subqueries (Tom Lane) - + Improve optimizer estimation for subqueries using DISTINCT (Tom Lane) - + Collect and use element-frequency statistics for arrays (Alexander Korotkov, Noah Misch, Nathan Boley, Tom Lane, Daniele Varrazzo) - + This patch improves selectivity estimation for the array <@, &&, and @> (containment and overlaps) array operators. - + Improve costing of partial indexes (Tom Lane) - + Allow analyze statistics to be collected for foreign tables (Etsuro Fujita, Shigeru Hanada, Tom Lane) - + @@ -754,22 +757,22 @@ linkend="auth-pg-hba-conf">pg_hba.conf include superusers (Andrew Dunstan, Robert Haas) - + This makes it easier to use reject lines with group roles. - + Make superuser imply replication privilege (Noah Misch) - + This avoids the need to explicitly assign such privileges. - + Adjust pg_hba.conf processing to more @@ -777,17 +780,17 @@ Herrera, Pavel Stehule) - + Disallow empty pg_hba.conf files (Tom Lane) - + This was done to more quickly report misconfiguration. - + @@ -803,31 +806,31 @@ (Marti Raudsepp, PDXPUG, Tom Lane) - + Make logging of autovacuum I/O activity more verbose (Greg Smith, Noah Misch) - + This logging is triggered by log_autovacuum_min_duration. - + Have WAL replay report failures sooner (Fujii Masao) - + There were some cases where failures were only reported once the server went into master mode. - + Add - + This is useful for computing replication lag. - + Support configurable eventlog application names on Windows (MauMau, Magnus Hagander) - + This allows different instances to use the eventlog with different identifiers, by setting the syslog_ident works. - + Change "unexpected EOF" message to DEBUG1 level (Magnus Hagander) - + @@ -879,14 +882,14 @@ system view (Tomas Vondra) - + Add a deadlock counter to the pg_stat_database system view (Magnus Hagander, Jaime Casanova) - + Add a GUC setting - + Report checkpoint timing information in - + @@ -919,7 +922,7 @@ to be set per-session by superusers, not just per-cluster (Noah Misch, Shigeru Hanada) - + This allows deadlock_timeout to be reduced for transactions that are likely to be involved in a deadlock, @@ -944,39 +947,39 @@ Sending Servers" (Fujii Masao) - + Allow a superuser to SET an extension's superuser-only custom variable before loading the associated extension (Tom Lane) - + The system now remembers whether a SET was performed by a superuser. - + Add postmaster - + This allows pg_ctl to better handle configuration-only directory installations. - + Force the locale to be recorded more specifically, rather than using the empty string to mean the default (Tom Lane) - + @@ -991,32 +994,32 @@ Andy Colson) - + Allow a reload of postgresql.conf to be processed by all backends even if there are some settings that are invalid for that session (Alexey Klyukin, Andy Colson) - + Previously, such not-valid-for-session errors would cause all setting changes to be ignored by that backend. - + Add an include_if_exists facility for configuration files (Greg Smith, Euler Taveira de Oliveira) - + This works the same as include, except that an error is not thrown if the file is missing. - + Check the server time zone during initdb, and set @@ -1025,12 +1028,12 @@ log_timezone accordingly (Tom Lane) - + This avoids expensive time zone probes during server start. - + Allow Windows to report @@ -1039,11 +1042,11 @@ (Tom Lane) - + - + @@ -1061,14 +1064,14 @@ Allow streaming replications slaves to serve other slaves (Fujii Masao, Simon Riggs) - + Previously, only the master server could supply streaming replication log files to standby servers. Slaves can also now do continuous archiving. (?) - + Add new remote_write (Fujii Masao and Simon Riggs) - + This only writes data to the socket, but does not wait a write to the remote disk. - + Add a - + Send keepalive messages to standby servers (Simon Riggs) - + This allows administrators to accurately calculate streaming replication transfer and application latency. - + @@ -1115,27 +1118,27 @@ Allow streaming of xlog files while pg_basebackup is performing a backup (Magnus Hagander) - + This allows passing of xlog files to the standby before they are discarded on the primary. - + Allow pg_basebackup to pull from standby servers (Jun Ishizuka, Fujii Masao) - + Exclude the postmaster.opts file from pg_basebackup backups (Magnus Hagander) - + @@ -1153,55 +1156,55 @@ Improve columns labels produced by subqueries (Marti Raudsepp, Kyotaro Horiugchi) - + Previously, the generic label ?column? was used. - + Preserve column names in row expressions (Andrew Dunstan, Tom Lane) - + Cancel queries if clients get disconnected (Florian Pflug, Greg Jaskiewicz) - + Silently ignore nonexistent schemas specified in search_path (Tom Lane) - + Warn about casts to and from domain types (Robert Haas) - + Such casts have no effect. - + When a row fails a CHECK or NOT NULL constraint, show the row's contents in errdetail (Jan Kundrát, Royce Ausburn, Tom Lane) - + This should make it easier to identify which row is problematic when an insert or update is processing many rows. - + @@ -1217,19 +1220,19 @@ DDL (Robert Haas, Noah Misch) - + Add CONCURRENTLY option to DROP INDEX CONCURRENTLY (Simon Riggs) - + This allows index removal without blocking other sessions. - + @@ -1243,13 +1246,13 @@ constraints to be declared NOT VALID (Álvaro Herrera, Thom Brown, Dean Rasheed, Jaime Casanova) - + A NOT VALID CHECK constraint can be added to a table without the table's data being verified against the constraint. New rows are verified. - + Such constraints are ignored by the planner when considering constraint_exclusion. ALTER TABLE / @@ -1259,38 +1262,38 @@ cached plans. - + Allow CHECK constraints to be declared NO INHERIT (Nikhil Sontakke, Alex Hunsaker) - + This makes them enforceable only on the parent table, not on child tables. - + Add the ability to rename constraints (Peter Eisentraut) - + Disallow merging of ONLY and non-ONLY constraints in child tables (Nikhil Sontakke) - + Such merging would cause unpredictable behavior in grandchild tables. - + @@ -1307,19 +1310,19 @@ operations (Noah Misch) DUPLICATE? - + Add IF EXIST clause to ALTER commands (Pavel Stehule) - + For example, ALTER FOREIGN TABLE IF EXISTS foo RENAME TO bar. - + Add ALTER @@ -1328,31 +1331,31 @@ SERVER / RENAME (Peter Eisentraut) - + Add ALTER DOMAIN / RENAME (Peter Eisentraut) - + You could already rename domains using ALTER TYPE. - + Throw an error for ALTER DOMAIN / DROP CONSTRAINT on a nonexistent constraint (Peter Eisentraut) - + An IF EXISTS option has been added to enable the previous behavior. - + @@ -1369,37 +1372,37 @@ (Tom Lane) - + Support CREATE TABLE (LIKE ...) from foreign tables and views (Peter Eisentraut) - + Allow CREATE TABLE (LIKE ...) from composite type (Peter Eisentraut) - + This also allows a table to be created whose schema matches a view. - + Tighten creation of tables in temporary schemas (Robert Haas) - + Previously, it was possible to create unlogged tables in temporary schemas, and temporary tables in the temporary schemas of other sessions. - + @@ -1415,14 +1418,14 @@ linkend="SQL-CREATEVIEW">security_barrier option for views (KaiGai Kohei, Noah Misch) - + This prevents security_barrier views from being moved into other scopes, preventing possible leakage of view-prohibited data. Such views might perform more poorly. - + Add a new security_barrier views (KaiGai Kohei) - + Add support for privileges on date types (Peter Eisentraut, Yeb Havinga) - + This adds support for the SQL-conforming USAGE privilege on types and domains. The intent is @@ -1445,14 +1448,14 @@ which restricts the way in which owners can alter types. - + Check for INSERT privileges in SELECT INTO / CREATE TABLE AS (KaiGai Kohei, Albe Laurenz) - + Because the object is being created by SELECT INTO or CREATE TABLE AS, it will @@ -1460,7 +1463,7 @@ PRIVILEGES has removed such permissions, hence the need for a permission check. - + @@ -1478,13 +1481,13 @@ Allow vacuum to more easily skip pages that cannot be locked (Simon Riggs, Robert Haas) - + This change should greatly reduce the incidence of vacuum getting "stuck". - + @@ -1498,26 +1501,26 @@ and written (Robert Haas, Fujii Masao, Greg Smith) - + Have EXPLAIN ANALYZE report the number of rows rejected by filter steps (Marko Tiikkaja, Marc Cousin) - + Allow EXPLAIN to avoid timing overhead when time values are unwanted (Tomas Vondra, Eric Theise) - + This is accomplished by setting TIMING to FALSE. - + @@ -1534,13 +1537,13 @@ Add a JSON data type (Robert Haas) AUTHOR? - + This stores JSON data as text after proper validation. - + Add row_to_json() (Andrew Dunstan, Abhijit Menon-Sen) - + Add support for range data types (Jeff Davis, Tom Lane, Alexander Korotkov) - + The range data type records a lower and upper bound, and supports operations like contains, overlaps, and intersection. - + Add SMALLSERIAL data type (Mike Pultz, Brar Piening, Josh Kupershmidt) - + This is like SERIAL, except it stores the sequence in a two-byte integer column (int2). - + Allow domains to be declared NOT VALID (Álvaro Herrera, Thom Brown, Dean Rasheed, Jaime Casanova, Peter Eisentraut) - + This can be set at domain creation time, or via ALTER DOMAIN / ADD CONSTRAINT / NOT @@ -1587,19 +1590,19 @@ CONSTRAINT fully validates the domain. - + Support more locale-specific formatting options for the MONEY data type (Tom Lane) - + Specifically, display the plus/minus sign, currency symbol, and separators in a locale-specific order. CORRECT? - + Add bitwise "and", "or", and "not" - + @@ -1621,13 +1624,13 @@ XML array when supplied a scalar value (Florian Pflug, Radoslaw Smogura) - + Previously, it returned an empty array. This change will also cause xpath_exists() to return true, not false, for such expressions. - + @@ -1653,12 +1656,12 @@ linkend="functions-admin-signal">pg_cancel_backend() (Magnus Hagander) - + Previously only the superuser could cancel queries. - + Allow - + Allow regular expressions to use back-references (Tom Lane) - + For example, '^(\w+)( \1)+$'. - + Allow importing and exporting of transaction snapshots (Joachim Wieland, Marko Tiikkaja, Tom Lane) - + Snapshots are exported via pg_export_snapshot(), @@ -1690,19 +1693,19 @@ Only snapshots of currently-running transactions can be imported. - + Support COLLATION FOR on expressions (Peter Eisentraut, Jaime Casanova) - + This returns a string representing the collation of the expression. - + Add a NUMERIC variant of pg_xlog_location_diff() (Fujii Masao) - + @@ -1723,24 +1726,24 @@ Change default names of triggers to fire "action" triggers before "check" triggers (Tom Lane) - + This allows default-named check triggers to check post-action rows. - + Add a pg_trigger_depth() function (Kevin Grittner) - + This reports the current trigger call depth. - + @@ -1762,21 +1765,21 @@ Allow per-column foreign data wrapper options and force_not_null (Shigeru Hanada, KaiGai Kohei) - + This allows SQL specification of per-column information useful to foreign data sources. Includes psql option display support. - + Improve pretty printing of view definitions (Andrew Dunstan, Hitoshi Harada) - + @@ -1801,52 +1804,52 @@ (Peter Eisentraut) - + Implement information schema interval_type columns (Peter Eisentraut) - + Add collation columns to various information schema views (Peter Eisentraut) - + Specifically, provide collation columns for views referencing attributes, columns, domains, and element_types. - + Add display of sequence USAGE privileges to information schema (Peter Eisentraut) - + Add a with_hierarchy column to the information schema privileges display (Peter Eisentraut) - + Have the information schema show default privileges (Peter Eisentraut, Abhijit Menon-Sen) - + Previously, default permissions generated NULL fields. (WAS IT NULL?) - + @@ -1867,7 +1870,7 @@ parameters by name (Yeb Havinga, Kevin Grittner, Tom Lane) - + Add a GET STACKED DIAGNOSTICS PL/pgSQL command @@ -1875,28 +1878,28 @@ David Wheeler) - + Speed up PL/pgSQL array assignment by caching type information (Pavel Stehule) - + Improve performance and memory consumption of the PL/pgSQL ELSIF clauses (Tom Lane) - + Output the function signature, not just the name, in PL/pgSQL error messages (Pavel Stehule, Abhijit Menon-Sen, Tom Lane) - + @@ -1912,7 +1915,7 @@ (Andrew Dunstan) DETAILS? - + @@ -1927,7 +1930,7 @@ Add PL/Python SPI cursor support (Jan Urbanski, Steve Singer) - + This allows PL/Python to read partial result sets. @@ -1938,13 +1941,13 @@ Add result metadata functions to PL/Python (Peter Eisentraut, Abhijit Menon-Sen) - + Specifically, this adds result object functions .colnames, .coltypes, and .coltypmods. - + @@ -1958,14 +1961,14 @@ Allow SQL-language functions to reference parameters by name (Matthew Draper, Hitoshi Harada) - + To use this, simply name the function arguments and reference the argument names in the SQL function body. - + @@ -1981,14 +1984,14 @@ options