A.3. pg_probackup 3.2.0 #

Дата выпуска: 2025-12-30

Этот выпуск основан на pg_probackup3 3.1.1, в нём повышена стабильность и производительность и улучшена совместимость pg_probackup3. Основные изменения перечислены ниже:

  • WAL и инкрементальное резервное копирование:

    • Добавлена обработка WAL.

    • Реализовано ожидание полной загрузки WAL-сегментов.

    • Добавлено игнорирование WAL-файлов, отсутствующих в последней инкрементальной резервной копии, при восстановлении для корректного запуска сервера.

    • Добавлена проверка WAL для всей цепочки резервных копий при объединении.

    • Добавлена установка start_lsn в соответствии с последней инкрементальной резервной копией после объединения.

    • Ограничено число потоков резервного копирования доступными процессами walsender.

    • Реализовано сохранение WAL-файлов только для последней инкрементальной резервной копии во время объединения.

    • Добавлен параметр --wal-archive-dir, позволяющий использовать отдельный каталог для архивации WAL-файлов.

    • Исправлены уровни протоколирования команд архивации WAL.

    • Исправлена ошибка, которая возникала при указании нескольких walsender_plugin_libraries.

  • Резервное копирование и восстановление:

    • Исправлена проверка уровня сжатия для поддержки уровней выше 9, когда это позволяет выбранный алгоритм.

    • Исправлена обработка табличных пространств по умолчанию при инкрементальном восстановлении: их содержимое больше не перезаписывается.

    • Исправлено формирование пути в restore_command.

    • Добавлены сообщения о завершении проверки резервных копий и о выбранном источнике резервного копирования, если он не указан явно.

    • Улучшены сообщения, отображаемые при отсутствии файлов резервного копирования.

    • Добавлена проверка файлов с одинаковыми идентификаторами.

    • Исправлено восстановление из смешанных цепочек инкрементальных резервных копий.

    • Упрощена проверка перед восстановлением: для восстановления не из последней резервной копии больше не требуется чтение метаданных всех последующих инкрементальных резервных копий.

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

    • Добавлены параметры --db-include-oid и --db-exclude-oid для команд backup и restore для резервного копирования и восстановления отдельных баз данных.

  • catchup:

    • Реализована корректная обработка ошибок и пропуск файлов.

    • Добавлен параметр --exclude-path для исключения определённых файлов и каталогов.

    • Добавлена поддержка параметров --threads, --temp-slot, --perm-slot, --slot-name и --tablespace-mapping.

  • CFS:

    • Реализована поддержка резервного копирования и восстановления файлов CFS в режиме DIRECT.

    • Добавлена проверка блоков CFS с проверкой контрольных сумм.

    • Добавлено сообщение о том, что в режиме BASE резервное копирование CFS не поддерживается.

  • pgpro_backupstream (восстановление на удалённый сервер):

    • Отменено создание файла recovery.signal в случае ошибки.

    • Исправлена логика потоков в send-backup: потоки теперь завершают работу только после того, как данные полностью прочитаны и обработаны утилитой pgpro_backupstream.

  • S3:

    • Сделан обязательным параметр бакета.

    • Исправлена совместимость с хранилищами, которые не поддерживают версионированные бакеты.

    • Реализовано повторное подключение с соответствующими статус-сообщениями при разрыве соединения.

    • Ускорена запись в S3 за счёт выбора сегментов с наименьшей нагрузкой.

    • Установлен лимит на количество составных (multipart) загрузок.

  • FUSE:

    • Добавлен параметр --unmount для размонтирования файловой системы FUSE.

    • Добавлен параметр --detach для запуска процесса в фоновом режиме.

    • Добавлена поддержка команд chmod и chown.

  • TDE (Прозрачное защитное преобразование данных):

    • Добавлена поддержка TDE.

    • Реализовано хранение статуса TDE в метаданных резервной копии.

A.3. pg_probackup 3.2.0 #

Release date: 2025-12-30

This release is based on pg_probackup3 3.1.1 and provides improvements to stability, performance, and compatibility of pg_probackup3. Notable changes are as follows:

  • WAL and incremental backups:

    • Added WAL parsing.

    • Implemented waiting for complete WAL segment downloads.

    • Made WAL files missing from the last incremental backup to be ignored during restore to allow correct server startup.

    • Added WAL validation for the entire backup chain during merge.

    • Made start_lsn to be set according to the latest incremental backup after merge.

    • Limited the number of backup threads by available walsenders.

    • Made WAL files to be preserved only for the latest incremental backup during merge.

    • Added the --wal-archive-dir option that allows using a separate WAL archive directory.

    • Fixed logging levels for WAL archiving commands.

    • Fixed an error that occurred when specifying multiple walsender_plugin_libraries.

  • Backup and restore:

    • Fixed compression level validation to support levels above 9 when the selected algorithm allows it.

    • Fixed handling of default tablespaces during incremental restore: they are no longer overwritten.

    • Fixed path generation in restore_command.

    • Added messages for backup validation completion and for the selected backup source when it is not explicitly specified.

    • Improved messages that are displayed when backup files are missing.

    • Added validation for files with duplicate IDs.

    • Fixed restoring from mixed incremental backup chains.

    • Simplified pre-restore validation: restoring from non-latest incremental backups no longer requires reading metadata of all subsequent incremental backups.

    • Fixed validation of the entire backup chain when merging multiple incremental backups into a single interval backup.

    • Added the --db-include-oid and --db-exclude-oid options for the backup and restore commands to backup and restore individual databases.

  • catchup:

    • Implemented proper error handling and file skipping.

    • Added the --exclude-path option to exclude specific files and directories.

    • Added support for the --threads, --temp-slot, --perm-slot, --slot-name, and --tablespace-mapping options.

  • CFS:

    • Implemented CFS file backup and restore support in the DIRECT mode.

    • Added CFS block validation with checksum verification.

    • Added a message indicating that CFS backup is not supported in the BASE mode.

  • pgpro_backupstream (remote host restore):

    • Removed creation of recovery.signal in case of an error.

    • Fixed thread logic in send-backup: threads now terminate only after data has been completely read and processed by pgpro_backupstream.

  • S3:

    • Made the bucket parameter mandatory.

    • Fixed compatibility with storage services that do not support versioned buckets.

    • Implemented reconnection with appropriate status messages upon connection loss.

    • Improved S3 write performance by selecting the least loaded segments.

    • Set a limit on the number of multipart uploads.

  • FUSE:

    • Added the --unmount option for unmounting the FUSE filesystem.

    • Added the --detach option to run the process in the background.

    • Added support for the chmod and chown commands.

  • TDE (Transparent Data Encryption):

    • Added TDE support.

    • Made the TDE status to be stored in backup metadata.

FAQ