pg_probackup物理备份与恢复

CREATE ROLE backup WITH LOGIN REPLICATION;
GRANT USAGE ON SCHEMA pg_catalog TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.current_setting(text) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_is_in_recovery() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_start_backup(text, boolean) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_stop_backup() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_create_restore_point(text) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_switch_xlog() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_current() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_current_snapshot() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_snapshot_xmax(txid_snapshot) TO backup;

CREATE ROLE backup WITH LOGIN REPLICATION;
GRANT USAGE ON SCHEMA pg_catalog TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.current_setting(text) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_is_in_recovery() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_start_backup(text, boolean, boolean) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_stop_backup(boolean) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_create_restore_point(text) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_switch_xlog() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_last_xlog_replay_location() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_current() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_current_snapshot() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_snapshot_xmax(txid_snapshot) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_control_checkpoint() TO backup;

CREATE ROLE backup WITH LOGIN REPLICATION;
GRANT USAGE ON SCHEMA pg_catalog TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.current_setting(text) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_is_in_recovery() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_start_backup(text, boolean, boolean) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_stop_backup(boolean, boolean) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_create_restore_point(text) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_switch_wal() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_last_wal_replay_lsn() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_current() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_current_snapshot() TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.txid_snapshot_xmax(txid_snapshot) TO backup;
GRANT EXECUTE ON FUNCTION pg_catalog.pg_control_checkpoint() TO backup;

tar -xzvf pg_probackup.tar.gz
cd pg_probackup
make USE_PGXS=1 pg_config=<path_to_pg_config> top_srcdir=<path_to_postgresql_source_tree>
make USE_PGXS=1 pg_config=<path_to_pg_config> top_srcdir=<path_to_postgresql_source_tree> install
注意：
pg_config 是pg_config程序所在路径
top_srcdir 是postgresql源码所在路径
EG:
make USE_PGXS=1 pg_config=/opt/pg151/bin top_srcdir=/home/pg15/postgresql-15.1
make USE_PGXS=1 pg_config=/opt/pg151/bin top_srcdir=/home/pg15/postgresql-15.1 install

pg_probackup version
显示版本信息

pg_probackup help[command]
显示帮助信息

pg_probackup init -B backup_dir
初始化一个比分目录

pg_probackup add-instance -B backup_dir -D data_dir —instance instance_name

添加一个备份实例（可以添加本地备份实例，也可以添加远程备份实例）

pg_probackup del-instance -B backup_dir —instance instance_name

删除一个备份实例
pg_probackup set-config -B backup_dir —instance instance_name[option…]
pg_probackup set-backup -B backup_dir —instance instance_name -i backup_id[option…]
pg_probackup show-config -B backup_dir —instance instance_name[—format=format]
pg_probackup show -B backup_dir[option…]

显示备份集信息
pg_probackup backup -B backup_dir —instance instance_name -b backup_mode[option…]

执行备份
pg_probackup restore -B backup_dir —instance instance_name[option…]

恢复一个数据库
pg_probackup checkdb -B backup_dir —instance instance_name -D data_dir[option…]
pg_probackup validate -B backup_dir[option…]
校验备份的有效性

pg_probackup merge -B backup_dir —instance instance_name -i backup_id[option…]
pg_probackup delete -B backup_dir —instance instance_name { -i backup_id | —delete-wal | —delete-expired | —merge-expired } [option…]

删除一个备份
pg_probackup archive-push -B backup_dir —instance instance_name —wal-file-path wal_file_path —wal-file-name wal_file_name[option…]
pg_probackup archive-get -B backup_dir —instance instance_name —wal-file-path wal_file_path —wal-file-name wal_file_name[option…]
pg_probackup catchup -b catchup_mode —source-pgdata=path_to_pgdata_on_remote_server —destination-pgdata=path_to_local_dir [option…]fig=/opt/pg151/bin top_srcdir=/home/pg15/postgresql-15.1 install

1、pg_probackup help [COMMAND]

显示帮助命令

2、pg_probackup version

查看pg_probackup版本

3、pg_probackup init -B backup-path

可以在操作系统层面指定BACKUP_PATH，指定都，再次运行该命令则可以省略选项
参数解释
-B，—backup-path 指定数据的备份存储目录【支持环境变量BACKUP_PATH】

[pg15@172 pgsql]$ pg_probackup init -B /data/pgsql/pgbackup/

INFO: Backup catalog ‘/data/pgsql/pgbackup’ successfully inited

—instance=instance_name
[-E external-directory-path]
[—remote-proto] [—remote-host]
[—remote-port] [—remote-path] [—remote-user]
[—ssh-options]
一个备份目录中可以添加多个备份实例，可以是本地备份实例也可以是远程备份实例

参数解释：
-B,—backup-path 指定备份目录
-D,—pgdata 指定数据库目录
—instance 指定备份实例名
-E,—external-dirs 备份时从数据库目录中排出哪些目录不进行备份 EG —external-dirs=/tmp/dir1:/tmp/dir2
远程选项：
—remote-proto 指定远程连接协议，默认SSH 选项：【ssh,none】
—remote-host 指定远程连接的IP【远程postgres主机IP地址】
—remote-port 指定远程连接的端口【远程postgres主机的端口，默认：22】
—remote-path 指定远程主机pg_probackup的路径
—remote-user 指定远程连接的用户名
—ssh-options 其他ssh选项

pg_probackup add-instance -B /archivelog/backup -D /data/pg132 —instance=pg_test
archive_command=’/usr/bin/pg_probackup archive-push -B /archivelog/wal —instance=pg_test —wal-file-path=%p —wal-file-name=%f’
添加远程备份实例[即：在本地服务器上对远程的postgres进行备份]
pg_probackup add-instance -B /archivelog/backup -D /data/pg132 —instance=pg_test_remote —remote-proto=ssh —remote-host=192.168.21.145 —remote-port=22 —remote-path=/usr/bin —remote-user=postgres
archive_command=’/usr/bin/pg_probackup archive-push -B /archivelog/wal —instance=pg_test_remote —wal-file-path=%p —wal-file-name=%f —remote-proto=ssh —remote-host=192.168.21.145 —remote-port=22 —remote-path=/usr/bin —remote-user=postgres’

