E.4. Postgres Pro Enterprise 11.20.1
Release date: 2023-05-29
E.4.1. Overview
This release is based on PostgreSQL 11.20 and Postgres Pro Enterprise 11.19.1. All changes inherited from PostgreSQL 11.20 are listed in PostgreSQL 11.20 Release Notes. As compared with Postgres Pro Enterprise 11.19.1, this version also provides the following changes:
Optimized CFS garbage collector: reduced CPU costs and reads from disk during file analysis.
Added the unicode_nul_character_replacement_in_jsonb configuration parameter to replace
'\u0000'with the specified unicode character when calling a function processing JSONB.Fixed an issue with much larger CFS data files on the replica compared to the master. Now the replica writes the files in the same way as the master when consistent recovery state is reached.
Removed the deprecated configuration parameter
cfs_gc_verify_filefrompostgresql.conf. The configuration parametercfs_encryptionis deprecated and will be removed in a future release.Ended support for Ubuntu 18.04.
Upgraded mamonsu to version 3.5.3, which provides new features and bugfixes. Notable changes are as follows:
Removed the limitation that did not allow a user different from
mamonsuto read and edit the configuration fileagent.conf. Specifically, the pg_probackup plugin now works correctly when themamonsuuser owns the pg_probackup backup directory.Removed metrics that conflict native Zabbix agents from Zabbix configuration file being exported.
Added a check that the server where mamonsu WAL plugin runs is not in recovery.
Upgraded pg_probackup to version 2.6.2 Enterprise, which provides optimizations and bug fixes:
Included the
catchupcommand, which was previously provided only in a test mode, in the production delivery.Added optimizations for incremental backups that reduce disk read amount almost twice.
Improved error and warning messaging and unified the error message style.
Fixed issues and improved the reliability of CFS table
mergeandbackupoperations.Fixed usability issues with the
showcommand, in particular: fixed displaying the recovery time, which could sometimes not be displayed after a successful backup; made the backup time be displayed in a table view even if the backup ended with an error.Fixed an error in specifying the relative path after restoring a cluster from a backup.
Corrected an improper assignment of backup IDs that took place in some cases.
Upgraded PTRACK to version 2.4.3.
Upgraded orafce to version 4.2.6.
Upgraded pg_hint_plan to version 1.3.7.
E.4.2. Migration to Version 11.20.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.