A.1. pg_probackup 3.3.0 #

Дата выпуска: 2026-04-29

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

  • Новые возможности:

    • Добавлена поддержка частичного восстановления для Postgres Pro Standard 17 и выше.

    • Добавлен параметр --waldir для команд restore и catchup, а также параметр --wal-archive-dir для команды backup для указания отдельного каталога WAL-файлов.

    • Добавлен параметр --no-validate-wal для пропуска проверки WAL при восстановлении.

    • Добавлен параметр --wal-tree для команд set-config и add-instance для хранения WAL-файлов в подкаталогах, что оптимизирует использование дискового пространства и предотвращает перегрузку файловой системы.

    • Добавлены параметры точки восстановления для команды fuse.

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

    • Улучшено поведение параметра --batch-size. Теперь, если он не задан явно, он принимает значение, равное количеству потоков (--threads).

    • Добавлена переменная окружения PG_PROBACKUP_MAX_THREADS для ограничения количества рабочих потоков.

    • Добавлено предупреждение с понятным сообщением, когда используемая версия Postgres Pro не поддерживается.

  • Исправления ошибок:

    • Исправлена проблема с max_wal_senders в режиме PRO. Ранее при установке для -j значения 1 в режиме STREAM поток записи получал ноль рабочих потоков, и резервное копирование завершалось ошибкой. Теперь при нехватке max_wal_senders выводится информативное сообщение с рекомендацией увеличить это значение в файле конфигурации postgresql.conf.

    • Устранена блокировка сборщика мусора CFS (GC) во время длительного создания резервной копии. Теперь GC может работать параллельно с резервным копированием.

    • Исправлено выполнение команды backup в режиме DIRECT: теперь она пропускает временные и нежурналируемые таблицы.

    • Исправлен конфликт совместно используемых параметров --retention-redundancy и --retention-window. Ранее резервные копии, которые должны были сохраняться в соответствии с политикой избыточности, могли быть удалены по политике окна хранения. Теперь --retention-redundancy имеет приоритет.

    • Удалён параметр --threads из команды retention как неприменимый.

    • Исправлена проблема с S3, когда ошибки соединения CURL (SSL, таймауты, сертификаты) игнорировались, что позже приводило к сбою с малоинформативным сообщением. Теперь такие ошибки обнаруживаются немедленно с указанием причины.

    • Исправлена совместимость с S3-бакетами, у которых включено версионирование.

    • Улучшена совместимость с S3: добавлена поддержка URL в стиле virtual-host и удалена проверка прав доступа к бакету, которая не поддерживалась некоторыми провайдерами и могла вызывать ошибки подключения (Amazon AWS S3, SBER Cloud и другие).

    • Исправлена обработка пустых ответов от библиотеки libpq.

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

    • Исправлен некорректный код возврата при ошибке подключения к Postgres Pro.

    • Исправлено разрешение IP-адреса по имени узла в утилите удалённого восстановления.

    • Исправлено некорректное отображение значения сжатия в выводе команды show.

    • Исправлено некорректное отображение размера WAL после объединения (merge).

    • Исправлена обработка пути к WAL-файлу в командах archive-push и archive-get. Теперь поддерживаются абсолютные пути, а относительные пути обрабатываются корректно.

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

    • Добавлена проверка: операции, изменяющие каталог резервных копий, теперь завершаются ошибкой, если каталог принадлежит pg_probackup 2.X.

  • Прочие улучшения:

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

    • В режиме DIRECT реализовано чтение нескольких страниц за один вызов.

    • Устранено дублирование WAL-файлов в файлах резервных копий для режима DIRECT с ARCHIVE, что уменьшает размер резервной копии.

    • Добавлен пропуск проверки WAL на архитектуре s390x с соответствующим предупреждением.

    • Добавлена запись времени выполнения команды archive-push в журнал после завершения копирования файла.

    • Добавлено сохранение состояния FUSE-смонтированной резервной копии между перезапусками.

    • Ограничено количество файлов в сообщениях об ошибках для предотвращения переполнения журнала.

    • Изменено отображение сообщений Postgres Pro уровня NOTICE: теперь они отображаются как INFO.

    • Улучшено описание параметра --compress-level в выводе справки (help): добавлены допустимые диапазоны значений для каждого алгоритма сжатия.

    • Улучшено сообщение об ошибке при обнаружении повреждённой страницы в режиме DIRECT: путь к файлу теперь отображается относительно PGDATA.

    • Добавлена информация об объёме WAL-файлов (сжатых и несжатых) в метаданные резервной копии.