[pg15@172 pgbackup]$ pg_probackup add-instance -B /data/pgsql/pgbackup/ -D /data/pgsql/151/data/ —instance=probackuptest
INFO: Instance ‘probackuptest’ successfully inited
[pg15@172 pgbackup]$
[pg15@172 pgbackup]$
[pg15@172 pgbackup]$ ls
backups wal
[pg15@172 pgbackup]$ cd backups/
[pg15@172 backups]$ ls
probackuptest

-B,—backup-path 备份存储目录
—instance 指定要删除的备份实例名

[pg15@172 backups]$ pg_probackup del-instance -B /data/pgsql/pgbackup/ —instance probackuptest
INFO: Instance ‘probackuptest’ successfully deleted
[pg15@172 backups]$ ls
[pg15@172 backups]$ ll
total 0

[-D pgdata-path]
[-E external-directories-paths]
[—restore-command=cmdline]
[—log-level-console=log-level-console]
[—log-level-file=log-level-file]
[—log-format-file=log-format-file]
[—log-filename=log-filename]
[—error-log-filename=error-log-filename]
[—log-directory=log-directory]
[—log-rotation-size=log-rotation-size]
[—log-rotation-age=log-rotation-age]
[—retention-redundancy=retention-redundancy]
[—retention-window=retention-window]
[—wal-depth=wal-depth]
[—compress-algorithm=compress-algorithm]
[—compress-level=compress-level]
[—archive-timeout=timeout]
[-d dbname] [-h host] [-p port] [-U username]
[—remote-proto] [—remote-host]
[—remote-port] [—remote-path] [—remote-user]
[—ssh-options]

-B,—backup-path 指定备份目录
—instance 指定备份实例名
-D,—pgdata 指定数据库目录
-E，—external-dirs 排除指定的目录；EG:—external-dirs=/tmp/dir1:/tmp/dir2
—restore-command 用于recovery.conf中的restorecommand；none表示禁用
日志选项：
—log-level-console 控制台日志记录级别：默认info [off error warning info log verbose]
—log-level-file 文件日志记录级别，默认off[默认日志输出到控制台][off error warning info log verbose]
—log-format-file 日志文件记录格式，默认：plain，可选值：plain,json
—log-filename 备份日志文件名默认：pg_probackup.log 支持pg_probackup-%Y-%m-%d%H%M%S.log 这种格式，参考PG日志文件名格式
—error-log-filename 错误日志文件名
—log-directory 备份日志目录，默认$BACKUP_PATH/log
—log-rotation-age 如果文件的期限超过此值，则切换【生成】到下一个文件。默认为0min,0表示一直写入到一个文件中，支持的单位:ms/s/min/h/d
—log-rotation-size 如果日志文件大小超过该值，则切换【生成】到下一个文件。默认为0kB,0表示一直写入到一个文件中，支持的单位:kB/MB/GB/TB

—retention-redundancy 备份保留的天数
—retention-window 备份至少可以恢复到几天内的任意时间点
—wal-depth 能够执行时间点恢复的最新有效备份数；默认0，表示禁用
压缩选项：
—compress 等价与—compress-algorithm=zlib —compress-level=1
—compress-algorithm 数据库压缩类型：zlib,pglz,none,默认：none
—compress-level 压缩级别【0-9】，默认：1
归档选项：
—archive-timeout 等待WAL归档的超时时间（和postgresql中的archive_command不一样，PG中表示超过多长时间后，强制WAL切换）
连接选项：
-U,—pguser 连接数据库的用户
-d,—pgdatabase 连接数据库的默认数据库
-h,—pghost 连接数据库的IP地址
-p,—pgport 连接数据库的端口
远程连接选项：
—remote-proto 指定远程连接协议，默认SSH 选项：【ssh,none】
—remote-host 指定远程连接的IP【远程postgres主机IP地址】
—remote-port 指定远程连接的端口【远程postgres主机的端口，默认：22】
—remote-path 指定远程主机pg_probackup的路径
—remote-user 指定远程连接的用户名
—ssh-options 其他ssh选项
远程WAL归档选项：
—archive-host SSH连接到归档主机的IP或主机名
—archive-port SSH连接到归档主机的端口
—archive-user SSH连接到归档主机的用户
从Standby备份选项【不推荐使用】：
—master-db 指定要连接的主服务器上的数据库名称
—master-host 指定运行主服务器的主机名或IP
—master-port 指定主服务器正在监听的TCP端口或本地UNIX套接字
—master-user 指定连接用户名
—replica-timeout 通过复制进行WAL段流式传输的等待时间。默认300s，单位秒

[pg15@172 ~]$ pg_probackup set-config -B /data/pgsql/pgbackup -D /data/pgsql/151/data —instance probackuptest —log-level-console=INFO —log-level-file=INFO —log-format-file=plain —log-filename=pg_probackup-%a.log —error-log-filename=pg_probackup_error-%a.log —log-directory=/data/pgsql/pgbackup/logs —log-rotation-size=0 —log-rotation-age=1d —compress-algorithm=zlib —compress-level=5 —retention-redundancy=2 —retention-window=2 —archive-timeout=30
[pg15@172 ~]$

-B,—backup-path 备份存储目录
—instance 备份实例名cd
—ttl 指定备份的固定时间，支持单位ms,s,min,h,d默认:s
—expire-time 指定备份过期时间
—note=text 对备份进行文本注释，文本注释大小为1KB

