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
--waldiroption for therestoreandcatchupcommands, and the--wal-archive-diroption for thebackupcommand to specify a separate directory for WAL files.Added the
--no-validate-waloption to skip WAL validation during restore.Added the
--wal-treeoption for theset-configandadd-instancecommands to store WAL files in subdirectories, optimizing disk space and preventing file system overload.Added recovery target options for the
fusecommand.Added support for the
--exclude-pathoption in thebackupcommand to exclude specified paths from backup.Improved
--batch-sizebehavior. This option now defaults to the number of threads (--threads) when not explicitly specified.Added the
PG_PROBACKUP_MAX_THREADSenvironment 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_sendersin the PRO mode. Previously, when setting-jto1in the STREAM mode, the write thread received 0 worker threads and backup failed. Now, when there are insufficientmax_wal_senders, an informative message is displayed recommending increasing this value in thepostgresql.confconfiguration file.Resolved CFS garbage collector (GC) blocking during long backups. GC can now run in parallel with backup.
Made the
backupcommand in the DIRECT mode skip temporary and unlogged tables.Fixed a conflict between the
--retention-redundancyand--retention-windowoptions used together. Previously, backups that should have been kept according to the redundancy policy could be deleted by the retention window policy. Now,--retention-redundancytakes precedence.Removed the
--threadsoption from theretentioncommand 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
showcommand output.Fixed incorrect WAL size display after merge.
Fixed WAL file path handling in the
archive-pushandarchive-getcommands. 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-pushcommand 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
NOTICElevel messages display asINFO.Improved the
--compress-leveloption description in thehelpoutput 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.