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.