-B，—backup-path 指定备份目录
—instance 指定备份实例名
—format 支持内容输出格式，默认为plain,可选plain,json

[pg15@172 ~]$ pg_probackup show-config -B /data/pgsql/pgbackup/ —instance=probackuptest —format=json
{
“pgdata”: “/data/pgsql/151/data”,
“system-identifier”: “7174282308086276304”,
“xlog-seg-size”: “67108864”,
“pgdatabase”: “postgres”,
“replica-timeout”: “5min”,
“archive-timeout”: “30s”,
“log-level-console”: “INFO”,
“log-level-file”: “INFO”,
“log-format-console”: “PLAIN”,
“log-format-file”: “PLAIN”,
“log-filename”: “pg_probackup-%a.log”,
“error-log-filename”: “pg_probackup_error-%a.log”,
“log-directory”: “/data/pgsql/pgbackup/logs”,
“log-rotation-size”: “0TB”,
“log-rotation-age”: “1d”,
“retention-redundancy”: “2”,
“retention-window”: “2”,
“wal-depth”: “0”,
“compress-algorithm”: “zlib”,
“compress-level”: “5”,
“remote-proto”: “ssh”
}

[—instance=instance_name [-i backup-id]]
[—format=format] [—archive]

该命令用于显示备份集，以及指定实例的备份集

-B,—backup-path 指定备份目录
—instance 指定备份实例名
-i,—backup-id 指定备份集ID
—archive 显示WAL存档信息
—format 结果输出格式：plain或json;默认：plain
—no-color 在控制台中禁用错误和警告消息着色

pg_probackup show -B /data/pgsql/pgbackup/ —instance probackuptest —format plain
Instance Version ID Recovery Time Mode WAL Mode TLI Time Data WAL Zratio Start LSN Stop LSN Status

probackuptest 15 RMZR2F 2022-12-16 10:59:04-05 FULL STREAM 2/0 10s 7618kB 64MB 2.99 0/28000028 0/280001A0 OK
probackuptest 15 RMZQZ7 2022-12-16 10:57:08-05 FULL STREAM 2/0 10s 7607kB 64MB 2.99 0/20000060 0/200001A0 OK

[-D pgdata-path] [-C]
[—stream [-S slot-name] [—temp-slot]]
[—backup-pg-log] [-j num-threads] [—progress]
[—no-validate] [—skip-block-validation]
[—external-dirs=external-directories-paths]
[—no-sync]
[—log-level-console=log-level-console]
[—log-level-file=log-level-file]
[—log-format-console=log-format-console]
[—log-format-file=log-format-file]
[—log-filename=log-filename]
[—error-log-filename=error-log-filename]
[—log-directory=log-directory]
[—log-rotation-size=log-rotation-size]
[—log-rotation-age=log-rotation-age] [—no-color]
[—delete-expired] [—delete-wal] [—merge-expired]
[—retention-redundancy=retention-redundancy]
[—retention-window=retention-window]
[—wal-depth=wal-depth]
[—compress]
[—compress-algorithm=compress-algorithm]
[—compress-level=compress-level]
[—archive-timeout=archive-timeout]
[-d dbname] [-h host] [-p port] [-U username]
[-w —no-password] [-W —password]
[—remote-proto] [—remote-host]
[—remote-port] [—remote-path] [—remote-user]
[—ssh-options]
[—ttl=interval] [—expire-time=timestamp] [—note=text]
[—help]

-B，backup-path 指定备份目录

-b,—backup-mode 备份模式：FULL[完整备份]
DELTA[读取数据目录中的所有数据文件，为自上次备份以来已更改页面创建增量备份]

PAGE[基于自上次执行完整备份或增量备份以来生成的WAL文件创建增量备份。从数据文件中仅读取已更改的块]

TRACK[动态创建增量备份跟踪页面更改]

—instance 备份实例名

-D,—pgdata 数据目录

-C,—smooth-checkpoint 在备份之前执行一次checkpoint

—stream 使用流式备份时一起备份事务日志

-S,—slot 使用的复制槽

—temp-slot 使用临时复制槽

—backup-pg-log 备份PG的log目录

-j,—threads 并行备份的进程数

—progress 显示备份进度

—no-validate 备份结束后，不执行备份校验，需要在备份结束后，手工执行校验

—skip-block-validation 跳过数据块基本校验，仅执行文件解包数据校验
-E,—external-dirs 从数据文件目录中备份时排除指定的目录 EG -E=/tmp/dir1:/tmp/dir2

—no-sync 不将备份文件同步到磁盘

—note=text 为备份添加标签 eg:—node=’backup before app update to v13.1’
日志选项参数解释：

—log-level-console 控制台日志记录级别：默认info [off error warning info log verbose]

—log-level-file 文件日志记录级别，默认off[默认日志输出到控制台][off error warning info log verbose]

—log-format-console 控制台日志输出格式，默认：plain，可选：plain,json

—log-format-file 日志文件内容输出格式，默认：plain，可选：plain，json

—log-filename 备份日志文件名默认：pg_probackup.log 支持pg_probackup-%Y-%m-%d%H%M%S.log 这种格式，参考PG日志文件名格式

—error-log-filename 备份发生错误时的日志文件名

—log-directory 备份日志目录，默认$BACKUP_PATH/log

—log-rotation-age 如果文件的期限超过此值，则切换【生成】到下一个文件。默认为0min,0表示一直写入到一个文件中，支持的单位:ms/s/min/h/d

—log-rotation-size 如果日志文件大小超过该值，则切换【生成】到下一个文件。默认为0kB,0表示一直写入到一个文件中，支持的单位:kB/MB/GB/TB
备份保留策略参数：

—delete-expired 成功完成备份后，根据当前保留策略删除过期备份

—merge-expired 将满足保留策略要求的最旧的增量备份与其已经过期的父级备份合并

—delete-wal 删除不再需要从任何现有备份中还原集群所需的WAL文件