A.1. pg_probackup 3.3.0 #

Release date: 2026-04-29

This release is based on pg_probackup3 3.2.1 and provides new features, optimizations and bug fixes. Major changes are as follows:

  • New features:

    • Added partial restore support for Postgres Pro Standard 17 and higher.

    • Added the --waldir option for the restore and catchup commands, and the --wal-archive-dir option for the backup command to specify a separate directory for WAL files.

    • Added the --no-validate-wal option to skip WAL validation during restore.

    • Added the --wal-tree option for the set-config and add-instance commands to store WAL files in subdirectories, optimizing disk space and preventing file system overload.

    • Added recovery target options for the fuse command.

    • Added support for the --exclude-path option in the backup command to exclude specified paths from backup.

    • Improved --batch-size behavior. This option now defaults to the number of threads (--threads) when not explicitly specified.

    • Added the PG_PROBACKUP_MAX_THREADS environment variable to limit the number of worker threads.

    • Added a warning with a clear message when the Postgres Pro version in use is not supported.

  • Bug fixes:

    • Fixed an issue with max_wal_senders in the PRO mode. Previously, when setting -j to 1 in the STREAM mode, the write thread received 0 worker threads and backup failed. Now, when there are insufficient max_wal_senders, an informative message is displayed recommending increasing this value in the postgresql.conf configuration file.

    • Resolved CFS garbage collector (GC) blocking during long backups. GC can now run in parallel with backup.

    • Made the backup command in the DIRECT mode skip temporary and unlogged tables.

    • Fixed a conflict between the --retention-redundancy and --retention-window options used together. Previously, backups that should have been kept according to the redundancy policy could be deleted by the retention window policy. Now, --retention-redundancy takes precedence.

    • Removed the --threads option from the retention command due to inapplicability.

    • Fixed an S3 issue when CURL connection errors (SSL, timeouts, certificates) were ignored, causing the failure to occur later with a non-informative message. Such errors are now detected immediately with the cause specified.

    • Fixed compatibility with S3 buckets that have versioning enabled.

    • Improved S3 compatibility by adding support for virtual-host-style URL and removing the bucket access permission check that was not supported by some providers and could cause connection errors (Amazon AWS S3, SBER Cloud, and others).

    • Fixed handling of empty responses from the libpq library.

    • Fixed an issue with data transfer via SFTP. Incomplete file writes are now correctly detected and terminate the operation with an error instead of silently continuing.

    • Fixed incorrect return code when a Postgres Pro connection error occurs.

    • Fixed hostname resolution for IP addresses in the remote restore utility.

    • Fixed incorrect compression value display in the show command output.

    • Fixed incorrect WAL size display after merge.

    • Fixed WAL file path handling in the archive-push and archive-get commands. Absolute paths are now supported, and relative paths are processed correctly.

    • Made error messages include file names when a file open error occurs.

    • Made operations that modify the backup catalog fail with an error if the catalog belongs to pg_probackup 2.X.

  • Other improvements:

    • Implemented incremental backup of CFS files in the PRO and DIRECT modes.

    • Implemented reading of multiple pages per call in the DIRECT mode.

    • Eliminated WAL file duplication in backup files for the DIRECT mode with ARCHIVE, reducing backup size.

    • Made WAL validation skip on s390x architecture with an appropriate warning.

    • Made the archive-push command log its execution time upon file copy completion.

    • Made the state of a FUSE-mounted backup persist across restarts.

    • Made error messages display a limited number of files to avoid log overflow.

    • Made Postgres Pro NOTICE level messages display as INFO.

    • Improved the --compress-level option description in the help output by adding valid value ranges for each compression algorithm.

    • Improved the error message when a corrupted page is detected in the DIRECT mode. The file path is now displayed relative to PGDATA.

    • Added information about WAL file sizes (compressed and uncompressed) to the backup metadata.

FAQ