E.3. Postgres Pro Enterprise 11.21.1
Release date: 2023-08-21
E.3.1. Overview
This release is based on PostgreSQL 11.21 and Postgres Pro Enterprise 11.20.1. All changes inherited from PostgreSQL 11.21 are listed in PostgreSQL 11.21 Release Notes. As compared with Postgres Pro Enterprise 11.20.1, this version also provides the following changes:
Added the enable_appendorpath configuration parameter, which enables the
Appendplan forORclauses. It is useful for applications with auto-generated queries.Fixed an issue with calculating the page base for 64-bit XIDs. In some rare cases, it could lead to a transaction failure or to an incorrect
xmin, which manifested itself in errors, such as “Fatal xid base calculation error”.Fixed an issue that could cause the
pg_database_sizefunction to return incorrect database size, which was different from the actual disk space, when using the CFS. Previously, the size of CFS sparse files was calculated using the logical file size rather than the physical file size in data blocks.Fixed states of non-CFS background workers displayed in the
pg_stat_activityview. The worker status is now set correctly after garbage collection.Fixed an issue in pgpro_scheduler with supervisor scheduler removing the
database managerdata before its initialization, which could lead to the manager exiting with an error “Scheduler manager XX: cannot find information about self in scheduler_state”.Ended support for Debian 9.
Fixed an outdated recommendation to customize a unit file in the
postgrespro-ent-11.servicefile comments.Fixed the optimizer estimation of the number of tuples with the same hash key. The optimizer did not take into account that in a join by a large number of columns, the number of unique hash keys must rapidly grow, considered the number of hash keys to be small and finally chose merge join instead of hash join.
Fixed usage of the
joinselcomponent, which is needed for a more accurate cardinality estimation by several columns. If for some reason (for example, because of insufficient detailed statistics)joinselcannot make a good prediction, Postgres Pro will not usejoinselin this particular case, but estimate cardinality using a regular algorithm. Ifjoinselhas to estimate cardinality by a single column, a regular algorithm will also be used instead.Fixed a bug that did not allow storing data of the
mchar,mvarchartypes larger than 250 MB. Now up to 1 GB of data of these types can be stored correctly.Upgraded pg_probackup to version 2.6.5 Enterprise, which provides the following optimizations and bug fixes:
An attempt of a partial restore to a non-empty
PGDATAdirectory now completes with an error, but a possibility of such a restore is retained with the--destroy-all-other-dbsflag specified.Fixed inclusion of allocated but empty pages in an incremental backup.
Fixed point-in-time recovery issues:
Restore on the recovery time specified by the
pg_probackup showcommandRestore from backups with the
--recovery-target-timelineand--no-validateoptions
Improved processing of files in compressed tablespaces by the PTRACK module.
Renamed the
--skip-if-existflag to--skip-if-exists.
Upgraded pg_hint_plan to version 1.3.8 to include a bugfix related to hint stack corruption.
Upgraded PTRACK to version 2.5 Enterprise.
E.3.2. Migration to Version 11.21.1
If you are upgrading from a Postgres Pro Enterprise release based on the same PostgreSQL major version, it is enough to install the new version into your current installation directory.
Migration of a cluster with tables larger than 16Tb to Postgres Pro Enterprise versions 11 or 10 is not supported.
If you have previously migrated to Postgres Pro Enterprise 11.12.1 or lower, you must run the REINDEX command to rebuild GIN indexes.
While functions numeric_eq, numeric_ne, numeric_gt, numeric_ge, numeric_lt, and numeric_le are actually leakproof, they were not marked as such in Postgres Pro Enterprise 11.6.1 or lower, which could lead to incorrect query optimization. In particular, it negatively affected query execution if row-level security policy was in use. Version 11.7.1 repairs this issue for new installations by correcting the initial catalog data, but existing installations will still have incorrect markings unless you update pg_proc entries for these functions. You can run pg_upgrade to upgrade your server instance to a version containing the corrected initial data, or manually correct these entries in each database of the installation using the ALTER FUNCTION command. For example:
ALTER FUNCTION pg_catalog.numeric_eq LEAKPROOF
Version 11.7.1 also fixes SIMILAR TO and POSIX regular expressions that use character classes for icu collations, so you may need to check for objects that use such regular expressions.
Starting from Postgres Pro Enterprise 11.6.1, the ICU library upgrade does not interfere with the server start. Before connecting to a database using ICU as the default collation, Postgres Pro compares this collation version to the one provided by the ICU library and displays a warning if the collation versions do not match; you may need to rebuild the objects that depend on the default collation if you think the collation change may affect the sort order of your data. To suppress these warnings, you can use the ALTER COLLATION "default" REFRESH VERSION command, as explained in ALTER COLLATION.
If you are upgrading from Postgres Pro Enterprise versions 11.11.x or lower and take PTRACK backups using pg_probackup, retake a full backup after upgrade.
To migrate from PostgreSQL, as well as Postgres Pro Standard or Postgres Pro Enterprise based on a previous PostgreSQL major version, see the migration instructions for version 11.