—retention-redundancy 保留的完整备份个数，默认0，所有完整备份都一直保留

—retention-window 可以恢复多少天之前的备份

—wal-depth 每个时间线必须保留执行PITR能力的最新有效备份数;0表示禁用；默认：0

—dry-run 尝试运行备份，不作任何修改

—ttl=interval 如果需要的将某些备份保留的时间超过已建立的保留策略所允许的时间，则可以将其固定任意时间，取消固定备份，将其设置为0

—expire-time 指定备份的到期时间
备份压缩选项参数：

—compress 等价于—compress-algorithm=’zlib’ —compress-level=1

—compress-algorithm 指定备份压缩方式，zlib,pglz,none 默认：none

—compress-level 指定备份压缩级别[0-9]默认1

—archive-timeout WAL归档超时时间，定义的时，WAL归档到备份目录的超时时间
数据连接参数：

-U,—pguser 连接数据库的用户

-d,—pgdatabase 要连接的数据库

-h,—pghost 要连接的IP或SOCKET

-p,—pgport 数据库端口，默认5432

-w,—no-password 不提示输入密码

-W,—password 强制提示输入密码

—remote-proto 使用的远程连接协议，默认ssh 选项：[ssh、none]

—remote-host 远程主机地址或主机名

—remote-port 远程主机端口，默认22

—remote-path 远程主机上pg_probackup的路径

—remote-user 远程主机SSH连接的用户名

—ssh-options 其他的SSH连接选项，默认为NONE

—master-db 指定要连接的主服务器上的数据库名称

—master-host 指定运行主服务器的主机名或IP

—master-port 指定主服务器正在监听的TCP端口或本地UNIX套接字

—master-user 指定连接用户名

—replica-timeout 通过复制进行WAL段流式传输的等待时间。默认300s，单位秒

pg_probackup backup -B /archivelog/backup —instance=pg_test -b full -D /data/pg132 -j 8 -h 127.0.0.1 -p 5432 -d postgres -U backup
pg_probackup backup -B /archivelog/backup —instance=pg_test -b full -D /data/pg132 —stream —temp-slot —compress-algorithm=zlib —compress-level=5 —progress —threads 8 -h 127.0.0.1 -p 5432 -d postgres -U backup -W

pg_probackup backup -B /archivelog/backup —instance=pg_test -b delta -D /data/pg132 -j 8 —compress-algorithm=zlib —compress-level=5 -h 127.0.0.1 -p 5432 -d postgres -U postgres

 —remote-host=192.168.21.145 —remote-port=22 —remote-user=postgre

[pg15@172 probackuptest]$ pgprobackup backup -B /data/pgsql/pgbackup —instance=probackuptest -b full -D /data/pgsql/151/data -C —backup-pg-log -j 2 —stream —log-level-console=info —log-level-file=info —log-format-file=plain —log-filename=pg_probackup%a.log —error-log-file=pgprobackup_error%a.log —log-directory=/data/pgsql/pgbackup/logs —log-rotation-size=0 —log-rotation-age=1d —delete-expired —merge-expired —delete-wal —retention-redundancy=2 —retention-window=2 —compress -U postgres -h 127.0.0.1 -p 5432 -d postgres
INFO: Backup start, pg_probackup version: 2.5.11, instance: probackuptest, backup ID: RMZR2F, backup mode: FULL, wal mode: STREAM, remote: false, compress-algorithm: zlib, compress-level: 5
INFO: This PostgreSQL instance was initialized with data block checksums. Data block corruption will be detected
WARNING: Current PostgreSQL role is superuser. It is not recommended to run pg_probackup under superuser.
INFO: Database backup start
INFO: wait for pg_backup_start()
INFO: Wait for WAL segment /data/pgsql/pgbackup/backups/probackuptest/RMZR2F/database/pg_wal/00000002000000000000000A to be streamed
INFO: PGDATA size: 22MB
INFO: Current Start LSN: 0/28000028, TLI: 2
INFO: Start transferring data files
INFO: Data files are transferred, time elapsed: 0
INFO: wait for pg_stop_backup()
INFO: pg_stop backup() successfully executed
INFO: stop_lsn: 0/280001A0
INFO: Getting the Recovery Time from WAL
INFO: Syncing backup files to disk
INFO: Backup files are synced, time elapsed: 0
INFO: Validating backup RMZR2F
INFO: Backup RMZR2F data files are valid
INFO: Backup RMZR2F resident size: 71MB
INFO: Backup RMZR2F completed
INFO: Evaluate backups by retention
INFO: Backup RMZR2F, mode: FULL, status: OK. Redundancy: 1/2, Time Window: 0d/2d. Active
INFO: Backup RMZQZ7, mode: FULL, status: OK. Redundancy: 2/2, Time Window: 0d/2d. Active
INFO: Retention merging finished
INFO: Nothing to remove on timeline 2
INFO: There are no backups to merge by retention policy
INFO: There are no backups to delete by retention policy
INFO: There is no WAL to purge by retention policy

[-D pgdata-path] [-i backup-id] [-j num-threads]
[—progress] [—force] [—no-sync]
[—no-validate] [—skip-block-validation]
[-T OLDDIR=NEWDIR]
[—external-mapping=OLDDIR=NEWDIR]
[—skip-external-dirs]
[-X WALDIR | —waldir=WALDIR]
[-I | —incremental-mode=none|checksum|lsn]
[—db-include dbname | —db-exclude dbname]
[—recovery-target-time=time|—recovery-target-xid=xid
|—recovery-target-lsn=lsn [—recovery-target-inclusive=boolean]]
[—recovery-target-timeline=timeline]
[—recovery-target=immediate|latest]
[—recovery-target-name=target-name]
[—recovery-target-action=pause|promote|shutdown]
[—restore-command=cmdline]
[-R | —restore-as-replica]
[—primary-conninfo=primary_conninfo]
[-S | —primary-slot-name=slotname]
[—remote-proto] [—remote-host]
[—remote-port] [—remote-path] [—remote-user]
[—ssh-options]
[—archive-host=hostname] [—archive-port=port]
[—archive-user=username]

