A.1. pg_probackup 3.1.0 #

Release date: 2025-09-25

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

  • New features:

    • Added support for incremental restore via the -I | --incremental-mode option in the PRO mode.

    • Added the --smooth-checkpoint option for the backup command to spread the checkpoint operation over time, allowing processes to complete their work gracefully.

    • Added the --batch-size and --threads options for the archive-push command for multithreaded WAL backup.

    • Added the pgpro_backupstream utility that allows performing restore to a remote host. Note that this utility is currently in beta testing. Some functionality, such as restoring from backups in the ARCHIVE mode and incremental restore, is not yet available.

  • Bug fixes:

    • Fixed an error that occurred when taking a backup without specifying the instance and backup directory parameters.

    • Fixed the display of the STREAM and ARCHIVE WAL delivery modes.

    • Fixed an error that occurred when attempting to back up a cluster with CFS in the BASE mode if shared_preload_libraries was missing from the configuration file.

    • Fixed the display of backup IDs created using pg_probackup 2.X.

    • Fixed the list of available values for the --log_rotation_size option of the set-config command.

    • Fixed connection issues when using the -W | --password option.

  • Other improvements:

    • Added support for databases without data checksums enabled for proper operation with Shardman.

    • Added validation for re-archiving existing WAL files. If a file with the same name exists, the new file is compared to the existing one. If the files differ, the behavior is controlled by the --overwrite option — the file is either overwritten or an error is thrown.

    • Added a restriction preventing the creation of backups with different --backup-source values (BASE, DIRECT, PRO) within a single backup chain.