diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 8d7d9a2f3e8e8..a6d79765c1a73 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1824,13 +1824,23 @@ SELECT NOT(ROW(table.*) IS NOT NULL) FROM TABLE; -- detect at least one null in
which operand falls in a histogram
having count equal-width buckets spanning the
range low to high.
- Returns 0
+ The buckets have inclusive lower bounds and exclusive upper bounds.
+ Returns 0 for an input less
+ than low,
or count+1 for an input
- outside that range.
+ greater than or equal to high.
+ If low > high,
+ the behavior is mirror-reversed, with bucket 1
+ now being the one just below low, and the
+ inclusive bounds now being on the upper side.
width_bucket(5.35, 0.024, 10.06, 5)3
+
+
+ width_bucket(9, 10, 0, 10)
+ 2
@@ -1842,8 +1852,8 @@ SELECT NOT(ROW(table.*) IS NOT NULL) FROM TABLE; -- detect at least one null in
Returns the number of the bucket in
which operand falls given an array listing the
- lower bounds of the buckets. Returns 0 for an
- input less than the first lower
+ inclusive lower bounds of the buckets.
+ Returns 0 for an input less than the first lower
bound. operand and the array elements can be
of any type having standard comparison operators.
The thresholds array must be
diff --git a/doc/src/sgml/release-18.sgml b/doc/src/sgml/release-18.sgml
index 11a4f99a27236..662c7d8890f9b 100644
--- a/doc/src/sgml/release-18.sgml
+++ b/doc/src/sgml/release-18.sgml
@@ -6,7 +6,7 @@
Release date:
- 2025-??-??, CURRENT AS OF 2025-05-23
+ 2025-??-??, CURRENT AS OF 2025-06-20
@@ -58,68 +58,80 @@ Author: Peter Eisentraut
2024-10-16 [04bec894a04] initdb: Change default to using data checksums.
-->
-
-
-Change default to enable data checksums (Greg Sabino Mullane)
-§
-
+
+
+ Change default to enable data checksums
+ (Greg Sabino Mullane)
+ §
+
-
-Checksums can be disabled with the new initdb option .
- requires matching cluster checksum settings, so this new
-option can be useful to upgrade non-checksum old clusters.
-
-
+
+ Checksums can be disabled with the
+ new initdb option
+ .
+ requires matching cluster checksum settings, so this new option can
+ be useful to upgrade non-checksum old clusters.
+
+
-
-
-Change time zone abbreviation handling (Tom Lane)
-§
-
+
+
+ Change time zone abbreviation handling (Tom Lane)
+ §
+
-
-The system will now favor the current session's time zone abbreviations before checking the server variable . Previously timezone_abbreviations was
-checked first.
-
-
+
+ The system will now favor the current session's time
+ zone abbreviations before checking the server variable
+ . Previously
+ timezone_abbreviations was checked first.
+
+
-
-
-Deprecate MD5 password authentication (Nathan Bossart)
-§
-
+
+
+ Deprecate MD5 password
+ authentication (Nathan Bossart)
+ §
+
-
-Support for MD5 passwords will be removed in a future major version release. and now emit deprecation warnings when setting MD5 passwords.
-These warnings can be disabled by setting the parameter to off.
-
-
+
+ Support for MD5 passwords will be removed in a future major
+ version release. and now emit deprecation warnings when
+ setting MD5 passwords. These warnings can be disabled by setting
+ the parameter to
+ off.
+
+
-
-
-Change and to process the inheritance children of a parent (Michael Harris)
-§
-
+
+
+ Change and
+ to process the inheritance children of a parent (Michael Harris)
+ §
+
-
-The previous behavior can be performed by using the new ONLY option.
-
-
+
+ The previous behavior can be performed by using the new
+ ONLY option.
+
+
-
-
-Prevent COPY FROM from treating \. as an end-of-file marker when reading CSV files (Daniel Vérité, Tom Lane)
-§
-§
-
+
+
+ Prevent COPY FROM
+ from treating \. as an end-of-file marker when
+ reading CSV files (Daniel Vérité, Tom Lane)
+ §
+ §
+
-
- will still treat \. as an end-of-file marker when reading CSV files from STDIN. Older psql clients connecting to PostgreSQL 18 servers might
-experience \copy problems. This
-release also enforces that \. must appear alone on a line.
-
-
+
+ will still treat
+ \. as an end-of-file marker when reading
+ CSV files from STDIN.
+ Older psql clients connecting to
+ PostgreSQL 18 servers might experience \copy
+ problems. This release also enforces that \.
+ must appear alone on a line.
+
+
-
-
-Disallow unlogged partitioned tables (Michael Paquier)
-§
-
+
+
+ Disallow unlogged partitioned tables (Michael Paquier)
+ §
+
-
-Previously ALTER TABLE SET [UN]LOGGED did nothing, and the creation of an unlogged partitioned table did not cause its children to be unlogged.
-
-
+
+ Previously ALTER TABLE SET
+ [UN]LOGGED did nothing, and the creation of an
+ unlogged partitioned table did not cause its children to be unlogged.
+
+
-
-
-Execute AFTER triggers as the role that was active when trigger events were queued (Laurenz Albe)
-§
-
+
+
+ Execute AFTER triggers as the role that was active when
+ trigger events were queued (Laurenz Albe)
+ §
+
-
-Previously such triggers were run as the role that was active at trigger execution time (e.g., at ). This is significant for cases where the role is changed between queue time and
-transaction commit.
-
-
+
+ Previously such triggers were run as the role that was active at
+ trigger execution time (e.g., at ).
+ This is significant for cases where the role is changed between queue
+ time and transaction commit.
+
+
-
-
-Remove non-functional support for rule privileges in / (Fujii Masao)
-§
-
+
+
+ Remove non-functional support for rule privileges in / (Fujii Masao)
+ §
+
-
-These have been non-functional since PostgreSQL 8.2.
-
-
+
+ These have been non-functional since
+ PostgreSQL 8.2.
+
+
-
-
-Remove column pg_backend_memory_contexts.parent (Melih Mutlu)
-§
-
+
+
+ Remove column pg_backend_memory_contexts.parent
+ (Melih Mutlu)
+ §
+
-
-This is no longer needed since pg_backend_memory_contexts.path was added.
-
-
+
+ This is no longer needed since
+ pg_backend_memory_contexts.path
+ was added.
+
+
-
-
-Change pg_backend_memory_contexts.level and pg_log_backend_memory_contexts() to be one-based (Melih Mutlu, Atsushi Torikoshi, David Rowley, Fujii Masao)
-§
-§
-§
-
+
+
+ Change
+ pg_backend_memory_contexts.level
+ and pg_log_backend_memory_contexts()
+ to be one-based (Melih Mutlu, Atsushi Torikoshi, David Rowley,
+ Fujii Masao)
+ §
+ §
+ §
+
-
-These were previously zero-based.
-
-
+
+ These were previously zero-based.
+
+
@@ -256,40 +292,48 @@ Author: Alexander Korotkov
2025-02-17 [fc069a3a6] Implement Self-Join Elimination
-->
-
-
-Automatically remove some unnecessary table self-joins (Andrey Lepikhov, Alexander Kuzmenkov, Alexander Korotkov, Alena Rybakina)
-§
-
+
+
+ Automatically remove some unnecessary table self-joins (Andrey
+ Lepikhov, Alexander Kuzmenkov, Alexander Korotkov, Alena Rybakina)
+ §
+
-
-This optimization can be disabled using server variable .
-
-
+
+ This optimization can be disabled using server variable .
+
+
-
-
-Convert some IN (VALUES ...) to x = ANY ... for better optimizer statistics (Alena Rybakina, Andrei Lepikhov)
-§
-
-
+
+
+ Convert some IN (VALUES
+ ...) to x = ANY ... for better
+ optimizer statistics (Alena Rybakina, Andrei Lepikhov)
+ §
+
+
-
-
-Allow transforming OR-clauses to arrays for faster index processing (Alexander Korotkov, Andrey Lepikhov)
-§
-
-
+
+
+ Allow transforming OR-clauses
+ to arrays for faster index processing (Alexander Korotkov, Andrey
+ Lepikhov)
+ §
+
+
-
-
-Speed up the processing of INTERSECT, EXCEPT, window aggregates, and view column aliases (Tom Lane, David Rowley)
-§
-§
-§
-§
-
-
+
+
+ Speed up the processing of INTERSECT,
+ EXCEPT, window aggregates, and view column aliases (Tom Lane,
+ David Rowley)
+ §
+ §
+ §
+ §
+
+
-
-
-Allow the keys of SELECT DISTINCT to be internally reordered to avoid sorting (Richard Guo)
-§
-
+
+
+ Allow the keys of SELECT
+ DISTINCT to be internally reordered to avoid sorting
+ (Richard Guo)
+ §
+
-
-This optimization can be disabled using .
-
-
+
+ This optimization can be disabled using .
+
+
-
-
-Ignore GROUP BY columns that are functionally dependent on other columns (Zhang Mingli, Jian He, David Rowley)
-§
-
+
+
+ Ignore GROUP BY
+ columns that are functionally dependent on other columns (Zhang
+ Mingli, Jian He, David Rowley)
+ §
+
-
-If a GROUP BY clause includes all columns of a unique index, as well as other columns of the same table, those other columns are redundant and can be dropped
-from the grouping. This was already true for non-deferred primary keys.
-
-
+
+ If a GROUP BY clause includes all columns of
+ a unique index, as well as other columns of the same table, those
+ other columns are redundant and can be dropped from the grouping.
+ This was already true for non-deferred primary keys.
+
+
-
-
-Allow some HAVING clauses on GROUPING SETS to be pushed to WHERE clauses (Richard Guo)
-§
-§
-§
-§
-
-
-
-This allows earlier row filtering. This release also fixes some GROUPING SETS queries that used to return incorrect results.
-
-
+
+
+ Allow some HAVING clauses
+ on GROUPING
+ SETS to be pushed to WHERE clauses
+ (Richard Guo)
+ §
+ §
+ §
+ §
+
+
+
+ This allows earlier row filtering. This release also fixes some
+ GROUPING SETS queries that used to return
+ incorrect results.
+
+
-
-
-Improve row estimates for generate_series() using numeric and timestamp values (David Rowley, Song Jinzhou)
-§
-§
-
-
+
+
+ Improve row estimates for generate_series()
+ using numeric
+ and timestamp
+ values (David Rowley, Song Jinzhou)
+ §
+ §
+
+
-
-
-Allow the optimizer to use Right Semi Join plans (Richard Guo)
-§
-
+
+
+ Allow the optimizer to use Right Semi Join plans
+ (Richard Guo)
+ §
+
-
-Semi-joins are used when needing to find if there is at least one match.
-
-
+
+ Semi-joins are used when needing to find if there is at least
+ one match.
+
+
-
-
-Allow merge joins to use incremental sorts (Richard Guo)
-§
-
-
+
+
+ Allow merge joins to use incremental sorts
+ (Richard Guo)
+ §
+
+
-
-
-Improve the efficiency of planning queries accessing many partitions (Ashutosh Bapat, Yuya Watari, David Rowley)
-§
-§
-
-
+
+
+ Improve the efficiency of planning queries accessing many partitions
+ (Ashutosh Bapat, Yuya Watari, David Rowley)
+ §
+ §
+
+
-
-
-Allow partitionwise joins in more cases, and reduce its memory usage (Richard Guo, Tom Lane, Ashutosh Bapat)
-§
-§
-
-
+
+
+ Allow partitionwise
+ joins in more cases, and reduce its memory usage (Richard Guo,
+ Tom Lane, Ashutosh Bapat)
+ §
+ §
+
+
-
-
-Improve cost estimates of partition queries (Nikita Malakhov, Andrei Lepikhov)
-§
-
-
+
+
+ Improve cost estimates of partition queries (Nikita Malakhov,
+ Andrei Lepikhov)
+ §
+
+
-
-
-Improve SQL-language function plan caching (Alexander Pyhalov, Tom Lane)
-§
-§
-
-
+
+
+ Improve SQL-language
+ function plan caching (Alexander Pyhalov, Tom Lane)
+ §
+ §
+
+
-
-
-Improve handling of disabled optimizer features (Robert Haas)
-§
-
-
+
+
+ Improve handling of disabled optimizer features (Robert Haas)
+ §
+
+
@@ -498,18 +574,19 @@ Author: Peter Geoghegan
2025-04-04 [8a510275d] Further optimize nbtree search scan key comparisons.
-->
-
-
-Allow skip scans of btree indexes (Peter Geoghegan)
-§
-§
-
+
+
+ Allow skip scans of btree indexes
+ (Peter Geoghegan)
+ §
+ §
+
-
-This allows multi-column btree indexes to be used by queries that only
-equality-reference the second or later indexed columns.
-
-
+
+ This allows multi-column btree indexes to be used by queries that
+ only equality-reference the second or later indexed columns.
+
+
-
-
-Allow non-btree unique indexes to be used as partition keys and in materialized views (Mark Dilger)
-§
-§
-
+
+
+ Allow non-btree unique indexes to be used as partition keys and in
+ materialized views (Mark Dilger)
+ §
+ §
+
-
-The index type must still support equality.
-
-
+
+ The index type must still support equality.
+
+
-
-
-Allow GIN indexes to be created in parallel (Tomas Vondra, Matthias van de Meent)
-§
-
-
+
+
+ Allow GIN indexes to
+ be created in parallel (Tomas Vondra, Matthias van de Meent)
+ §
+
+
-
-
-Allow values to be sorted to speed range-type GiST and btree index builds (Bernd Helmle)
-§
-
-
+
+
+ Allow values to be sorted to speed range-type GiST and btree
+ index builds (Bernd Helmle)
+ §
+
+
@@ -588,41 +669,51 @@ Author: Andres Freund
2025-03-30 [2a5e709e7] Enable IO concurrency on all systems
-->
-
-
-Add an asynchronous I/O subsystem (Andres Freund, Thomas Munro, Nazir Bilal Yavuz, Melanie Plageman)
-§
-§
-§
-§
-§
-§
-§
-§
-§
-§
-§
-
-
-
-This feature allows backends to queue multiple read requests, which allows for more efficient sequential scans, bitmap heap scans, vacuums, etc.
-This is enabled by server variable , with server variables and added to control it. This also enables
- and values greater than zero for systems without fadvise() support. The new system view pg_aios shows the file handles being used
-for asynchronous I/O.
-
-
+
+
+ Add an asynchronous I/O subsystem (Andres Freund, Thomas Munro,
+ Nazir Bilal Yavuz, Melanie Plageman)
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+
+
+
+ This feature allows backends to queue multiple read requests,
+ which allows for more efficient sequential scans, bitmap
+ heap scans, vacuums, etc. This is enabled by server
+ variable , with server
+ variables and added to control it.
+ This also enables
+ and
+ values greater than zero for systems without
+ fadvise() support. The new system view pg_aios
+ shows the file handles being used for asynchronous I/O.
+
+
-
-
-Improve the locking performance of queries that access many relations (Tomas Vondra)
-§
-
-
+
+
+ Improve the locking performance of queries that access many relations
+ (Tomas Vondra)
+ §
+
+
-
-
-Improve the performance and reduce memory usage of hash joins and GROUP BY (David Rowley, Jeff Davis)
-§
-§
-§
-§
-§
-
+
+
+ Improve the performance and reduce memory usage of hash joins and
+ GROUP BY
+ (David Rowley, Jeff Davis)
+ §
+ §
+ §
+ §
+ §
+
-
-This also improves hash set operations used by EXCEPT, and hash lookups of subplan values.
-
-
+
+ This also improves hash set operations used by EXCEPT, and hash
+ lookups of subplan values.
+
+
-
-
-Allow normal vacuums to freeze some pages, even though they are all-visible (Melanie Plageman)
-§
-§
-
+
+
+ Allow normal vacuums to freeze some pages, even though they are
+ all-visible (Melanie Plageman)
+ §
+ §
+
-
-This reduces the overhead of later full-relation freezing. The aggressiveness of this can be controlled by server variable and per-table setting .
-Previously vacuum never processed all-visible pages until freezing was required.
-
-
+
+ This reduces the overhead of later full-relation
+ freezing. The aggressiveness of this can be
+ controlled by server variable and per-table setting . Previously
+ vacuum never processed all-visible pages until freezing was required.
+
+
-
-
-Add server variable to control file truncation during (Nathan Bossart, Gurjeet Singh)
-§
-
+
+
+ Add server variable to control
+ file truncation during (Nathan Bossart,
+ Gurjeet Singh)
+ §
+
-
-A storage-level parameter with the same name and behavior already existed.
-
-
+
+ A storage-level parameter with the same name and behavior already
+ existed.
+
+
-
-
-Increase server variables 's and 's default values to 16 (Melanie Plageman)
-§
-§
-
+
+
+ Increase server variables 's and 's default values to 16
+ (Melanie Plageman)
+ §
+ §
+
-
-This more accurately reflects modern hardware.
-
-
+
+ This more accurately reflects modern hardware.
+
+
@@ -721,72 +826,90 @@ Author: Melanie Plageman
2025-03-12 [9219093ca] Modularize log_connections output
-->
-
-
-Increase the logging granularity of server variable (Melanie Plageman)
-§
-
+
+
+ Increase the logging granularity of server variable (Melanie Plageman)
+ §
+
-
-This server variable was previously only boolean; these options are still supported.
-
-
+
+ This server variable was previously only boolean, which is still
+ supported.
+
+
-
-
-Add log_connections option to report the duration of connection stages (Melanie Plageman)
-§
-
-
+
+
+ Add log_connections option to report the duration
+ of connection stages (Melanie Plageman)
+ §
+
+
-
-
-Add escape %L to output the client IP address (Greg Sabino Mullane)
-§
-
-
+
+
+ Add escape
+ %L to output the client IP
+ address (Greg Sabino Mullane)
+ §
+
+
-
-
-Add server variable to log lock acquisition failures (Yuki Seino)
-§
-
+
+
+ Add server variable to log
+ lock acquisition failures (Yuki Seino, Fujii Masao)
+ §
+ §
+
-
-Specifically it reports SELECT ... NOWAIT lock failures.
-
-
+
+ Specifically it reports SELECT
+ ... NOWAIT lock failures.
+
+
-
-
-Modify pg_stat_all_tables and its variants to report the time spent in VACUUM, ANALYZE, and their automatic variants (Sami Imseih)
-§
-
+
+
+ Modify pg_stat_all_tables
+ and its variants to report the time spent in , , and their
+ automatic variants (Sami Imseih)
+ §
+
-
-The new columns are total_vacuum_time, total_autovacuum_time, total_analyze_time, and total_autoanalyze_time.
-
-
+
+ The new columns are total_vacuum_time,
+ total_autovacuum_time,
+ total_analyze_time, and
+ total_autoanalyze_time.
+
+
-
-
-Add delay time reporting to and (Bertrand Drouvot, Nathan Bossart)
-§
-§
-
+
+
+ Add delay time reporting to and (Bertrand Drouvot, Nathan Bossart)
+ §
+ §
+
-
-This information appears in the autovacuum logs, the system views pg_stat_progress_vacuum and pg_stat_progress_analyze, and the output of VACUUM and ANALYZE when in VERBOSE
-mode; tracking must be enabled with the server variable .
-
-
+
+ This information appears in the server log, the system views pg_stat_progress_vacuum
+ and pg_stat_progress_analyze,
+ and the output of and when in VERBOSE
+ mode; tracking must be enabled with the server variable .
+
+
-
-
-Add WAL, CPU, and average read statistics output to ANALYZE VERBOSE (Anthonin Bonnefoy)
-§
-§
-
-
+
+
+ Add WAL, CPU, and average
+ read statistics output to ANALYZE VERBOSE
+ (Anthonin Bonnefoy)
+ §
+ §
+
+
-
-
-Add full WAL buffer count to VACUUM/ANALYZE (VERBOSE) and autovacuum log output (Bertrand Drouvot)
-§
-
-
+
+
+ Add full WAL buffer count to
+ VACUUM/ANALYZE (VERBOSE)
+ and autovacuum log output (Bertrand Drouvot)
+ §
+
+
-
-
-Add per-backend I/O statistics reporting (Bertrand Drouvot)
-§
-§
-
+
+
+ Add per-backend I/O statistics reporting (Bertrand Drouvot)
+ §
+ §
+
-
-The statistics are accessed via pg_stat_get_backend_io(). Per-backend I/O statistics can be cleared via pg_stat_reset_backend_stats().
-
-
+
+ The statistics are accessed via pg_stat_get_backend_io().
+ Per-backend I/O statistics can be cleared via pg_stat_reset_backend_stats().
+
+
-
-
-Add pg_stat_io columns to report I/O activity in bytes (Nazir Bilal Yavuz)
-§
-
+
+
+ Add pg_stat_io
+ columns to report I/O activity in bytes (Nazir Bilal Yavuz)
+ §
+
-
-The new columns are read_bytes, write_bytes, and extend_bytes. The op_bytes column, which always equaled BLCKSZ, has been removed.
-
-
+
+ The new columns are read_bytes,
+ write_bytes, and
+ extend_bytes. The
+ op_bytes column, which always equaled
+ BLCKSZ,
+ has been removed.
+
+
-
-
-Add WAL I/O activity rows to pg_stat_io (Nazir Bilal Yavuz, Bertrand Drouvot, Michael Paquier)
-§
-§
-§
-
+
+
+ Add WAL I/O activity rows to
+ pg_stat_io (Nazir Bilal Yavuz, Bertrand
+ Drouvot, Michael Paquier)
+ §
+ §
+ §
+
-
-This includes WAL receiver activity and a wait event for such writes.
-
+
+ This includes WAL receiver activity and a wait
+ event for such writes.
+
-
+
-
-
-Change server variable to control tracking WAL timing in pg_stat_io instead of pg_stat_wal (Bertrand Drouvot)
-§
-
-
+
+
+ Change server variable
+ to control tracking WAL timing
+ in pg_stat_io instead of pg_stat_wal
+ (Bertrand Drouvot)
+ §
+
+
-
-
-Remove read/sync columns from pg_stat_wal (Bertrand Drouvot)
-§
-§
-
+
+
+ Remove read/sync columns from pg_stat_wal
+ (Bertrand Drouvot)
+ §
+ §
+
-
-This removes columns wal_write, wal_sync, wal_write_time, and wal_sync_time.
-
-
+
+ This removes columns wal_write,
+ wal_sync,
+ wal_write_time, and
+ wal_sync_time.
+
+
-
-
-Add function pg_stat_get_backend_wal() to return per-backend WAL statistics (Bertrand Drouvot)
-§
-
+
+
+ Add function pg_stat_get_backend_wal()
+ to return per-backend WAL statistics (Bertrand
+ Drouvot)
+ §
+
-
-Per-backend WAL statistics can be cleared via pg_stat_reset_backend_stats().
-
-
+
+ Per-backend WAL
+ statistics can be cleared via pg_stat_reset_backend_stats().
+
+
-
-
-Add function pg_ls_summariesdir() to specifically list the contents of PGDATA/pg_wal/summaries (Yushi Ogiwara)
-§
-
-
+
+
+ Add function pg_ls_summariesdir()
+ to specifically list the contents of PGDATA/pg_wal/summaries
+ (Yushi Ogiwara)
+ §
+
+
-
-
-Add column pg_stat_checkpointer.num_done to report the number of completed checkpoints (Anton A. Melnikov)
-§
-
+
+
+ Add column pg_stat_checkpointer.num_done
+ to report the number of completed checkpoints (Anton A. Melnikov)
+ §
+
-
-Columns num_timed and num_requested count both completed and skipped checkpoints.
-
-
+
+ Columns num_timed and
+ num_requested count both completed and
+ skipped checkpoints.
+
+
-
-
-Add column pg_stat_checkpointer.slru_written to report SLRU buffers written (Nitin Jadhav)
-§
-
+
+
+ Add column
+ pg_stat_checkpointer.slru_written
+ to report SLRU buffers written (Nitin Jadhav)
+ §
+
-
-Also, modify the checkpoint server log message to report separate shared buffer and SLRU buffer values.
-
-
+
+ Also, modify the checkpoint server log message to report separate
+ shared buffer and SLRU buffer values.
+
+
-
-
-Add columns to pg_stat_database to report parallel workers activity (Benoit Lobréau)
-§
-
+
+
+ Add columns to pg_stat_database
+ to report parallel worker activity (Benoit Lobréau)
+ §
+
-
-The new columns are parallel_workers_to_launch and parallel_workers_launched.
-
-
+
+ The new columns are
+ parallel_workers_to_launch and
+ parallel_workers_launched.
+
+
-
-
-Have query jumbling of arrays consider only the first and last array elements (Dmitry Dolgov, Sami Imseih)
-§
-§
-
+
+
+ Have query id computation
+ of arrays consider only the first and last array elements (Dmitry
+ Dolgov, Sami Imseih)
+ §
+ §
+
-
-Jumbling is used by .
-
-
+
+ Jumbling is used by .
+
+
-
-
-Adjust query jumbling to group together queries using the same relation name (Michael Paquier, Sami Imseih)
-§
-
+
+
+ Adjust query id computations to group together queries using the
+ same relation name (Michael Paquier, Sami Imseih)
+ §
+
-
-This is true even if the tables in different schemas have different column names.
-
-
+
+ This is true even if the tables in different schemas have different
+ column names.
+
+
-
-
-Add column pg_backend_memory_contexts.type to report the type of memory context (David Rowley)
-§
-
-
+
+
+ Add column pg_backend_memory_contexts.type
+ to report the type of memory context (David Rowley)
+ §
+
+
-
-
-Add column pg_backend_memory_contexts.path to show memory context parents (Melih Mutlu)
-§
-
-
+
+
+ Add column
+ pg_backend_memory_contexts.path
+ to show memory context parents (Melih Mutlu)
+ §
+
+
@@ -1075,53 +1259,61 @@ Author: Michael Paquier
2024-07-10 [d898665bf] Extend pg_get_acl() to handle sub-object IDs
-->
-
-
-Add function pg_get_acl() to retrieve database access control details (Joel Jacobson)
-§
-§
-
-
+
+
+ Add function pg_get_acl()
+ to retrieve database access control details (Joel Jacobson)
+ §
+ §
+
+
-
-
-Add function has_largeobject_privilege() to check large object privileges (Yugo Nagata)
-§
-
-
+
+
+ Add function has_largeobject_privilege()
+ to check large object privileges (Yugo Nagata)
+ §
+
+
-
-
-Allow to define large object default privileges (Takatsuka Haruka, Yugo Nagata, Laurenz Albe)
-§
-
-
+
+
+ Allow to define
+ large object default privileges (Takatsuka Haruka, Yugo Nagata,
+ Laurenz Albe)
+ §
+
+
-
-
-Add predefined role pg_signal_autovacuum_worker (Kirill Reshke)
-§
-
+
+
+ Add predefined role pg_signal_autovacuum_worker
+ (Kirill Reshke)
+ §
+
-
-This allows sending signals to autovacuum workers.
-
-
+
+ This allows sending signals to autovacuum workers.
+
+
@@ -1137,68 +1329,69 @@ Author: Daniel Gustafsson
2025-02-20 [b3f0be788] Add support for OAUTHBEARER SASL mechanism
-->
-
-
-Add support for the OAuth authentication method (Jacob Champion, Daniel Gustafsson, Thomas Munro)
-§
-
+
+
+ Add support for the OAuth authentication
+ method (Jacob Champion, Daniel Gustafsson, Thomas Munro)
+ §
+
-
-This adds an oauth authentication method to pg_hba.conf, libpq OAuth options, a server variable to load token validation libraries, and
-a configure flag to add the required compile-time libraries.
-
-
+
+ This adds an oauth authentication method to pg_hba.conf,
+ libpq OAuth options, a server variable to load
+ token validation libraries, and a configure flag
+ to add the required compile-time libraries.
+
+
-
-
-Add server variable to allow specification of multiple colon-separated TLSv1.3 cipher suites (Erica Zhang, Daniel Gustafsson)
-§
-
-
+
+
+ Add server variable to allow
+ specification of multiple colon-separated TLSv1.3 cipher suites
+ (Erica Zhang, Daniel Gustafsson)
+ §
+
+
-
-
-Change server variable 's default to include elliptic curve X25519 (Daniel Gustafsson, Jacob Champion)
-§
-
-
+
+
+ Change server variable 's default
+ to include elliptic curve X25519 (Daniel Gustafsson, Jacob Champion)
+ §
+
+
-
-
-Rename server variable ssl_ecdh_curve to and allow multiple colon-separated ECDH curves to be specified (Erica Zhang, Daniel Gustafsson)
-§
-
-
-The previous name still works.
-
-
-
-
+
+
+ Rename server variable ssl_ecdh_curve to and allow multiple colon-separated
+ ECDH curves to be specified (Erica Zhang,
+ Daniel Gustafsson)
+ §
+
-
-
-Add function pg_check_fipsmode() to report the server's FIPS mode (Daniel Gustafsson)
-§
-
-
+
+ The previous name still works.
+
+
-
-
-Make cancel request keys 256 bits (Heikki Linnakangas, Jelte Fennema-Nio)
-§
-§
-
+
+
+ Make cancel request
+ keys 256 bits (Heikki Linnakangas, Jelte Fennema-Nio)
+ §
+ §
+
-
-This is only possible when the server and client support wire protocol version 3.2, introduced in this release.
-
-
+
+ This is only possible when the server and client support wire
+ protocol version 3.2, introduced in this release.
+
+
-
-
-Add server variable to specify the maximum number of background workers (Nathan Bossart)
-§
-
+
+
+ Add server variable
+ to specify the maximum number of background workers (Nathan Bossart)
+ §
+
-
-With this variable set, can be adjusted at runtime up to this maximum without a server restart.
-
-
+
+ With this variable set,
+ can be adjusted at runtime up to this maximum without a server
+ restart.
+
+
-
-
-Allow specification of the fixed number of dead tuples that will trigger an autovacuum (Nathan Bossart, Frédéric Yhuel)
-§
-
+
+
+ Allow specification of the fixed number of dead tuples that will
+ trigger an autovacuum (Nathan
+ Bossart, Frédéric Yhuel)
+ §
+
-
-The server variable is . Percentages are still used for triggering.
-
-
+
+ The server variable is . Percentages are
+ still used for triggering.
+
+
-
-
-Change server variable to limit only files opened by a backend (Andres Freund)
-§
-
+
+
+ Change server variable
+ to limit only files opened by a backend (Andres Freund)
+ §
+
-
-Previously files opened by the postmaster were also counted toward this limit.
-
-
+
+ Previously files opened by the postmaster were also counted toward
+ this limit.
+
+
-
-
-Add server variable to report the required number of semaphores (Nathan Bossart)
-§
-
+
+
+ Add server variable to
+ report the required number of semaphores (Nathan Bossart)
+ §
+
-
-This is useful for operating system configuration.
-
-
+
+ This is useful for operating system configuration.
+
+
-
-
-Add server variable to specify the location of extension control files (Peter Eisentraut, Matheus Alcantara)
-§
-§
-
-
+
+
+ Add server variable to
+ specify the location of extension control files (Peter Eisentraut,
+ Matheus Alcantara)
+ §
+ §
+
+
-
+
@@ -1312,28 +1519,34 @@ Author: Amit Kapila
2025-02-19 [ac0e33136] Invalidate inactive replication slots.
-->
-
-
-Allow inactive replication slots to be automatically invalided using server variable (Nisha Moond, Bharath Rupireddy)
-§
-
-
+
+
+ Allow inactive replication slots to be automatically invalided using
+ server variable
+ (Nisha Moond, Bharath Rupireddy)
+ §
+
+
-
-
-Add server variable to control the maximum active replication origins (Euler Taveira)
-§
-
+
+
+ Add server variable to control the
+ maximum active replication origins (Euler Taveira)
+ §
+
-
-This was previously controlled by , but this new setting allows a higher origin count in cases where fewer slots are required.
-
-
+
+ This was previously controlled by , but this new setting allows
+ a higher origin count in cases where fewer slots are required.
+
+
@@ -1355,33 +1568,44 @@ Author: Amit Kapila
2025-01-30 [6252b1eaf] Doc: Generated column replication.
-->
-
-
-Allow the values of generated columns to be logically replicated (Shubham Khanna, Vignesh C, Zhijie Hou, Shlok Kyal, Peter Smith)
-§
-§
-§
-§
-
-
-
-If the publication specifies a column list, all specified columns, generated and non-generated, are published. Without a specified column list, publication option publish_generated_columns
-controls whether generated columns are published. Previously generated columns were not replicated and the subscriber had to compute the values if possible; this is particularly
-useful for non-PostgreSQL subscribers which lack such a capability.
-
-
+
+
+ Allow the values of generated
+ columns to be logically replicated (Shubham Khanna, Vignesh C,
+ Zhijie Hou, Shlok Kyal, Peter Smith)
+ §
+ §
+ §
+ §
+
+
+
+ If the publication specifies a column list, all specified
+ columns, generated and non-generated, are published.
+ Without a specified column list, publication option
+ publish_generated_columns controls whether
+ generated columns are published. Previously generated columns
+ were not replicated and the subscriber had to compute
+ the values if possible; this is particularly useful for
+ non-PostgreSQL subscribers which lack
+ such a capability.
+
+
-
-
-Change the default streaming option from off to parallel (Vignesh C)
-§
-
-
+
+
+ Change the default streaming
+ option from off to parallel
+ (Vignesh C)
+ §
+
+
-
-
-Allow ALTER SUBSCRIPTION to change the replication slot's two-phase commit behavior (Hayato Kuroda, Ajin Cherian, Amit Kapila, Zhijie Hou)
-§
-§
-
-
+
+
+ Allow to change the
+ replication slot's two-phase commit behavior (Hayato Kuroda, Ajin
+ Cherian, Amit Kapila, Zhijie Hou)
+ §
+ §
+
+
-
-
-Log conflicts while applying logical replication changes (Zhijie Hou, Nisha Moond)
-§
-§
-§
-§
-§
-
+
+
+ Log conflicts while
+ applying logical replication changes (Zhijie Hou, Nisha Moond)
+ §
+ §
+ §
+ §
+ §
+
-
-Also report in new columns of pg_stat_subscription_stats.
-
-
+
+ Also report in new columns of pg_stat_subscription_stats.
+
+
@@ -1446,112 +1674,136 @@ Author: Richard Guo
2025-02-25 [1e4351af3] Expand virtual generated columns in the planner
-->
-
-
-Allow generated columns to be virtual, and make them the default (Peter Eisentraut, Jian He, Richard Guo, Dean Rasheed)
-§
-§
-§
-
+
+
+ Allow generated
+ columns to be virtual, and make them the default (Peter
+ Eisentraut, Jian He, Richard Guo, Dean Rasheed)
+ §
+ §
+ §
+
-
-Virtual generated columns generate their values when the columns are read, not written. The write behavior can still be specified via the STORED option.
-
-
+
+ Virtual generated columns generate their values when the columns
+ are read, not written. The write behavior can still be specified
+ via the STORED option.
+
+
-
-
-Add OLD/NEW support to RETURNING in DML queries (Dean Rasheed)
-§
-
+
+
+ Add OLD/NEW support to RETURNING in
+ DML queries (Dean Rasheed)
+ §
+
-
-Previously RETURNING only returned new values for and , and old values for ; would return the appropriate value for the internal query executed. This new syntax
-allows the RETURNING list of INSERT/UPDATE/DELETE/MERGE to explicitly return old and new values by using the special aliases old and new. These aliases can be renamed to
-avoid identifier conflicts.
-
-
+
+ Previously RETURNING only returned new values for
+ and , and old
+ values for ;
+ would return the appropriate value for the internal query executed.
+ This new syntax allows the RETURNING list of
+ INSERT/UPDATE/DELETE/MERGE
+ to explicitly return old and new values by using the special aliases
+ old and new. These aliases
+ can be renamed to avoid identifier conflicts.
+
+
-
-
-Allow foreign tables to be created like existing local tables (Zhang Mingli)
-§
-
+
+
+ Allow foreign tables to be created like existing local tables
+ (Zhang Mingli)
+ §
+
-
-The syntax is CREATE FOREIGN TABLE ... LIKE.
-
-
+
+ The syntax is CREATE
+ FOREIGN TABLE ... LIKE.
+
+
-
-
-Allow LIKE with nondeterministic collations (Peter Eisentraut)
-§
-
-
+
+
+ Allow LIKE
+ with nondeterministic
+ collations (Peter Eisentraut)
+ §
+
+
-
-
-Allow text position search functions with nondeterministic collations (Peter Eisentraut)
-§
-
+
+
+ Allow text position search functions with nondeterministic collations
+ (Peter Eisentraut)
+ §
+
-
-These used to generate an error.
-
-
+
+ These used to generate an error.
+
+
-
-
-Add builtin collation provider PG_UNICODE_FAST (Jeff Davis)
-§
-
+
+
+ Add builtin collation provider PG_UNICODE_FAST
+ (Jeff Davis)
+ §
+
-
-This locale supports case mapping, but sorts in code point order, not natural language order.
-
-
+
+ This locale supports case mapping, but sorts in code point order,
+ not natural language order.
+
+
-
-
-Allow and to process partitioned tables without processing their children (Michael Harris)
-§
-
+
+
+ Allow and
+ to process partitioned tables without processing their children
+ (Michael Harris)
+ §
+
-
-This is enabled with the new ONLY option. This is useful since autovacuum does not process partitioned tables, just its children.
-
-
+
+ This is enabled with the new ONLY option. This is
+ useful since autovacuum does not process partitioned tables, just
+ its children.
+
+
-
-
-Add functions to modify per-relation and per-column optimizer statistics (Corey Huinker)
-§
-§
-§
-
+
+
+ Add functions to modify per-relation and per-column optimizer
+ statistics (Corey Huinker)
+ §
+ §
+ §
+
-
-The functions are pg_restore_relation_stats(), pg_restore_attribute_stats(), pg_clear_relation_stats(), and pg_clear_attribute_stats().
-
-
+
+ The functions are pg_restore_relation_stats(),
+ pg_restore_attribute_stats(),
+ pg_clear_relation_stats(), and
+ pg_clear_attribute_stats().
+
+
-
-
-Add server variable to control the file copying method (Nazir Bilal Yavuz)
-§
-
+
+
+ Add server variable to control
+ the file copying method (Nazir Bilal Yavuz)
+ §
+
-
-This controls whether CREATE DATABASE ... STRATEGY=FILE_COPY and ALTER DATABASE ... SET TABLESPACE uses file copy or clone.
-
-
+
+ This controls whether CREATE DATABASE
+ ... STRATEGY=FILE_COPY and ALTER DATABASE ... SET
+ TABLESPACE uses file copy or clone.
+
+ <link linkend="ddl-constraints">Constraints</link>
-
+
-
-
-Allow the specification of non-overlapping PRIMARY KEY and UNIQUE constraints (Paul A. Jungwirth)
-§
-
+
+
+ Allow the specification of non-overlapping PRIMARY
+ KEY and UNIQUE
+ constraints (Paul A. Jungwirth)
+ §
+
-
-This is specified by WITHOUT OVERLAPS on the last column.
-
-
+
+ This is specified by WITHOUT OVERLAPS on the
+ last specified column.
+
+
-
-
-Allow CHECK and foreign key constraints to be specified as NOT ENFORCED (Amul Sul)
-§
-§
-
+
+
+ Allow CHECK
+ and foreign
+ key constraints to be specified as NOT
+ ENFORCED (Amul Sul)
+ §
+ §
+
-
-This also adds column pg_constraint.conenforced.
-
+
+ This also adds column pg_constraint.conenforced.
+
+
-
-
-Require primary/foreign key relationships to use either deterministic collations or the the same nondeterministic collations (Peter Eisentraut)
-§
-
+
+
+ Require primary/foreign key
+ relationships to use either deterministic collations or the the
+ same nondeterministic collations (Peter Eisentraut)
+ §
+
-
-The restore of a , also used by , will fail if these requirements are not met; schema changes must be made for these upgrade methods to succeed.
-
-
+
+ The restore of a , also used by , will fail if these requirements are not met;
+ schema changes must be made for these upgrade methods to succeed.
+
+
-
-
-Store column NOT NULL specifications in pg_constraint (Álvaro Herrera, Bernd Helmle)
-§
-
+
+
+ Store column NOT
+ NULL specifications in pg_constraint
+ (Álvaro Herrera, Bernd Helmle)
+ §
+
-
-This allows names to be specified for NOT NULL constraint. This also adds NOT NULL constraints to foreign tables and NOT NULL inheritance control to local tables.
-
-
+
+ This allows names to be specified for NOT NULL
+ constraint. This also adds NOT NULL constraints
+ to foreign tables and NOT NULL inheritance
+ control to local tables.
+
+
-
-
-Allow to set the NOT VALID attribute of NOT NULL constraints (Rushabh Lathia, Jian He)
-§
-
-
+
+
+ Allow to set the NOT
+ VALID attribute of NOT NULL constraints
+ (Rushabh Lathia, Jian He)
+ §
+
+
-
-
-Allow modification of the inheritability of NOT NULL constraints (Suraj Kharage, Álvaro Herrera)
-§
-§
-
+
+
+ Allow modification of the inheritability of NOT
+ NULL constraints (Suraj Kharage, Álvaro Herrera)
+ §
+ §
+
-
-The syntax is ALTER TABLE ... ALTER CONSTRAINT ... [NO] INHERIT.
-
-
+
+ The syntax is ALTER TABLE
+ ... ALTER CONSTRAINT ... [NO] INHERIT.
+
+
-
-
-Allow NOT VALID foreign key constraints on partitioned tables (Amul Sul)
-§
-
-
+
+
+ Allow NOT VALID foreign key constraints on
+ partitioned tables (Amul Sul)
+ §
+
+
-
-
-Allow dropping of constraints ONLY on partitioned tables (Álvaro Herrera)
-§
-
+
+
+ Allow dropping
+ of constraints ONLY on partitioned tables
+ (Álvaro Herrera)
+ §
+
-
-This was previously erroneously prohibited.
-
-
+
+ This was previously erroneously prohibited.
+
+
-
+ <xref linkend="sql-copy"/>
-
+
-
-
-Add REJECT_LIMIT to control the number of invalid rows COPY FROM can ignore (Atsushi Torikoshi)
-§
-
+
+
+ Add REJECT_LIMIT to control the number of invalid
+ rows COPY FROM can ignore (Atsushi Torikoshi)
+ §
+
-
-This is available when ON_ERROR = 'ignore'.
-
-
+
+ This is available when ON_ERROR = 'ignore'.
+
+
-
-
-Allow COPY TO to copy rows from populated materialized views (Jian He)
-§
-
-
+
+
+ Allow COPY TO to copy rows from populated
+ materialized views (Jian He)
+ §
+
+
-
-
-Add COPYLOG_VERBOSITY level silent to suppress log output of ignored rows (Atsushi Torikoshi)
-§
-
+
+
+ Add COPYLOG_VERBOSITY level
+ silent to suppress log output of ignored rows
+ (Atsushi Torikoshi)
+ §
+
-
-This new level suppresses output for discarded input rows when on_error = 'ignore'.
-
-
+
+ This new level suppresses output for discarded input rows when
+ on_error = 'ignore'.
+
+
-
-
-Disallow COPY FREEZE on foreign tables (Nathan Bossart)
-§
-
+
+
+ Disallow COPY FREEZE on foreign tables (Nathan
+ Bossart)
+ §
+
-
-Previously, the COPY worked but the FREEZE was ignored, so disallow this command.
-
-
+
+ Previously, the COPY worked but the
+ FREEZE was ignored, so disallow this command.
+
+
@@ -1805,36 +2105,39 @@ Author: David Rowley
2024-12-11 [c2a4078eb] Enable BUFFERS with EXPLAIN ANALYZE by default
-->
-
-
-Automatically include BUFFERS output in EXPLAIN ANALYZE (Guillaume Lelarge, David Rowley)
-§
-
-
+
+
+ Automatically include BUFFERS output in
+ EXPLAIN ANALYZE (Guillaume Lelarge, David Rowley)
+ §
+
+
-
-
-Add full WAL buffer count to EXPLAIN (WAL) output (Bertrand Drouvot)
-§
-
-
+
+
+ Add full WAL buffer count to EXPLAIN
+ (WAL) output (Bertrand Drouvot)
+ §
+
+
-
-
-In EXPLAIN ANALYZE, report the number of index lookups used per index scan node (Peter Geoghegan)
-§
-
-
+
+
+ In EXPLAIN ANALYZE, report the number of index
+ lookups used per index scan node (Peter Geoghegan)
+ §
+
+
-
-
-Modify EXPLAIN to output fractional row counts (Ibrar Ahmed, Ilia Evdokimov, Robert Haas)
-§
-§
-
-
+
+
+ Modify EXPLAIN to output fractional row counts
+ (Ibrar Ahmed, Ilia Evdokimov, Robert Haas)
+ §
+ §
+
+
-
-
-Add memory and disk usage details to Material, Window Aggregate, and common table expression nodes to EXPLAIN
-output (David Rowley, Tatsuo Ishii)
-§
-§
-§
-§
-
-
+
+
+ Add memory and disk usage details to Material,
+ Window Aggregate, and common table expression
+ nodes to EXPLAIN output (David Rowley, Tatsuo
+ Ishii)
+ §
+ §
+ §
+ §
+
+
-
-
-Add details about window function arguments to EXPLAIN output (Tom Lane)
-§
-
-
+
+
+ Add details about window function arguments to
+ EXPLAIN output (Tom Lane)
+ §
+
+
-
-
-Add Parallel Bitmap Heap Scan worker cache statistics to EXPLAIN ANALYZE (David Geier, Heikki Linnakangas, Donghang Lin, Alena Rybakina, David Rowley)
-§
-
-
+
+
+ Add Parallel Bitmap Heap Scan worker cache
+ statistics to EXPLAIN ANALYZE (David Geier,
+ Heikki Linnakangas, Donghang Lin, Alena Rybakina, David Rowley)
+ §
+
+
-
-
-Indicate disabled nodes in EXPLAIN ANALYZE output (Robert Haas, David Rowley, Laurenz Albe)
-§
-§
-§
-
-
+
+
+ Indicate disabled nodes in EXPLAIN ANALYZE output
+ (Robert Haas, David Rowley, Laurenz Albe)
+ §
+ §
+ §
+
+
@@ -1934,137 +2244,159 @@ Author: Jeff Davis
2025-01-17 [286a365b9] Support Unicode full case mapping and conversion.
-->
-
-
-Improve Unicode full case mapping and conversion (Jeff Davis)
-§
-§
-
+
+
+ Improve Unicode
+ full case mapping and conversion (Jeff Davis)
+ §
+ §
+
-
-This adds the ability to do conditional and title case mapping, and case map single characters to multiple characters.
-
-
+
+ This adds the ability to do conditional and title case mapping,
+ and case map single characters to multiple characters.
+
+
-
-
-Allow jsonbnull values to be cast to scalar types as NULL (Tom Lane)
-§
-
+
+
+ Allow jsonb
+ null values to be cast to scalar types as
+ NULL (Tom Lane)
+ §
+
-
-Previously such casts generated an error.
-
-
+
+ Previously such casts generated an error.
+
+
-
-
-Add optional parameter to json{b}_strip_nulls to allow removal of null array elements (Florents Tselai)
-§
-
-
+
+
+ Add optional parameter to json{b}_strip_nulls
+ to allow removal of null array elements (Florents Tselai)
+ §
+
+
-
-
-Add function array_sort() which sorts an array's first dimension (Junwang Zhao, Jian He)
-§
-
-
+
+
+ Add function array_sort()
+ which sorts an array's first dimension (Junwang Zhao, Jian He)
+ §
+
+
-
-
-Add function array_reverse() which reverses an array's first dimension (Aleksander Alekseev)
-§
-
-
+
+
+ Add function array_reverse()
+ which reverses an array's first dimension (Aleksander Alekseev)
+ §
+
+
-
-
-Add function reverse() to reverse bytea bytes (Aleksander Alekseev)
-§
-
-
+
+
+ Add function reverse()
+ to reverse bytea bytes (Aleksander Alekseev)
+ §
+
+
-
-
-Allow casting between integer types and bytea (Aleksander Alekseev)
-§
-
+
+
+ Allow casting between integer types and bytea (Aleksander
+ Alekseev)
+ §
+
-
-The integer values are stored as bytea two's complement values.
-
-
+
+ The integer values are stored as bytea two's complement
+ values.
+
+
-
-
-Update Unicode data to Unicode 16.0.0 (Peter Eisentraut)
-§
-
-
+
+
+ Update Unicode data to Unicode 16.0.0 (Peter
+ Eisentraut)
+ §
+
+
-
-
-Add full text search stemming for Estonian (Tom Lane)
-§
-
-
+
+
+ Add full text search stemming for Estonian
+ (Tom Lane)
+ §
+
+
-
-
-Improve the XML error codes to more closely match the SQL standard (Tom Lane)
-§
-
+
+
+ Improve the XML
+ error codes to more closely match the SQL standard
+ (Tom Lane)
+ §
+
-
-These errors are reported via SQLSTATE.
-
-
+
+ These errors are reported via SQLSTATE.
+
+
@@ -2080,16 +2412,20 @@ Author: Jeff Davis
2025-01-24 [bfc599206] Add SQL function CASEFOLD().
-->
-
-
-Add function CASEFOLD() to allow for more sophisticated case-insensitive matching (Jeff Davis)
-§
-
+
+
+ Add function casefold()
+ to allow for more sophisticated case-insensitive matching (Jeff Davis)
+ §
+
-
-This allows more accurate comparisons, i.e., a character can have multiple upper or lower case equivalents, or upper or lower case conversion changes the number of characters.
-
-
+
+ This allows more accurate comparisons, i.e., a character can have
+ multiple upper or lower case equivalents, or upper or lower case
+ conversion changes the number of characters.
+
+
-
-
-Allow MIN()/MAX() aggregates on arrays and composite types (Aleksander Alekseev, Marat Buharov)
-§
-§
-
-
+
+
+ Allow MIN()/MAX()
+ aggregates on arrays and composite types (Aleksander Alekseev,
+ Marat Buharov)
+ §
+ §
+
+
-
-
-Add a WEEK option to EXTRACT() (Tom Lane)
-§
-
-
+
+
+ Add a WEEK option to EXTRACT()
+ (Tom Lane)
+ §
+
+
-
-
-Improve the output EXTRACT(QUARTER ...) for negative values (Tom Lane)
-§
-
-
+
+
+ Improve the output EXTRACT(QUARTER ...) for
+ negative values (Tom Lane)
+ §
+
+
-
-
-Add roman numeral support to to_number() (Hunaid Sohail)
-§
-
+
+
+ Add roman numeral support to to_number()
+ (Hunaid Sohail)
+ §
+
-
-This is accessed via the RN pattern.
-
-
+
+ This is accessed via the RN pattern.
+
+
-
-
-Add UUID version 7 generation function uuidv7() (Andrey Borodin)
-§
-
+
+
+ Add UUID
+ version 7 generation function uuidv7()
+ (Andrey Borodin)
+ §
+
-
-This UUID value is temporally sortable. Function alias uuidv4() has been added to explicitly generate version 4 UUIDs.
-
-
+
+ This UUID value is
+ temporally sortable. Function alias uuidv4()
+ has been added to explicitly generate version 4 UUIDs.
+
+
-
-
-Add functions crc32() and crc32c() to compute CRC values (Aleksander Alekseev)
-§
-
-
+
+
+ Add functions crc32()
+ and crc32c()
+ to compute CRC values (Aleksander Alekseev)
+ §
+
+
-
-
-Add math functions gamma() and lgamma() (Dean Rasheed)
-§
-
-
+
+
+ Add math functions gamma()
+ and lgamma()
+ (Dean Rasheed)
+ §
+
+
-
-
-Allow => syntax for named cursor arguments in plpgsql (Pavel Stehule)
-§
-
+
+
+ Allow => syntax for named cursor arguments in
+ PL/pgSQL (Pavel Stehule)
+ §
+
-
-We previously only accepted :=.
-
-
+
+ We previously only accepted :=.
+
+
-
-
-Allow regexp_match[es]()/regexp_like()/regexp_replace()/regexp_count()/regexp_instr()/regexp_substr()/regexp_split_to_table()/regexp_split_to_array() to use named arguments (Jian He)
-§
-
-
+
+
+ Allow regexp_match[es]()/regexp_like()/regexp_replace()/regexp_count()/regexp_instr()/regexp_substr()/regexp_split_to_table()/regexp_split_to_array()
+ to use named arguments (Jian He)
+ §
+
+
@@ -2228,12 +2597,15 @@ Author: Robert Haas
2024-09-09 [cdb6b0fdb] Add PQfullProtocolVersion() to surface the precise proto
-->
-
-
-Add function PQfullProtocolVersion() to report the full, including minor, protocol version number (Jacob Champion, Jelte Fennema-Nio)
-§
-
-
+
+
+ Add function PQfullProtocolVersion()
+ to report the full, including minor, protocol version number (Jacob
+ Champion, Jelte Fennema-Nio)
+ §
+
+
-
-
-Add libpq connection parameters and environment variables to specify the minimum and maximum acceptable protocol version for connections (Jelte Fennema-Nio)
-§
-§
-
-
+
+
+ Add libpq connection parameters
+ and environment variables to
+ specify the minimum and maximum acceptable protocol version for
+ connections (Jelte Fennema-Nio)
+ §
+ §
+
+
-
-
-Add libpq function PQservice() to return the connection service name (Michael Banck)
-§
-
-
+
+
+ Add libpq function PQservice()
+ to return the connection service name (Michael Banck)
+ §
+
+
-
-
-Report changes to the client (Alexander Kukushkin, Jelte Fennema-Nio, Tomas Vondra)
-§
-§
-
-
+
+
+ Report changes to the client
+ (Alexander Kukushkin, Jelte Fennema-Nio, Tomas Vondra)
+ §
+ §
+
+
-
-
-Add PQtrace() output for all message types, including authentication (Jelte Fennema-Nio)
-§
-§
-§
-§
-§
-
-
+
+
+ Add PQtrace() output
+ for all message types, including authentication (Jelte Fennema-Nio)
+ §
+ §
+ §
+ §
+ §
+
+
-
-
-Add libpq connection parameter sslkeylogfile which dumps out SSL key material (Abhishek Chanda, Daniel Gustafsson)
-§
-
+
+
+ Add libpq connection parameter sslkeylogfile
+ which dumps out SSL key material (Abhishek Chanda,
+ Daniel Gustafsson)
+ §
+
-
-This is useful for debugging.
-
-
+
+ This is useful for debugging.
+
+
-
-
-Modify some libpq function signatures to use int64_t (Thomas Munro)
-§
-
+
+
+ Modify some libpq function signatures to use
+ int64_t (Thomas Munro)
+ §
+
-
-These previously used pg_int64, which is now deprecated.
-
-
+
+ These previously used pg_int64, which is now
+ deprecated.
+
+
- <xref linkend="app-psql"/>
+ <xref linkend="app-psql"/>
-
+
-
-
-Allow psql to parse, bind, and close named prepared statements (Anthonin Bonnefoy, Michael Paquier)
-§
-
+
+
+ Allow psql to parse, bind, and close
+ named prepared statements (Anthonin Bonnefoy, Michael Paquier)
+ §
+
-
-This is accomplished with new commands \parse, \bind_named, and \close.
-
-
+
+ This is accomplished with new commands \parse,
+ \bind_named,
+ and \close.
+
+
-
-
-Add psql backslash commands to allowing issuance of pipeline queries (Anthonin Bonnefoy)
-§
-§
-§
-
+
+
+ Add psql backslash commands to allowing
+ issuance of pipeline queries (Anthonin Bonnefoy)
+ §
+ §
+ §
+
-
-The new commands are \startpipeline, \syncpipeline, \sendpipeline, \endpipeline, \flushrequest, \flush, and \getresults.
-
-
+
+ The new commands are \startpipeline,
+ \syncpipeline, \sendpipeline,
+ \endpipeline, \flushrequest,
+ \flush, and \getresults.
+
+
-
-
-Allow adding pipeline status to the psql prompt and add related state variables (Anthonin Bonnefoy)
-§
-
+
+
+ Allow adding pipeline status to the psql
+ prompt and add related state variables (Anthonin Bonnefoy)
+ §
+
-
-The new prompt character is %P and the new psql variables are PIPELINE_SYNC_COUNT, PIPELINE_COMMAND_COUNT, and PIPELINE_RESULT_COUNT.
-
-
+
+ The new prompt character is %P and
+ the new psql variables are PIPELINE_SYNC_COUNT,
+ PIPELINE_COMMAND_COUNT,
+ and PIPELINE_RESULT_COUNT.
+
+
-
-
-Allow adding the connection service name to the psql prompt or access it via psql variable (Michael Banck)
-§
-
-
+
+
+ Allow adding the connection service name to the
+ psql prompt or access it via
+ psql variable (Michael Banck)
+ §
+
+
-
-
-Add psql option to use expanded mode on all list commands (Dean Rasheed)
-§
-
+
+
+ Add psql option to use expanded mode on
+ all list commands (Dean Rasheed)
+ §
+
-
-Adding backslash suffix x enables this.
-
-
+
+ Adding backslash suffix x enables this.
+
+
-
-
-Change psql's \conninfo to use tabular format and include more information (Álvaro Herrera, Maiquel Grassi, Hunaid Sohail)
-§
-
-
+
+
+ Change psql's to use tabular format
+ and include more information (Álvaro Herrera, Maiquel Grassi,
+ Hunaid Sohail)
+ §
+
+
-
-
-Add function's leakproof indicator to psql's \df+, \do+, \dAo+, and \dC+ outputs (Yugo Nagata)
-§
-
-
+
+
+ Add function's leakproof indicator
+ to psql's \df+,
+ \do+, \dAo+, and
+ \dC+ outputs (Yugo Nagata)
+ §
+
+
-
-
-Add access method details for partitioned relations in \dP+ (Justin Pryzby)
-§
-
-
+
+
+ Add access method details for partitioned relations in \dP+
+ (Justin Pryzby)
+ §
+
+
-
-
-Add default_version to the psql\dx extension output (Magnus Hagander)
-§
-
-
+
+
+ Add default_version
+ to the psql\dx
+ extension output (Magnus Hagander)
+ §
+
+
-
-
-Add psql variable WATCH_INTERVAL to set the default \watch wait time (Daniel Gustafsson)
-§
-
-
+
+
+ Add psql variable to set the default \watch
+ wait time (Daniel Gustafsson)
+ §
+
+
-
+
-
+
-
- Server Applications
+
+ Server Applications
-
+
-
-
-Change to default to enabling checksums (Greg Sabino Mullane)
-§
-§
-
+
+
+ Change to default to enabling checksums
+ (Greg Sabino Mullane)
+ §
+ §
+
-
-The new initdb option disables checksums.
-
-
+
+ The new initdb option
+ disables checksums.
+
+
-
-
-Add initdb option to avoid syncing heap/index files (Nathan Bossart)
-§
-
+
+
+ Add initdb option
+ to avoid syncing heap/index
+ files (Nathan Bossart)
+ §
+
-
-initdb option is still available to avoid syncing any files.
-
-
+
+ initdb option
+ is still available to avoid syncing any files.
+
+
-
-
-Add vacuumdb option to compute only missing optimizer statistics (Corey Huinker, Nathan Bossart)
-§
-§
-
+
+
+ Add option
+ to compute only missing
+ optimizer statistics (Corey Huinker, Nathan Bossart)
+ §
+ §
+
-
-This option can only be used by and .
-
-
+
+ This option can only be used by
+ and .
+
+
-
-
-Add option / to enable hard linking (Israel Barth Rubio, Robert Haas)
-§
-
+
+
+ Add option
+ / to enable hard linking
+ (Israel Barth Rubio, Robert Haas)
+ §
+
-
-Only some files can be hard linked. This should not be used if the backups will be used independently.
-
-
+
+ Only some files can be hard linked. This should not be used if the
+ backups will be used independently.
+
+
-
-
-Allow pg_verifybackup to verify tar-format backups (Amul Sul)
-§
-
-
+
+
+ Allow to verify tar-format
+ backups (Amul Sul)
+ §
+
+
-
-
-If 's specifies a database name, use it in output (Masahiko Sawada)
-§
-
-
+
+
+ If 's
+ specifies a database name, use it in
+ output (Masahiko Sawada)
+ §
+
+
-
-
-Add pg_resetwal option to change the default char signedness (Masahiko Sawada)
-§
-
-
+
+
+ Add option
+ to change the default
+ char signedness (Masahiko Sawada)
+ §
+
+
-
+
@@ -2615,28 +3053,34 @@ Author: Andrew Dunstan
2025-04-04 [1495eff7b] Non text modes for pg_dumpall, correspondingly change pg
-->
-
-
-Allow to dump in the same output formats as pg_dump supports (Mahendra Singh Thalor, Andrew Dunstan)
-§
-
+
+
+ Allow to dump in the same output
+ formats as pg_dump supports (Mahendra
+ Singh Thalor, Andrew Dunstan)
+ §
+
-
-Also modify to handle such dumps. Previously pg_dumpall only supported text format.
-
-
+
+ Also modify to handle such dumps.
+ Previously pg_dumpall only supported
+ text format.
+
+
-
-
-Add options , , and (Jeff Davis)
-§
-
-
+
+
+ Add options
+ , ,
+ and (Jeff Davis)
+ §
+
+
-
-
-Add pg_dump and option to dump sequence data that would normally be excluded (Nathan Bossart)
-§
-§
-
-
+
+
+ Add pg_dump and option to
+ dump sequence data that would normally be excluded (Nathan Bossart)
+ §
+ §
+
+
-
-
-Add , , and
- options , , , and (Corey Huinker, Jeff Davis)
-§
-
-
+
+
+ Add , ,
+ and options
+ , ,
+ , and
+ (Corey Huinker, Jeff Davis)
+ §
+
+
-
-
-Add option to disable row level security policy processing in
-, ,
- (Nikolay Samokhvalov)
-§
-
+
+
+ Add option to disable row level
+ security policy processing in ,
+ ,
+ (Nikolay Samokhvalov)
+ §
+
-
-This is useful for migrating to systems with different policies.
-
-
+
+ This is useful for migrating to systems with different policies.
+
+
@@ -2704,19 +3154,22 @@ Author: Jeff Davis
2025-02-20 [1fd1bd871] Transfer statistics during pg_upgrade.
-->
-
-
-Allow pg_upgrade to preserve optimizer statistics (Corey Huinker, Jeff Davis, Nathan Bossart)
-§
-§
-§
-§
-
+
+
+ Allow pg_upgrade to preserve optimizer
+ statistics (Corey Huinker, Jeff Davis, Nathan Bossart)
+ §
+ §
+ §
+ §
+
-
-Extended statistics are not preserved. Also add pg_upgrade option to disable statistics preservation.
-
-
+
+ Extended statistics are not preserved. Also add
+ pg_upgrade option
+ to disable statistics preservation.
+
+
-
-
-Allow pg_upgrade to process database checks in parallel (Nathan Bossart)
-§
-§
-§
-§
-§
-§
-§
-§
-§
-§
-§
-
-
-
-This is controlled by the existing option.
-
-
+
+
+ Allow pg_upgrade to process database
+ checks in parallel (Nathan Bossart)
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+ §
+
+
+
+ This is controlled by the existing option.
+
+
-
-
-Add pg_upgrade option to swap directories rather than copy, clone, or link files (Nathan Bossart)
-§
-
+
+
+ Add pg_upgrade option
+ to swap directories rather than copy, clone,
+ or link files (Nathan Bossart)
+ §
+
-
-This mode is potentially the fastest.
-
-
+
+ This mode is potentially the fastest.
+
+
-
-
-Add pg_upgrade option to set the default char signedness of new cluster (Masahiko Sawada)
-§
-§
-
+
+
+ Add pg_upgrade option
+ to set the default
+ char signedness of new cluster (Masahiko Sawada)
+ §
+ §
+
-
-This is to handle cases where a pre-PostgreSQL 18 cluster's default CPU signedness does not match the new cluster.
-
-
+
+ This is to handle cases where a
+ pre-PostgreSQL 18 cluster's default
+ CPU signedness does not match the new cluster.
+
+
@@ -2813,60 +3273,68 @@ Author: Amit Kapila
2025-03-28 [fb2ea12f4] pg_createsubscriber: Add '- -all' option.
-->
-
-
-Add option to create logical replicas for all databases (Shubham Khanna)
-§
-
-
+
+
+ Add option
+ to create logical replicas for all databases
+ (Shubham Khanna)
+ §
+
+
-
-
-Add pg_createsubscriber option to remove publications (Shubham Khanna)
-§
-
-
+
+
+ Add pg_createsubscriber option
+ to remove publications (Shubham Khanna)
+ §
+
+
-
-
-Add pg_createsubscriber option to enable prepared transactions (Shubham Khanna)
-§
-
-
+
+
+ Add pg_createsubscriber option
+ to enable prepared transactions
+ (Shubham Khanna)
+ §
+
+
-
-
-Add option to specify failover slots (Hayato Kuroda)
-§
-
-
+
+
+ Add option
+ to specify failover slots (Hayato Kuroda)
+ §
+
+
-
-
-Allow pg_recvlogical to work without (Hayato Kuroda)
-§
-
-
+
+
+ Allow pg_recvlogical
+ to work without
+ (Hayato Kuroda)
+ §
+
+
@@ -2886,65 +3354,76 @@ Author: Michael Paquier
2024-07-18 [a0a5869a8] Add INJECTION_POINT_CACHED() to run injection points dir
-->
-
-
-Separate the loading and running of injection points (Michael Paquier, Heikki Linnakangas)
-§
-§
-
+
+
+ Separate the loading and running of injection points
+ (Michael Paquier, Heikki Linnakangas)
+ §
+ §
+
-
-Injection points can now be created, but not run, via INJECTION_POINT_LOAD(), and such injection points can be run via INJECTION_POINT_CACHED().
-
-
+
+ Injection points can now be created, but not run, via INJECTION_POINT_LOAD(),
+ and such injection points can be run via INJECTION_POINT_CACHED().
+
+
-
-
-Support runtime arguments in injection points (Michael Paquier)
-§
-
-
+
+
+ Support runtime arguments in injection points (Michael Paquier)
+ §
+
+
-
-
-Allow inline injection point test code with IS_INJECTION_POINT_ATTACHED() (Heikki Linnakangas)
-§
-
-
+
+
+ Allow inline injection point test code with IS_INJECTION_POINT_ATTACHED()
+ (Heikki Linnakangas)
+ §
+
+
-
-
-Improve the performance of processing long JSON strings using SIMD instructions (David Rowley)
-§
-
-
+
+
+ Improve the performance of processing long JSON strings using
+ SIMD (Single Instruction Multiple Data) (David
+ Rowley)
+ §
+
+
-
-
-Speed up CRC32C calculations using x86 AVX-512 instructions (Raghuveer Devulapalli, Paul Amonson)
-§
-
-
+
+
+ Speed up CRC32C calculations using x86 AVX-512
+ instructions (Raghuveer Devulapalli, Paul Amonson)
+ §
+
+
-
-
-Add ARM Neon and SVE CPU intrinsics for popcount (integer bit counting) (Chiranmoy Bhattacharya, Devanga Susmitha, Rama Malladi)
-§
-§
-
-
+
+
+ Add ARM Neon and SVE CPU
+ intrinsics for popcount (integer bit counting) (Chiranmoy
+ Bhattacharya, Devanga Susmitha, Rama Malladi)
+ §
+ §
+
+
-
-
-Improve the speed of numeric multiplication and division (Joel Jacobson, Dean Rasheed)
-§
-§
-§
-§
-
-
+
+
+ Improve the speed of numeric multiplication and division (Joel
+ Jacobson, Dean Rasheed)
+ §
+ §
+ §
+ §
+
+
-
-
-Add configure option to enable NUMA awareness (Jakub Wartak, Bertrand Drouvot)
-§
-§
-§
-
+
+
+ Add configure option
+ to enable NUMA awareness (Jakub Wartak, Bertrand
+ Drouvot)
+ §
+ §
+ §
+
-
-The function pg_numa_available() reports on NUMA awareness, and system views pg_shmem_allocations_numa and pg_buffercache_numa which report on shared memory distribution across
-NUMA nodes.
-
-
+
+ The function pg_numa_available()
+ reports on NUMA awareness, and system views pg_shmem_allocations_numa
+ and pg_buffercache_numa
+ which report on shared memory distribution across
+ NUMA nodes.
+
+
-
-
-Add TOAST table to pg_index to allow for very large expression indexes (Nathan Bossart)
-§
-
-
+
+
+ Add TOAST table to pg_index
+ to allow for very large expression indexes (Nathan Bossart)
+ §
+
+
-
-
-Remove column
-pg_attribute.attcacheoff (David Rowley)
-§
-
-
+
+
+ Remove column pg_attribute.attcacheoff
+ (David Rowley)
+ §
+
+
-
-
-Add column pg_class.relallfrozen (Melanie Plageman)
-§
-
-
+
+
+ Add column pg_class.relallfrozen
+ (Melanie Plageman)
+ §
+
+
-
-
-Add amgettreeheight, amconsistentequality, and amconsistentordering to the index access method API (Mark Dilger)
-§
-§
-
-
+
+
+ Add amgettreeheight,
+ amconsistentequality, and
+ amconsistentordering to the index access method
+ API (Mark Dilger)
+ §
+ §
+
+
-
-
-Add GiST support function stratnum() (Paul A. Jungwirth)
-§
-
-
+
+
+ Add GiST support function stratnum()
+ (Paul A. Jungwirth)
+ §
+
+
-
-
-Record the default CPU signedness of char in pg_controldata (Masahiko Sawada)
-§
-
-
+
+
+ Record the default CPU signedness of
+ char in
+ (Masahiko Sawada)
+ §
+
+
-
-
-Add support for Python "Limited API" in (Peter Eisentraut)
-§
-§
-
+
+
+ Add support for Python "Limited API" in (Peter Eisentraut)
+ §
+ §
+
-
-This helps prevent problems caused by Python 3.x version mismatches.
-
-
+
+ This helps prevent problems caused by
+ Python 3.x version mismatches.
+
+
-
-
-Change the minimum supported Python version to 3.6.8 (Jacob Champion)
-§
-
-
+
+
+ Change the minimum supported Python
+ version to 3.6.8 (Jacob Champion)
+ §
+
+
-
-
-Remove support for OpenSSL versions older than 1.1.1 (Daniel Gustafsson)
-§
-§
-
-
+
+
+ Remove support for OpenSSL versions older
+ than 1.1.1 (Daniel Gustafsson)
+ §
+ §
+
+
-
-
-If LLVM is enabled, require version 14 or later (Thomas Munro)
-§
-
-
+
+
+ If LLVM is enabled, require version 14
+ or later (Thomas Munro)
+ §
+
+
-
-
-Add macro PG_MODULE_MAGIC_EXT to allow extensions to report their name and version (Andrei Lepikhov)
-§
-
+
+
+ Add macro PG_MODULE_MAGIC_EXT
+ to allow extensions to report their name and version (Andrei Lepikhov)
+ §
+
-
-This information can be access via the new function pg_get_loaded_modules().
-
-
+
+ This information can be access via the new function pg_get_loaded_modules().
+
+
-
-
-Document that SPI_connect()/SPI_connect_ext() always returns success (SPI_OK_CONNECT) (Stepan Neretin)
-§
-
+
+
+ Document that SPI_connect()/SPI_connect_ext()
+ always returns success (SPI_OK_CONNECT) (Stepan
+ Neretin)
+ §
+
-
-Errors are always reported via ereport().
-
-
+
+ Errors are always reported via ereport().
+
+
-
-
-Remove the experimental designation of Meson builds on Windows (Aleksander Alekseev)
-§
-
-
+
+
+ Add documentation
+ section about API and ABI
+ compatibility (David Wheeler, Peter Eisentraut)
+ §
+
+
-
-
-Add documentation section about API and ABI compatibility (David Wheeler, Peter Eisentraut)
-§
-
-
+
+
+ Remove the experimental designation of
+ Meson builds on Windows (Aleksander Alekseev)
+ §
+
+
-
-
-Remove configure options and (Thomas Munro)
-§
-§
-
+
+
+ Remove configure options and
+ (Thomas Munro)
+ §
+ §
+
-
-Thirty-two-bit atomic operations are now required.
-
-
+
+ Thirty-two-bit atomic operations are now required.
+
+
-
-
-Remove support for the HPPA/PA-RISC architecture (Tom Lane)
-§
-
-
+
+
+ Remove support for the
+ HPPA/PA-RISC architecture
+ (Tom Lane)
+ §
+
+
@@ -3240,24 +3764,27 @@ Author: Masahiko Sawada
2024-10-14 [7cdfeee32] Add contrib/pg_logicalinspect.
-->
-
-
-Add extension to inspect logical snapshots (Bertrand Drouvot)
-§
-
-
+
+
+ Add extension to inspect logical
+ snapshots (Bertrand Drouvot)
+ §
+
+
-
-
-Add extension pg_overexplain which adds debug details to EXPLAIN output (Robert Haas)
-§
-
-
+
+
+ Add extension which adds debug details
+ to EXPLAIN
+ output (Robert Haas)
+ §
+
+
-
-
-Add output columns to postgres_fdw_get_connections() (Hayato Kuroda, Sagar Dilip Shedge)
-§
-§
-§
-§
-
+
+
+ Add output columns to postgres_fdw_get_connections()
+ (Hayato Kuroda, Sagar Dilip Shedge)
+ §
+ §
+ §
+ §
+
-
-New output column used_in_xact indicates if the foreign data wrapper is being used by a current transaction, closed indicates if it is closed, user_name indicates the
-user name, and remote_backend_pid indicates the remote backend process identifier.
-
-
+
+ New output column used_in_xact indicates
+ if the foreign data wrapper is being used by a current transaction,
+ closed indicates if it is closed,
+ user_name indicates the user name, and
+ remote_backend_pid indicates the remote
+ backend process identifier.
+
+
-
-
-Allow SCRAM authentication from the client to be passed to
- servers (Matheus Alcantara, Peter Eisentraut)
-§
-
+
+
+ Allow SCRAM
+ authentication from the client to be passed to servers (Matheus Alcantara, Peter Eisentraut)
+ §
+
-
-This avoids storing postgres_fdw authentication information in the database, and is enabled with the
-postgres_fdwuse_scram_passthrough connection option. libpq uses new connection
-parameters scram_client_key and scram_server_key.
-
-
+
+ This avoids storing postgres_fdw
+ authentication information in the database, and is
+ enabled with the postgres_fdwuse_scram_passthrough
+ connection option. libpq uses new connection parameters
+ and .
+
+
-
-
-Allow SCRAM authentication from the client to be passed to
- servers (Matheus Alcantara)
-§
-
-
+
+
+ Allow SCRAM authentication from the client to be
+ passed to servers (Matheus Alcantara)
+ §
+
+
-
-
-Add on_error and log_verbosity options to (Atsushi Torikoshi)
-§
-
+
+
+ Add on_error and log_verbosity
+ options to (Atsushi Torikoshi)
+ §
+
-
-These control how file_fdw handles and reports invalid file rows.
-
-
+
+ These control how file_fdw handles and
+ reports invalid file rows.
+
+
-
-
-Add reject_limit to control the number of invalid rows file_fdw can ignore (Atsushi Torikoshi)
-§
-
+
+
+ Add reject_limit to control the number of
+ invalid rows file_fdw can ignore (Atsushi
+ Torikoshi)
+ §
+
-
-This is active when ON_ERROR = 'ignore'.
-
-
+
+ This is active when ON_ERROR = 'ignore'.
+
+
-
-
-Add configurable variable min_password_length to
- (Emanuele Musella, Maurizio Boriani)
-§
-
+
+
+ Add configurable variable min_password_length to
+ (Emanuele Musella, Maurizio Boriani)
+ §
+
-
-This controls the minimum password length.
-
-
+
+ This controls the minimum password length.
+
+
-
-
-Have pgbench report the number of failed, retried, or skipped transactions in per-script reports (Yugo Nagata)
-§
-
-
+
+
+ Have report the number of failed, retried,
+ or skipped transactions in per-script reports (Yugo Nagata)
+ §
+
+
-
-
-Add server variable weak to control invalid check digit acceptance (Viktor Holmberg)
-§
-
+
+
+ Add server variable weak
+ to control invalid check digit acceptance (Viktor Holmberg)
+ §
+
-
-This was previously only controlled by function isn_weak().
-
-
+
+ This was previously only controlled by function isn_weak().
+
+
-
-
-Allow values to be sorted to speed btree_gist index builds (Bernd Helmle, Andrey Borodin)
-§
-
-
+
+
+ Allow values to be sorted to speed
+ index builds (Bernd Helmle, Andrey Borodin)
+ §
+
+
-
-
-Add amcheck function gin_index_check() to verify GIN indexes (Grigory Kryachko, Heikki Linnakangas, Andrey Borodin)
-§
-
-
+
+
+ Add check function gin_index_check()
+ to verify GIN indexes (Grigory Kryachko, Heikki
+ Linnakangas, Andrey Borodin)
+ §
+
+
-
-
-Add functions pg_buffercache_evict_relation() and pg_buffercache_evict_all() to evict unpinned shared buffers (Nazir Bilal Yavuz)
-§
-
+
+
+ Add functions pg_buffercache_evict_relation()
+ and pg_buffercache_evict_all()
+ to evict unpinned shared buffers (Nazir Bilal Yavuz)
+ §
+
-
-The existing function pg_buffercache_evict() now returns the buffer flush status.
-
-
+
+ The existing function pg_buffercache_evict()
+ now returns the buffer flush status.
+
+
-
-
-Allow extensions to install custom EXPLAIN options (Robert Haas, Sami Imseih)
-§
-§
-§
-
-
+
+
+ Allow extensions to install custom
+ options (Robert Haas, Sami Imseih)
+ §
+ §
+ §
+
+
-
-
-Allow extensions to use the server's cumulative statistics API (Michael Paquier)
-§
-§
-
-
+
+
+ Allow extensions to use the server's cumulative statistics
+ API (Michael Paquier)
+ §
+ §
+
+
@@ -3479,60 +4036,71 @@ Author: Michael Paquier
2024-10-28 [6b652e6ce] Set query ID for inner queries of CREATE TABLE AS and DE
-->
-
-
-Allow the queries of and to be tracked by pg_stat_statements (Anthonin Bonnefoy)
-§
-
+
+
+ Allow the queries of
+ and to be tracked by
+ pg_stat_statements (Anthonin Bonnefoy)
+ §
+
-
-They are also now assigned query ids.
-
-
+
+ They are also now assigned query ids.
+
+
-
-
-Allow the parameterization of values in pg_stat_statements (Greg Sabino Mullane, Michael Paquier)
-§
-
+
+
+ Allow the parameterization of values in
+ pg_stat_statements (Greg Sabino Mullane,
+ Michael Paquier)
+ §
+
-
-This reduces the bloat caused by SET statements with differing constants.
-
-
+
+ This reduces the bloat caused by SET statements
+ with differing constants.
+
+
-
-
-Add pg_stat_statements columns to report parallel activity (Guillaume Lelarge)
-§
-
+
+
+ Add pg_stat_statements
+ columns to report parallel activity (Guillaume Lelarge)
+ §
+
-
-The new columns are parallel_workers_to_launch and parallel_workers_launched.
-
-
+
+ The new columns are
+ parallel_workers_to_launch and
+ parallel_workers_launched.
+
+
-
-
-Add pg_stat_statements.wal_buffers_full to report full WAL buffers (Bertrand Drouvot)
-§
-
-
+
+
+ Add
+ pg_stat_statements.wal_buffers_full
+ to report full WAL buffers (Bertrand Drouvot)
+ §
+
+
@@ -3548,40 +4116,65 @@ Author: Álvaro Herrera
2025-04-05 [749a9e20c] Add modern SHA-2 based password hashes to pgcrypto.
-->
-
-
-Add pgcrypto functions sha256crypt() and sha512crypt() (Bernd Helmle)
-§
-
-
+
+
+ Add pgcrypto algorithms sha256crypt
+ and sha512crypt
+ (Bernd Helmle)
+ §
+
+
-
-
-Add CFB mode to pgcrypto encryption and decryption (Umar Hayat)
-§
-
-
+
+
+ Add CFB mode
+ to pgcrypto encryption and decryption
+ (Umar Hayat)
+ §
+
+
+
+
+
+
+
+ Add function fips_mode()
+ to report the server's FIPS mode (Daniel
+ Gustafsson)
+ §
+
+
-
-
-Add pgcrypto server variable builtin_crypto_enabled to allow disabling builtin non-FIPS mode cryptographic functions (Daniel Gustafsson, Joe Conway)
-§
-
+
+
+ Add pgcrypto server variable builtin_crypto_enabled
+ to allow disabling builtin non-FIPS mode
+ cryptographic functions (Daniel Gustafsson, Joe Conway)
+ §
+
-
-This is useful for guaranteeing FIPS mode behavior.
-
-
+
+ This is useful for guaranteeing FIPS mode behavior.
+
+
diff --git a/src/backend/optimizer/path/joinpath.c b/src/backend/optimizer/path/joinpath.c
index 26f0336f1e409..7aa8f5d799cac 100644
--- a/src/backend/optimizer/path/joinpath.c
+++ b/src/backend/optimizer/path/joinpath.c
@@ -876,16 +876,13 @@ try_nestloop_path(PlannerInfo *root,
/*
* Check to see if proposed path is still parameterized, and reject if the
* parameterization wouldn't be sensible --- unless allow_star_schema_join
- * says to allow it anyway. Also, we must reject if have_dangerous_phv
- * doesn't like the look of it, which could only happen if the nestloop is
- * still parameterized.
+ * says to allow it anyway.
*/
required_outer = calc_nestloop_required_outer(outerrelids, outer_paramrels,
innerrelids, inner_paramrels);
if (required_outer &&
- ((!bms_overlap(required_outer, extra->param_source_rels) &&
- !allow_star_schema_join(root, outerrelids, inner_paramrels)) ||
- have_dangerous_phv(root, outerrelids, inner_paramrels)))
+ !bms_overlap(required_outer, extra->param_source_rels) &&
+ !allow_star_schema_join(root, outerrelids, inner_paramrels))
{
/* Waste no memory when we reject a path here */
bms_free(required_outer);
diff --git a/src/backend/optimizer/path/joinrels.c b/src/backend/optimizer/path/joinrels.c
index 60d65762b5d5e..aad41b940091d 100644
--- a/src/backend/optimizer/path/joinrels.c
+++ b/src/backend/optimizer/path/joinrels.c
@@ -565,9 +565,6 @@ join_is_legal(PlannerInfo *root, RelOptInfo *rel1, RelOptInfo *rel2,
* Also, if the lateral reference is only indirect, we should reject
* the join; whatever rel(s) the reference chain goes through must be
* joined to first.
- *
- * Another case that might keep us from building a valid plan is the
- * implementation restriction described by have_dangerous_phv().
*/
lateral_fwd = bms_overlap(rel1->relids, rel2->lateral_relids);
lateral_rev = bms_overlap(rel2->relids, rel1->lateral_relids);
@@ -584,9 +581,6 @@ join_is_legal(PlannerInfo *root, RelOptInfo *rel1, RelOptInfo *rel2,
/* check there is a direct reference from rel2 to rel1 */
if (!bms_overlap(rel1->relids, rel2->direct_lateral_relids))
return false; /* only indirect refs, so reject */
- /* check we won't have a dangerous PHV */
- if (have_dangerous_phv(root, rel1->relids, rel2->lateral_relids))
- return false; /* might be unable to handle required PHV */
}
else if (lateral_rev)
{
@@ -599,9 +593,6 @@ join_is_legal(PlannerInfo *root, RelOptInfo *rel1, RelOptInfo *rel2,
/* check there is a direct reference from rel1 to rel2 */
if (!bms_overlap(rel2->relids, rel1->direct_lateral_relids))
return false; /* only indirect refs, so reject */
- /* check we won't have a dangerous PHV */
- if (have_dangerous_phv(root, rel2->relids, rel1->lateral_relids))
- return false; /* might be unable to handle required PHV */
}
/*
@@ -1278,57 +1269,6 @@ has_legal_joinclause(PlannerInfo *root, RelOptInfo *rel)
}
-/*
- * There's a pitfall for creating parameterized nestloops: suppose the inner
- * rel (call it A) has a parameter that is a PlaceHolderVar, and that PHV's
- * minimum eval_at set includes the outer rel (B) and some third rel (C).
- * We might think we could create a B/A nestloop join that's parameterized by
- * C. But we would end up with a plan in which the PHV's expression has to be
- * evaluated as a nestloop parameter at the B/A join; and the executor is only
- * set up to handle simple Vars as NestLoopParams. Rather than add complexity
- * and overhead to the executor for such corner cases, it seems better to
- * forbid the join. (Note that we can still make use of A's parameterized
- * path with pre-joined B+C as the outer rel. have_join_order_restriction()
- * ensures that we will consider making such a join even if there are not
- * other reasons to do so.)
- *
- * So we check whether any PHVs used in the query could pose such a hazard.
- * We don't have any simple way of checking whether a risky PHV would actually
- * be used in the inner plan, and the case is so unusual that it doesn't seem
- * worth working very hard on it.
- *
- * This needs to be checked in two places. If the inner rel's minimum
- * parameterization would trigger the restriction, then join_is_legal() should
- * reject the join altogether, because there will be no workable paths for it.
- * But joinpath.c has to check again for every proposed nestloop path, because
- * the inner path might have more than the minimum parameterization, causing
- * some PHV to be dangerous for it that otherwise wouldn't be.
- */
-bool
-have_dangerous_phv(PlannerInfo *root,
- Relids outer_relids, Relids inner_params)
-{
- ListCell *lc;
-
- foreach(lc, root->placeholder_list)
- {
- PlaceHolderInfo *phinfo = (PlaceHolderInfo *) lfirst(lc);
-
- if (!bms_is_subset(phinfo->ph_eval_at, inner_params))
- continue; /* ignore, could not be a nestloop param */
- if (!bms_overlap(phinfo->ph_eval_at, outer_relids))
- continue; /* ignore, not relevant to this join */
- if (bms_is_subset(phinfo->ph_eval_at, outer_relids))
- continue; /* safe, it can be eval'd within outerrel */
- /* Otherwise, it's potentially unsafe, so reject the join */
- return true;
- }
-
- /* OK to perform the join */
- return false;
-}
-
-
/*
* is_dummy_rel --- has relation been proven empty?
*/
diff --git a/src/backend/optimizer/plan/createplan.c b/src/backend/optimizer/plan/createplan.c
index 4ad30b7627e6e..8baf36ba4b791 100644
--- a/src/backend/optimizer/plan/createplan.c
+++ b/src/backend/optimizer/plan/createplan.c
@@ -4348,9 +4348,11 @@ create_nestloop_plan(PlannerInfo *root,
List *joinrestrictclauses = best_path->jpath.joinrestrictinfo;
List *joinclauses;
List *otherclauses;
- Relids outerrelids;
List *nestParams;
+ List *outer_tlist;
+ bool outer_parallel_safe;
Relids saveOuterRels = root->curOuterRels;
+ ListCell *lc;
/*
* If the inner path is parameterized by the topmost parent of the outer
@@ -4412,9 +4414,47 @@ create_nestloop_plan(PlannerInfo *root,
* Identify any nestloop parameters that should be supplied by this join
* node, and remove them from root->curOuterParams.
*/
- outerrelids = best_path->jpath.outerjoinpath->parent->relids;
- nestParams = identify_current_nestloop_params(root, outerrelids);
+ nestParams = identify_current_nestloop_params(root,
+ best_path->jpath.outerjoinpath);
+
+ /*
+ * While nestloop parameters that are Vars had better be available from
+ * the outer_plan already, there are edge cases where nestloop parameters
+ * that are PHVs won't be. In such cases we must add them to the
+ * outer_plan's tlist, since the executor's NestLoopParam machinery
+ * requires the params to be simple outer-Var references to that tlist.
+ */
+ outer_tlist = outer_plan->targetlist;
+ outer_parallel_safe = outer_plan->parallel_safe;
+ foreach(lc, nestParams)
+ {
+ NestLoopParam *nlp = (NestLoopParam *) lfirst(lc);
+ TargetEntry *tle;
+
+ if (IsA(nlp->paramval, Var))
+ continue; /* nothing to do for simple Vars */
+ if (tlist_member((Expr *) nlp->paramval, outer_tlist))
+ continue; /* already available */
+
+ /* Make a shallow copy of outer_tlist, if we didn't already */
+ if (outer_tlist == outer_plan->targetlist)
+ outer_tlist = list_copy(outer_tlist);
+ /* ... and add the needed expression */
+ tle = makeTargetEntry((Expr *) copyObject(nlp->paramval),
+ list_length(outer_tlist) + 1,
+ NULL,
+ true);
+ outer_tlist = lappend(outer_tlist, tle);
+ /* ... and track whether tlist is (still) parallel-safe */
+ if (outer_parallel_safe)
+ outer_parallel_safe = is_parallel_safe(root,
+ (Node *) nlp->paramval);
+ }
+ if (outer_tlist != outer_plan->targetlist)
+ outer_plan = change_plan_targetlist(outer_plan, outer_tlist,
+ outer_parallel_safe);
+ /* And finally, we can build the join plan node */
join_plan = make_nestloop(tlist,
joinclauses,
otherclauses,
diff --git a/src/backend/optimizer/util/paramassign.c b/src/backend/optimizer/util/paramassign.c
index 3bd3ce37c8fce..9836abf947995 100644
--- a/src/backend/optimizer/util/paramassign.c
+++ b/src/backend/optimizer/util/paramassign.c
@@ -600,7 +600,7 @@ process_subquery_nestloop_params(PlannerInfo *root, List *subplan_params)
/*
* Identify any NestLoopParams that should be supplied by a NestLoop plan
- * node with the specified lefthand rels. Remove them from the active
+ * node with the specified lefthand input path. Remove them from the active
* root->curOuterParams list and return them as the result list.
*
* XXX Here we also hack up the returned Vars and PHVs so that they do not
@@ -626,11 +626,26 @@ process_subquery_nestloop_params(PlannerInfo *root, List *subplan_params)
* subquery, which'd be unduly expensive.
*/
List *
-identify_current_nestloop_params(PlannerInfo *root, Relids leftrelids)
+identify_current_nestloop_params(PlannerInfo *root, Path *leftpath)
{
List *result;
+ Relids leftrelids = leftpath->parent->relids;
+ Relids outerrelids = PATH_REQ_OUTER(leftpath);
+ Relids allleftrelids;
ListCell *cell;
+ /*
+ * We'll be able to evaluate a PHV in the lefthand path if it uses the
+ * lefthand rels plus any available required-outer rels. But don't do so
+ * if it uses *only* required-outer rels; in that case it should be
+ * evaluated higher in the tree. For Vars, no such hair-splitting is
+ * necessary since they depend on only one relid.
+ */
+ if (outerrelids)
+ allleftrelids = bms_union(leftrelids, outerrelids);
+ else
+ allleftrelids = leftrelids;
+
result = NIL;
foreach(cell, root->curOuterParams)
{
@@ -653,18 +668,20 @@ identify_current_nestloop_params(PlannerInfo *root, Relids leftrelids)
leftrelids);
result = lappend(result, nlp);
}
- else if (IsA(nlp->paramval, PlaceHolderVar) &&
- bms_is_subset(find_placeholder_info(root,
- (PlaceHolderVar *) nlp->paramval)->ph_eval_at,
- leftrelids))
+ else if (IsA(nlp->paramval, PlaceHolderVar))
{
PlaceHolderVar *phv = (PlaceHolderVar *) nlp->paramval;
+ Relids eval_at = find_placeholder_info(root, phv)->ph_eval_at;
- root->curOuterParams = foreach_delete_current(root->curOuterParams,
- cell);
- phv->phnullingrels = bms_intersect(phv->phnullingrels,
- leftrelids);
- result = lappend(result, nlp);
+ if (bms_is_subset(eval_at, allleftrelids) &&
+ bms_overlap(eval_at, leftrelids))
+ {
+ root->curOuterParams = foreach_delete_current(root->curOuterParams,
+ cell);
+ phv->phnullingrels = bms_intersect(phv->phnullingrels,
+ leftrelids);
+ result = lappend(result, nlp);
+ }
}
}
return result;
diff --git a/src/backend/utils/adt/float.c b/src/backend/utils/adt/float.c
index 6d20ae07ae7b0..ba66a9c4ce63a 100644
--- a/src/backend/utils/adt/float.c
+++ b/src/backend/utils/adt/float.c
@@ -4065,8 +4065,8 @@ float84ge(PG_FUNCTION_ARGS)
* in the histogram. width_bucket() returns an integer indicating the
* bucket number that 'operand' belongs to in an equiwidth histogram
* with the specified characteristics. An operand smaller than the
- * lower bound is assigned to bucket 0. An operand greater than the
- * upper bound is assigned to an additional bucket (with number
+ * lower bound is assigned to bucket 0. An operand greater than or equal
+ * to the upper bound is assigned to an additional bucket (with number
* count+1). We don't allow "NaN" for any of the float8 inputs, and we
* don't allow either of the histogram bounds to be +/- infinity.
*/
diff --git a/src/backend/utils/adt/numeric.c b/src/backend/utils/adt/numeric.c
index 40dcbc7b6710b..58ad1a65ef7b1 100644
--- a/src/backend/utils/adt/numeric.c
+++ b/src/backend/utils/adt/numeric.c
@@ -1958,9 +1958,10 @@ generate_series_numeric_support(PG_FUNCTION_ARGS)
* in the histogram. width_bucket() returns an integer indicating the
* bucket number that 'operand' belongs to in an equiwidth histogram
* with the specified characteristics. An operand smaller than the
- * lower bound is assigned to bucket 0. An operand greater than the
- * upper bound is assigned to an additional bucket (with number
- * count+1). We don't allow "NaN" for any of the numeric arguments.
+ * lower bound is assigned to bucket 0. An operand greater than or equal
+ * to the upper bound is assigned to an additional bucket (with number
+ * count+1). We don't allow "NaN" for any of the numeric inputs, and we
+ * don't allow either of the histogram bounds to be +/- infinity.
*/
Datum
width_bucket_numeric(PG_FUNCTION_ARGS)
diff --git a/src/include/optimizer/paramassign.h b/src/include/optimizer/paramassign.h
index 59dcb1ff05399..d30d20de29922 100644
--- a/src/include/optimizer/paramassign.h
+++ b/src/include/optimizer/paramassign.h
@@ -30,7 +30,7 @@ extern Param *replace_nestloop_param_placeholdervar(PlannerInfo *root,
extern void process_subquery_nestloop_params(PlannerInfo *root,
List *subplan_params);
extern List *identify_current_nestloop_params(PlannerInfo *root,
- Relids leftrelids);
+ Path *leftpath);
extern Param *generate_new_exec_param(PlannerInfo *root, Oid paramtype,
int32 paramtypmod, Oid paramcollation);
extern int assign_special_exec_param(PlannerInfo *root);
diff --git a/src/include/optimizer/paths.h b/src/include/optimizer/paths.h
index a48c972179712..8410531f2d640 100644
--- a/src/include/optimizer/paths.h
+++ b/src/include/optimizer/paths.h
@@ -109,8 +109,6 @@ extern Relids add_outer_joins_to_relids(PlannerInfo *root, Relids input_relids,
List **pushed_down_joins);
extern bool have_join_order_restriction(PlannerInfo *root,
RelOptInfo *rel1, RelOptInfo *rel2);
-extern bool have_dangerous_phv(PlannerInfo *root,
- Relids outer_relids, Relids inner_params);
extern void mark_dummy_rel(RelOptInfo *rel);
extern void init_dummy_sjinfo(SpecialJoinInfo *sjinfo, Relids left_relids,
Relids right_relids);
diff --git a/src/test/regress/expected/join.out b/src/test/regress/expected/join.out
index f35a0b18c37cb..c292f04fdbaab 100644
--- a/src/test/regress/expected/join.out
+++ b/src/test/regress/expected/join.out
@@ -3946,6 +3946,59 @@ where t1.unique2 < 42 and t1.stringu1 > t2.stringu2;
(1 row)
-- variant that isn't quite a star-schema case
+explain (verbose, costs off)
+select ss1.d1 from
+ tenk1 as t1
+ inner join tenk1 as t2
+ on t1.tenthous = t2.ten
+ inner join
+ int8_tbl as i8
+ left join int4_tbl as i4
+ inner join (select 64::information_schema.cardinal_number as d1
+ from tenk1 t3,
+ lateral (select abs(t3.unique1) + random()) ss0(x)
+ where t3.fivethous < 0) as ss1
+ on i4.f1 = ss1.d1
+ on i8.q1 = i4.f1
+ on t1.tenthous = ss1.d1
+where t1.unique1 < i4.f1;
+ QUERY PLAN
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
+ Nested Loop
+ Output: (64)::information_schema.cardinal_number
+ Join Filter: (t1.tenthous = ((64)::information_schema.cardinal_number)::integer)
+ -> Seq Scan on public.tenk1 t3
+ Output: t3.unique1, t3.unique2, t3.two, t3.four, t3.ten, t3.twenty, t3.hundred, t3.thousand, t3.twothousand, t3.fivethous, t3.tenthous, t3.odd, t3.even, t3.stringu1, t3.stringu2, t3.string4
+ Filter: (t3.fivethous < 0)
+ -> Nested Loop
+ Output: t1.tenthous, t2.ten
+ -> Nested Loop
+ Output: t1.tenthous, t2.ten, i4.f1
+ Join Filter: (t1.unique1 < i4.f1)
+ -> Hash Join
+ Output: t1.tenthous, t1.unique1, t2.ten
+ Hash Cond: (t2.ten = t1.tenthous)
+ -> Seq Scan on public.tenk1 t2
+ Output: t2.unique1, t2.unique2, t2.two, t2.four, t2.ten, t2.twenty, t2.hundred, t2.thousand, t2.twothousand, t2.fivethous, t2.tenthous, t2.odd, t2.even, t2.stringu1, t2.stringu2, t2.string4
+ -> Hash
+ Output: t1.tenthous, t1.unique1
+ -> Nested Loop
+ Output: t1.tenthous, t1.unique1
+ -> Subquery Scan on ss0
+ Output: ss0.x, (64)::information_schema.cardinal_number
+ -> Result
+ Output: ((abs(t3.unique1))::double precision + random())
+ -> Index Scan using tenk1_thous_tenthous on public.tenk1 t1
+ Output: t1.unique1, t1.unique2, t1.two, t1.four, t1.ten, t1.twenty, t1.hundred, t1.thousand, t1.twothousand, t1.fivethous, t1.tenthous, t1.odd, t1.even, t1.stringu1, t1.stringu2, t1.string4
+ Index Cond: (t1.tenthous = (((64)::information_schema.cardinal_number))::integer)
+ -> Seq Scan on public.int4_tbl i4
+ Output: i4.f1
+ Filter: (i4.f1 = ((64)::information_schema.cardinal_number)::integer)
+ -> Seq Scan on public.int8_tbl i8
+ Output: i8.q1, i8.q2
+ Filter: (i8.q1 = ((64)::information_schema.cardinal_number)::integer)
+(33 rows)
+
select ss1.d1 from
tenk1 as t1
inner join tenk1 as t2
@@ -4035,6 +4088,37 @@ select * from
1 | 2 | 2
(1 row)
+-- This example demonstrates the folly of our old "have_dangerous_phv" logic
+begin;
+set local from_collapse_limit to 2;
+explain (verbose, costs off)
+select * from int8_tbl t1
+ left join
+ (select coalesce(t2.q1 + x, 0) from int8_tbl t2,
+ lateral (select t3.q1 as x from int8_tbl t3,
+ lateral (select t2.q1, t3.q1 offset 0) s))
+ on true;
+ QUERY PLAN
+------------------------------------------------------------------
+ Nested Loop Left Join
+ Output: t1.q1, t1.q2, (COALESCE((t2.q1 + t3.q1), '0'::bigint))
+ -> Seq Scan on public.int8_tbl t1
+ Output: t1.q1, t1.q2
+ -> Materialize
+ Output: (COALESCE((t2.q1 + t3.q1), '0'::bigint))
+ -> Nested Loop
+ Output: COALESCE((t2.q1 + t3.q1), '0'::bigint)
+ -> Seq Scan on public.int8_tbl t2
+ Output: t2.q1, t2.q2
+ -> Nested Loop
+ Output: t3.q1
+ -> Seq Scan on public.int8_tbl t3
+ Output: t3.q1, t3.q2
+ -> Result
+ Output: NULL::bigint, NULL::bigint
+(16 rows)
+
+rollback;
-- Test proper handling of appendrel PHVs during useless-RTE removal
explain (costs off)
select * from
diff --git a/src/test/regress/sql/join.sql b/src/test/regress/sql/join.sql
index cc5128add4df0..88d2204e4471d 100644
--- a/src/test/regress/sql/join.sql
+++ b/src/test/regress/sql/join.sql
@@ -1277,6 +1277,23 @@ where t1.unique2 < 42 and t1.stringu1 > t2.stringu2;
-- variant that isn't quite a star-schema case
+explain (verbose, costs off)
+select ss1.d1 from
+ tenk1 as t1
+ inner join tenk1 as t2
+ on t1.tenthous = t2.ten
+ inner join
+ int8_tbl as i8
+ left join int4_tbl as i4
+ inner join (select 64::information_schema.cardinal_number as d1
+ from tenk1 t3,
+ lateral (select abs(t3.unique1) + random()) ss0(x)
+ where t3.fivethous < 0) as ss1
+ on i4.f1 = ss1.d1
+ on i8.q1 = i4.f1
+ on t1.tenthous = ss1.d1
+where t1.unique1 < i4.f1;
+
select ss1.d1 from
tenk1 as t1
inner join tenk1 as t2
@@ -1332,6 +1349,18 @@ select * from
(select 1 as x) ss1 left join (select 2 as y) ss2 on (true),
lateral (select ss2.y as z limit 1) ss3;
+-- This example demonstrates the folly of our old "have_dangerous_phv" logic
+begin;
+set local from_collapse_limit to 2;
+explain (verbose, costs off)
+select * from int8_tbl t1
+ left join
+ (select coalesce(t2.q1 + x, 0) from int8_tbl t2,
+ lateral (select t3.q1 as x from int8_tbl t3,
+ lateral (select t2.q1, t3.q1 offset 0) s))
+ on true;
+rollback;
+
-- Test proper handling of appendrel PHVs during useless-RTE removal
explain (costs off)
select * from
pFad - Phonifier reborn
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.