-B,—backup-path 指定备份路径
—instance 指定实例名
-D,—pgdata 指定数据恢复到的目录
-i,—backup-id 指定备份ID
-j,—num-threads 指定数据恢复的并行度
—progress 现实备份进度
—force 强制恢复，忽略还原备份文件的状态
—no-sync 不将恢复的文件同步到磁盘
—no-validate 在恢复过程中不执行校验
—skip-block-validate 跳过数据块校验，使用文件校验代替
-T,—tablespace-map=OLDDIR=NEWDIR 将表空间目录从OLDDIR替换为NEWDIR
—external-mapping=OLDDIR=NEWDIR 在恢复时，将备份中包含的外部目录从OLDDIR迁移到NEWDIR目录，双方的目录都必须是绝对路径，如果路径中包含（=），请使用反斜线对其进行转义
—skip-external-dirs=/tmp/t1,/tmp/t2 不恢复指定的目录
-X,—waldir

-I,—increment-mode=none|checksum|lsn 如果PGDATA中的数据页有效，则重用；默认职位none
部分还原参数：
—db-include dbname 只恢复指定的数据库
—db-exclude dbname 不恢复指定的数据库
恢复目标参数：
—recovery-target-time 恢复到指定的时间点
—recovery-target-xid 恢复到指定的XID
—recovery-target-lsn 恢复到指定的LSN
—recovery-target-inclusive 指定是否包含恢复的位置
—recovery-target-timeline 恢复到指定的时间线
—recovery-target=immediate|latest 一旦恢复达到一致性状态，则尽可能地结束恢复
—recovery-target-name 恢复到指定名字的还原点
—recovery-target-action 恢复到指定的位置后的工作，默认pause；选项[pause/promote/shutdown]
—restore-command 恢复命令

-R,—restore-as-replica 恢复作为一个standby
—primary-conninfo 设置standby链接到master的连接信息
-S,—primary-slot-name=slotname 指定流复制使用的插槽名称
日志参数选项：
—log-level-console 控制台日志记录级别：默认info [off error warning info log verbose]
—log-level-file 文件日志记录级别，默认off[默认日志输出到控制台][off error warning info log verbose]
—log-format-console 控制台日志输出格式，默认：plain，可选：plain,json
—log-format-file 日志文件内容输出格式，默认：plain，可选：plain，json
—log-filename 备份日志文件名默认：pg_probackup.log 支持pg_probackup-%Y-%m-%d%H%M%S.log 这种格式，参考PG日志文件名格式
—error-log-filename 恢复数据库时的错误日志文件名
—log-directory 备份日志目录，默认$BACKUP_PATH/log
—log-rotation-age 如果文件的期限超过此值，则切换【生成】到下一个文件。默认为0min,0表示一直写入到一个文件中，支持的单位:ms/s/min/h/d
—log-rotation-size 如果日志文件大小超过该值，则切换【生成】到下一个文件。默认为0kB,0表示一直写入到一个文件中，支持的单位:kB/MB/GB/TB
—no-color 在控制台中禁用错误和警告消息着色

—remote-prote=ssh 默认ssh [ssh,none]
—remote-host 远程主机IP
—remote-port 远程主机port
—remote-path 远程主机上pg_probackup的路径
—remote-user 连接远程主机的用户名
—ssh-options
远程WAL归档选项：
—archive-host 提供命令中—remote-host选项的参数archive-get
—archive-port 提供命令中—remote-port选项的参数archive-get，默认22
—archive-user 提供命令中—remote-user选项的参数archive-get。默认postgres;如果省略，则是启动postgresql的用户

测试：
postgres=# create table t1(id int);
CREATE TABLE
postgres=# insert into t1 select 1;
INSERT 0 1
postgres=# insert into t1 select 2;
INSERT 0 1
postgres=# insert into t1 select 3;
INSERT 0 1
postgres=# insert into t1 select 4;
INSERT 0 1
postgres=# insert into t1 select 5;
INSERT 0 1
postgres=# insert into t1 select 6;
INSERT 0 1
postgres=# insert into t1 select 7;
INSERT 0 1
postgres=# insert into t1 select 8;
INSERT 0 1
postgres=# insert into t1 select 9;
INSERT 0 1
postgres=# insert into t1 select 10;
INSERT 0 1
postgres=#
postgres=#
postgres=# select now();

              now              

2022-12-17 21:14:06.037117+08
(1 row)

postgres=#
postgres=#
postgres=# delete from t1;
DELETE 10
postgres=# select pg_switch_wal();
pg_switch_wal

0/300075E0
(1 row)

postgres=# select pg_switch_wal();
pg_switch_wal

0/34000078
(1 row)

postgres=# select pg_switch_wal();
pg_switch_wal

0/38000000
(1 row)

postgres=# select pg_switch_wal();
pg_switch_wal

0/38000000
(1 row)

