E.16. Postgres Pro Enterprise 13.12.1

Дата выпуска: 2023-08-22

E.16.1. Обзор

Этот выпуск основан на PostgreSQL 13.12 и Postgres Pro Enterprise 13.11.1. Все изменения, унаследованные от PostgreSQL 13.12, описаны в Замечаниях к выпуску PostgreSQL 13.12. По сравнению с Postgres Pro Enterprise 13.11.1 эта версия также содержит следующие изменения:

  • Добавлен параметр конфигурации enable_appendorpath, который включает применение плана Append для выражений, содержащих предложения OR. Этот план будет полезен для использования приложениями с автоматически генерируемыми запросами.

  • Устранена проблема в вычислении базы страницы для 64-битных идентификаторов транзакций. В редких случаях она могла приводить к сбою транзакции или появлению некорректного xmin, что проявлялось в виде таких ошибок, как «fatal xid base calculation error» (критическая ошибка вычисления базы xid).

  • Исправлена проблема, из-за которой при использовании CFS функция pg_database_size могла возвращать неправильный размер базы данных, отличавшийся от фактически занимаемого места на диске. Ранее размер разреженных файлов CFS рассчитывался с использованием логического, а не физического размера файла в блоках данных.

  • Скорректированы состояния не относящихся к CFS фоновых рабочих процессов, выводимых в представлении pg_stat_activity. После сборки мусора состояние процесса теперь устанавливается правильно.

  • Устранена ошибка в pgpro_scheduler, при которой руководящий планировщик удалял данные о процессе database manager до его инициализации, в результате чего процесс завершался с ошибкой «Scheduler manager XX: cannot find information about self in scheduler_state» (Менеджер планирования XX не смог найти информацию о себе в scheduler_state).

  • Добавлена поддержка ОС Debian 12; поддержка Debian 9 прекращена.

  • Исправлена устаревшая рекомендация по настройке файла модуля в комментариях файла postgrespro-ent-13.service.

  • Исправлен алгоритм оценки оптимизатором количества кортежей, совпадающих по ключу хеширования. Оптимизатор не учитывал, что при соединении по большому количеству столбцов количество уникальных хеш-ключей должно быстро расти и считал их количество малым, в итоге выбирая объединение слиянием вместо соединения по хешу.

  • Исправлено использование компонента joinsel, необходимого для более точной оценки количества строк по нескольким столбцам. Если по какой-либо причине (например, из-за недостаточно подробной статистики) joinsel не может сделать хорошее предсказание, Postgres Pro не будет использовать joinsel в этом конкретном случае, а будет использовать стандартный алгоритм оценки количества строк. Если joinsel должен оценить количество строк по одному столбцу, вместо этого также будет использоваться стандартный алгоритм.

  • Исправлена ошибка, не позволявшая хранить данные типов mchar, mvarchar размером более 250 МБ. Теперь может корректно храниться до 1 ГБ данных этих типов.

  • Приложение pg_probackup обновлено до версии 2.6.5 Enterprise, в которой улучшена производительность и исправлены некоторые ошибки:

    • Попытка частичного восстановления в непустой каталог PGDATA теперь завершается ошибкой, но выполнить такое восстановление можно, если указан флаг --destroy-all-other-dbs.

    • Исправлено включение выделенных, но пустых страниц в инкрементальное резервное копирование.

    • Исправлены проблемы восстановления на момент времени:

      • Восстановление по времени, указанному в команде pg_probackup show.

      • Восстановление из резервных копий с параметрами --recovery-target-timeline и --no-validate.

    • Улучшена обработка файлов в сжатых табличных пространствах модулем PTRACK.

    • Флаг --skip-if-exist переименован в --skip-if-exists.

  • Расширение pg_hint_plan обновлено для включения исправления, устраняющего повреждение стека указаний.

  • Модуль pgpro_pwr обновлён до версии 4.2, в которой в отчёт были добавлены интерактивные возможности.

  • Расширение PTRACK обновлено до версии 2.5 Enterprise.

E.16.2. Миграция на версию 13.12.1

Если вы производите обновление выпуска Postgres Pro Enterprise, базирующегося на той же основной версии PostgreSQL, достаточно просто установить новый выпуск в текущий каталог инсталляции.

Если вы хотите сохранить существующее представление карт видимости в pageinspect при миграции на текущую основную версию Postgres Pro Enterprise с использованием pg_upgrade, выполните команду VACUUM, прежде чем начинать обновление.