[pg15@172 newdata]$ pg_probackup restore -B /data/pgsql/dbbackup —instance pgtest -D /data/pgsql/newdata -i RN1E1Q -j 2 —recovery-target-time=’2022-12-17 21:13:58’ —recovery-target-inclusive=true
INFO: Validating backup RN1E1Q
INFO: Backup RN1E1Q data files are valid
INFO: Backup validation completed successfully on time 2022-12-17 21:14:06+08, xid 793 and LSN 0/F0000290
INFO: Backup RN1E1Q is valid.
INFO: Restoring the database from backup at 2022-12-17 21:13:02+08
INFO: Start restoring backup files. PGDATA size: 22MB
INFO: Backup files are restored. Transfered bytes: 22MB, time elapsed: 0
INFO: Restore incremental ratio (less is better): 100% (22MB/22MB)
INFO: Syncing restored files to disk
INFO: Restored backup files are synced, time elapsed: 0
INFO: Restore of backup RN1E1Q completed.
[pg15@172 newdata]$ pg_ctl start -D /data/pgsql/newdata/
waiting for server to start….2022-12-17 21:18:09.935 CST ProcessStartTime=2022-12-17 21:18:09 CST,ProcessID=1418,ProcessType=postmaster,user=,client=,app= LOG: redirecting log output to logging collector process
2022-12-17 21:18:09.935 CST ProcessStartTime=2022-12-17 21:18:09 CST,ProcessID=1418,ProcessType=postmaster,user=,client=,app= HINT: Future log output will appear in directory “log”.
done
server started
[pg15@172 newdata]$ psql
psql (15.1)
Type “help” for help.

postgres=# \d
List of relations
Schema | Name | Type | Owner
————+———+———-+—————
public | t1 | table | postgres
(1 row)

postgres=# \d+
List of relations
Schema | Name | Type | Owner | Persistence | Access method | Size | Description
————+———+———-+—————+——————-+———————-+——————+——————-
public | t1 | table | postgres | permanent | heap | 8192 bytes |
(1 row)

1
2
3
4
5
6
7
8
9
10
(10 rows)

[-D pgdata-path] [-j num-threads] [—progress]

[—amcheck] [—skip-block-validation]

[—heapallindexed] [—checkunique]

-B,—backup-path 指定备份存储目录
—instance 指定备份实例的名称
-D,—pgdata 指定数据库目录
—progress 显示进度
-j,—threads 并行线程数
—skip-block-validation 跳过文件级别数据快校验
—amcheck 如果在检查数据文件时未发现损坏，则对PostgreSQL实例执行索引的逻辑验证。您必须在数据库中安装amcheck或amchecknext扩展才能检查其索引。对于没有amcheck的数据库，将跳过索引验证
—heapallindexed 通过检查所有应建立索引的堆元组是否已经实际建立索引，可以使用该标志进行更彻底的逻辑验证，但是会增CPU、MEM和I/O消耗
—checkunique

—log-level-console 控制台日志记录级别：默认info [off error warning info log verbose]
—log-level-file 文件日志记录级别，默认off[默认日志输出到控制台][off error warning info log verbose]
—log-format-console 控制台日志输出格式，默认：plain，可选：plain,json
—log-format-file 日志文件内容输出格式，默认：plain，可选：plain，json
—log-filename 备份日志文件名默认：pg_probackup.log 支持pg_probackup-%Y-%m-%d%H%M%S.log 这种格式，参考PG日志文件名格式
—error-log-filename 恢复数据库时的错误日志文件名
—log-directory 备份日志目录，默认$BACKUP_PATH/log
—log-rotation-age 如果文件的期限超过此值，则切换【生成】到下一个文件。默认为0min,0表示一直写入到一个文件中，支持的单位:ms/s/min/h/d
—log-rotation-size 如果日志文件大小超过该值，则切换【生成】到下一个文件。默认为0kB,0表示一直写入到一个文件中，支持的单位:kB/MB/GB/TB
—no-color 在控制台中禁用错误和警告消息着色

-U,—pguser 连接数据库的用户
-d,—pgdatabase 连接指定的数据库
-h,—pghost 数据库主机IP
-p,—pgport 数据库端口号
-w,—no-password 连接数据库时不显示提示输入密码
-W,—password 连接数据库时提示输入密码

[-i backup-id] [—progress] [-j num-threads]
[—recovery-target-time=time|—recovery-target-xid=xid
|—recovery-target-lsn=lsn [—recovery-target-inclusive=boolean]]
[—recovery-target-timeline=timeline]
[—recovery-target-name=target-name]
[—skip-block-validation]

-B,—backup-path 指定备份存储目录
—instance 指定备份实例名
-i,—backup-id 指定具体的备份集ID
—progress 显示校验进度
-j,—threads 校验并行线程数
—recovery-target-time 指定恢复到的时间点
—recovery-target-xid 指定恢复到的XID
—recovery-target-lsn 指定恢复到的LSN
—recovery-target-inclusive 是否包含恢复到时间点、XID、LSN
—recovery-target-timeline 指定恢复到的时间线
—recovery-target-name 恢复到指定的还原点
—skip-block-validation 跳过文件级别数据快校验

—log-level-console 控制台日志记录级别：默认info [off error warning info log verbose]
—log-level-file 文件日志记录级别，默认off[默认日志输出到控制台][off error warning info log verbose]
—log-format-console 控制台日志输出格式，默认：plain，可选：plain,json
—log-format-file 日志文件内容输出格式，默认：plain，可选：plain，json
—log-filename 备份日志文件名默认：pgprobackup.log 支持pg_probackup-%Y-%m-%d%H%M%S.log 这种格式，参考PG日志文件名格式
—error-log-filename 恢复数据库时的错误日志文件名
—log-directory 备份日志目录，默认$BACKUP_PATH/log
—log-rotation-age 如果文件的期限超过此值，则切换【生成】到下一个文件。默认为0min,0表示一直写入到一个文件中，支持的单位:ms/s/min/h/d
—log-rotation-size 如果日志文件大小超过该值，则切换【生成】到下一个文件。默认为0kB,0表示一直写入到一个文件中，支持的单位:kB/MB/GB/TB
—no-color 在控制台中禁用错误和警告消息着色

[pg15@172 pgsql]$ pg_probackup validate -B /data/pgsql/dbbackup —instance pgtest
INFO: Validate backups of the instance ‘pgtest’
INFO: Validating backup RN1E1Q
INFO: Backup RN1E1Q data files are valid
INFO: Backup RN1E1Q WAL segments are valid
INFO: Validating backup RN024R
INFO: Backup RN024R data files are valid
INFO: Backup RN024R WAL segments are valid
INFO: All backups are valid

[pg15@172 pgsql]$ pg_probackup validate -B /data/pgsql/dbbackup —instance pgtest —recovery-target-time=’2022-12-17 21:13:58’
INFO: Validating backup RN1E1Q
INFO: Backup RN1E1Q data files are valid
INFO: Backup validation completed successfully on time 2022-12-17 21:14:06+08, xid 793 and LSN 0/F0000290
INFO: Backup RN1E1Q is valid.
INFO: Validate of backup RN1E1Q completed.

[pg15@172 pgsql]$ pg_probackup validate -B /data/pgsql/dbbackup —instance pgtest -i RN1E1Q
INFO: Validating backup RN1E1Q
INFO: Backup RN1E1Q data files are valid
INFO: Backup RN1E1Q WAL segments are valid
INFO: Backup RN1E1Q is valid.
INFO: Validate of backup RN1E1Q completed.

[pg15@172 pgsql]$ pg_probackup validate -B /data/pgsql/dbbackup —instance pgtest —recovery-target-time=’2022-12-17 21:13:58’ -i RN1E1Q
INFO: Validating backup RN1E1Q
INFO: Backup RN1E1Q data files are valid
INFO: Backup validation completed successfully on time 2022-12-17 21:14:06+08, xid 793 and LSN 0/F0000290
INFO: Backup RN1E1Q is valid.
INFO: Validate of backup RN1E1Q completed.

[—no-validate] [—no-sync]
[—log-level-console=log-level-console]
[—log-level-file=log-level-file]
[—log-format-console=log-format-console]
[—log-format-file=log-format-file]
[—log-filename=log-filename]
[—error-log-filename=error-log-filename]
[—log-directory=log-directory]
[—log-rotation-size=log-rotation-size]
[—log-rotation-age=log-rotation-age]

-B,—backup-path 指定备份存储目录

—instance 指定备份实例名

-i,—backup-id 指定备份集ID

-j,—threads 并行运行的线程数

—progress 显示merge的进度

—no-validate 在保留合并期间禁用校验

—no-sync 不同步merge的文件到磁盘

—log-level-console 控制台日志记录级别：默认info [off error warning info log verbose]

—log-level-file 文件日志记录级别，默认off[默认日志输出到控制台][off error warning info log verbose]

—log-format-console 控制台日志输出格式，默认：plain，可选：plain,json

—log-format-file 日志文件内容输出格式，默认：plain，可选：plain，json

—log-filename 备份日志文件名默认：pgprobackup.log 支持pg_probackup-%Y-%m-%d%H%M%S.log 这种格式，参考PG日志文件名格式

—error-log-filename 恢复数据库时的错误日志文件名

—log-directory 备份日志目录，默认$BACKUP_PATH/log

—log-rotation-age 如果文件的期限超过此值，则切换【生成】到下一个文件。默认为0min,0表示一直写入到一个文件中，支持的单位:ms/s/min/h/d

—log-rotation-size 如果日志文件大小超过该值，则切换【生成】到下一个文件。默认为0kB,0表示一直写入到一个文件中，支持的单位:kB/MB/GB/TB

—no-color 在控制台中禁用错误和警告消息着色

EG:pg_probackup merge -B /archivelog/backup —instance=pg_test -i backup_id

[-i backup-id | —delete-expired | —merge-expired] [—delete-wal]
[-j num-threads] [—progress]
[—retention-redundancy=retention-redundancy]
[—retention-window=retention-window]
[—wal-depth=wal-depth]
[—no-validate] [—no-sync]

-B,—backup-path 指定备份文件存储目录
—instance 指定备份实例名
-i,—backup-id 指定备份集ID
-j,—threads 删除备份的并行线程数
—progress 显示删除备份的进度
—no-validate 在保留合并期间禁用校验
—no-sync 不同步merge的文件到磁盘

—delete-expired 根据当前的备份保留策略删除过期的备份
—merge-expired 根据当前的备份保留策略合并过期的备份
—delete-wal 从WAL归档中删除冗余的WAL
—retention-redundancy 保留几个全量备份；0表示全部保持。默认：0
—retention-windows 备份可以回到几天内的任意时间点
—wal-depth 每个时间线必须保留执行PITR能力的最新有效备份的数量
—dry-run 在没有任何更改的情况下，试运行
—status 删除指定备份状态的所有备份

—log-level-console 控制台日志记录级别：默认info [off error warning info log verbose]
—log-level-file 文件日志记录级别，默认off[默认日志输出到控制台][off error warning info log verbose]
—log-format-console 控制台日志输出格式，默认：plain，可选：plain,json
—log-format-file 日志文件内容输出格式，默认：plain，可选：plain，json
—log-filename 备份日志文件名默认：pgprobackup.log 支持pg_probackup-%Y-%m-%d%H%M%S.log 这种格式，参考PG日志文件名格式
—error-log-filename 恢复数据库时的错误日志文件名
—log-directory 备份日志目录，默认$BACKUP_PATH/log
—log-rotation-age 如果文件的期限超过此值，则切换【生成】到下一个文件。默认为0min,0表示一直写入到一个文件中，支持的单位:ms/s/min/h/d
—log-rotation-size 如果日志文件大小超过该值，则切换【生成】到下一个文件。默认为0kB,0表示一直写入到一个文件中，支持的单位:kB/MB/GB/TB
—no-color 在控制台中禁用错误和警告消息着色

[pg15@172 pgsql]$ pg_probackup show
BACKUP INSTANCE ‘pgtest’
Instance Version ID Recovery Time Mode WAL Mode TLI Time Data WAL Zratio Start LSN Stop LSN Status