При обновлении до версии Postgres Pro Enterprise 13.11.1 и выше обязательно обновите pg_probackup до версии 2.6.4 или выше, поскольку более ранние версии pg_probackup несовместимы с этими версиями Postgres Pro Enterprise.

Если вы ранее мигрировали на Postgres Pro Enterprise версии 13.3.1 или ниже, обязательно перестройте индексы GIN, выполнив команду REINDEX.

Если вы используете PTRACK в процедуре резервного копирования, реализуемой c помощью утилиты pg_probackup, и обновляетесь с Postgres Pro Enterprise версии 13.2.2 или ниже, сделайте полную резервную копию базы данных после обновления.

Если в вашей инсталляции Postgres Pro Enterprise 13.2.1 имеются сжатые табличные пространства, созданные без явного выбора алгоритма pglz, произведите обновление следующим образом. До обновления выгрузите полный дамп, используя pg_dumpall. Обновите Postgres Pro Enterprise, пересоздайте кластер баз данных и восстановите все данные из дампа. Затем вы можете создать табличные пространства CFS по прежней схеме.

Если вы уже обновили инсталляцию Postgres Pro Enterprise 13.2.1 с табличными пространствами CFS и потеряли доступ к сжатым данным, обратитесь к службе поддержки.

Для перехода с PostgreSQL, а также с выпуска Postgres Pro Standard или Postgres Pro Enterprise, базирующегося на предыдущей основной версии PostgreSQL, обратитесь к инструкциям по миграции на версию 13.

E.16. Postgres Pro Enterprise 13.12.1

Release Date: 2023-08-22

E.16.1. Overview

This release is based on PostgreSQL 13.12 and Postgres Pro Enterprise 13.11.1. All changes inherited from PostgreSQL 13.12 are listed in PostgreSQL 13.12 Release Notes. As compared with Postgres Pro Enterprise 13.11.1, this version also provides the following changes:

  • Added the enable_appendorpath configuration parameter, which enables the Append plan for OR clauses. 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_size function 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_activity view. The worker status is now set correctly after garbage collection.

  • Fixed an issue in pgpro_scheduler with supervisor scheduler removing the database manager data before its initialization, which could lead to the manager exiting with an error Scheduler manager XX: cannot find information about self in scheduler_state.

  • Added support for Debian 12 and ended support for Debian 9.

  • Fixed an outdated recommendation to customize a unit file in the postgrespro-ent-13.service file 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 joinsel component, which is needed for a more accurate cardinality estimation by several columns. If for some reason (for example, because of insufficient detailed statistics) joinsel cannot make a good prediction, Postgres Pro will not use joinsel in this particular case, but estimate cardinality using a regular algorithm. If joinsel has 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, mvarchar types 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 PGDATA directory now completes with an error, but a possibility of such a restore is retained with the --destroy-all-other-dbs flag 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 show command

      • Restore from backups with the --recovery-target-timeline and --no-validate options

    • Improved processing of files in compressed tablespaces by the PTRACK module.

    • Renamed the --skip-if-exist flag to --skip-if-exists.

  • Upgraded pg_hint_plan to include a bugfix related to hint stack corruption.

  • Upgraded pgpro_pwr to version 4.2, which adds interactive features to the report.

  • Upgraded PTRACK to version 2.5 Enterprise.

E.16.2. Migration to Version 13.12.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.

If you are migrating to the current major version of Postgres Pro Enterprise using pg_upgrade, and you want to keep the existing visibility map representation in pageinspect, you should run the VACUUM command before the upgrade.

When upgrading to Postgres Pro Enterprise versions starting with 13.11.1, make sure to upgrade pg_probackup to version 2.6.4 or higher since lower versions are incompatible with these Postgres Pro Enterprise versions.

If you have previously migrated to Postgres Pro Enterprise 13.3.1 or lower, you must run the REINDEX command to rebuild GIN indexes.

If you are upgrading from Postgres Pro Enterprise versions 13.2.2 or lower and take PTRACK backups using pg_probackup, retake a full backup after upgrade.

If you have an installation of Postgres Pro Enterprise 13.2.1 that contains compressed tablespaces created without explicitly specifying the pglz algorithm, perform an upgrade as follows. Before upgrading, make a complete dump using pg_dumpall. Upgrade Postgres Pro Enterprise, re-create your database cluster, and restore the dump. Then you can create compressed tablespaces in the same way as before.

If you have already upgraded your installation with CFS tablespaces from Postgres Pro Enterprise 13.2.1, and you cannot access the compressed data, call the support team.

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 13.

FAQ