pgtest 15 RN1E1Q 2022-12-17 21:13:04+08 FULL ARCHIVE 2/0 3s 7796kB 64MB 2.91 0/E4000060 0/E80000B8 OK
pgtest 15 RN024R 2022-12-17 03:58:04+08 FULL ARCHIVE 2/0 2s 7796kB 64MB 2.91 0/C8000028 0/CC0000F0 OK
[pg15@172 pgsql]$ pg_probackup delete -B /data/pgsql/dbbackup/ —instance pgtest
ERROR: You must specify at least one of the delete options: —delete-expired |—delete-wal |—merge-expired |—status |(-i, —backup-id)
[pg15@172 pgsql]$ pg_probackup delete -B /data/pgsql/dbbackup/ —instance pgtest —delete-expired —delete-wal
WARNING: Retention policy is not set
INFO: On timeline 2 WAL segments between 000000020000000000000021 and 000000020000000000000032 will be removed
INFO: Logical WAL size to remove on timeline 2 : 1088MB
INFO: Resident WAL size to free on timeline 2 : 4866kB
INFO: There are no backups to merge by retention policy
INFO: There are no backups to delete by retention policy

[pg15@172 pgsql]$ pg_probackup delete -i RN024R —instance pgtest
INFO: Resident data size to free by delete of backup RN024R : 7796kB
INFO: Delete: RN024R 2022-12-17 03:58:04+08
[pg15@172 pgsql]$ pg_probackup show
BACKUP INSTANCE ‘pgtest’
Instance Version ID Recovery Time Mode WAL Mode TLI Time Data WAL Zratio Start LSN Stop LSN Status

pgtest 15 RN1E1Q 2022-12-17 21:13:04+08 FULL ARCHIVE 2/0 3s 7796kB 64MB 2.91 0/E4000060 0/E80000B8 OK
[pg15@172 pgsql]$

—wal-file-name=wal-file-name
[—wal-file-path=wal-file-path]
[-j num-threads] [—batch-size=batch_size]
[—archive-timeout=timeout]
[—no-ready-rename] [—no-sync]
[—overwrite] [—compress]
[—compress-algorithm=compress-algorithm]
[—compress-level=compress-level]
[—remote-proto] [—remote-host]
[—remote-port] [—remote-path] [—remote-user]
[—ssh-options]

-B,—backup-path 指定备份存储目录
—instance 指定备份实例的名称
—wal-file-name 复制到归档目录的文件名称
—wal-file-path WAL归档的相对目标路径
-j,—threads 并行归档的线程数
—batch-size 为了加快归档速度，该选项可以指定大小进行批量复制WAL段
—archive-timeout wal归档超时时间
—no-ready-rename 不重命名archive_status目录下的”.ready”文件
—no-sync 不同步WAL文件到磁盘
—overwrite 覆盖写归档的WAL文件

—compress 等价与—compress-algorithm=zlib —compress-level=1
—compress-algorithm 压缩算法：zlib,pglz,none 默认：zlib
—compress-level 压缩级别：0-9；默认：1

—remote-prote=ssh 默认ssh [ssh,none]
—remote-host 远程主机IP
—remote-port 远程主机port
—remote-path 远程主机上pg_probackup的路径
—remote-user 连接远程主机的用户名
—ssh-options

—wal-file-name=wal-file-name
[—wal-file-path=wal-file-path]
[-j num-threads] [—batch-size=batch_size]
[—no-validate-wal]
[—remote-proto] [—remote-host]
[—remote-port] [—remote-path] [—remote-user]
[—ssh-options]

-B,—backup-path 指定备份存储目录
—instance 指定备份实例的名称
—wal-file-name 复制到归档目录的文件名称
—wal-file-path WAL归档的相对目标路径
-j,—threads 并行归档的线程数
—batch-size 为了加快归档速度，该选项可以指定大小进行批量复制WAL段

—prefetch-dir 存储预取WAL文件的位置

—no-validate-wal 在使用预取的WAL之前跳过校验

—remote-prote=ssh 默认ssh [ssh,none]
—remote-host 远程主机IP
—remote-port 远程主机port
—remote-path 远程主机上pg_probackup的路径
—remote-user 连接远程主机的用户名
—ssh-options

—source-pgdata=path_to_pgdata_on_remote_server
—destination-pgdata=path_to_local_dir
[—stream [-S slot-name]] [—temp-slot | —perm-slot]
[-j num-threads]
[-T OLDDIR=NEWDIR]
[—exclude-path=path_prefix]
[-d dbname] [-h host] [-p port] [-U username]
[-w —no-password] [-W —password]
[—remote-proto] [—remote-host]
[—remote-port] [—remote-path] [—remote-user]
[—ssh-options]
[—dry-run]
[—help]

-b,—backup-mode catchup的模式：FULL｜DELTA｜PTRACK
—stream 流式传输事务日志（只支持该模式）
-S,—slot 使用的复制槽名称
—temp-slot 是否使用临时复制槽
-P,—perm-slot 是否创建永久复制槽
-j,—threads catchup使用的并行线程数
-T,—tablespace-mapping=OLDDIR=NEWDIR 将表空间从目录OLDDIR重新定位到NEWDIR
-x,—exclude-path=path_prefix 具有path_prefix（相对于pgdata）的文件将被排除在catchup之外（可以多次使用）危险选项！使用风险自负

-U,—pguser 连接数据库的用户
-d,—pgdatabase 连接指定的数据库
-h,—pghost 数据库主机IP
-p,—pgport 数据库端口号
-w,—no-password 连接数据库时不显示提示输入密码
-W,—password 连接数据库时提示输入密码

—remote-prote=ssh 默认ssh [ssh,none]
—remote-host 远程主机IP
—remote-port 远程主机port
—remote-path 远程主机上pg_probackup的路径
—remote-user 连接远程主机的用户名
—ssh-options SSH连接使用的其他选项
—dry-run 在没有任何更改的情况下，试运行

点击此处阅读原文

↓↓↓