openGauss数据库源码解析系列文章——备份恢复机制：openGauss增量备份技术（上）_opengauss 备份命令(1)

一、Python所有方向的学习路线

Python所有方向的技术点做的整理，形成各个领域的知识点汇总，它的用处就在于，你可以按照下面的知识点去找对应的学习资源，保证自己学得较为全面。

二、Python必备开发工具

工具都帮大家整理好了，安装就可直接上手！

三、最新Python学习笔记

当我学到一定基础，有自己的理解能力的时候，会去阅读一些前辈整理的书籍或者手写的笔记资料，这些笔记详细记载了他们对一些技术点的理解，这些理解是比较独到，可以学到不一样的思路。

四、Python视频合集

观看全面零基础学习视频，看视频学习是最快捷也是最有效果的方式，跟着视频中老师的思路，从基础到深入，还是很容易入门的。

五、实战案例

纸上得来终觉浅，要学会跟着视频一起敲，要动手实操，才能将自己的所学运用到实际当中去，这时候可以搞点实战案例来学习。

六、面试宝典

简历模板

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

（5） 在备份路径backup-path内删除指定实例相关的备份内容，代码如下：

gs_probackup del-instance -B backup-path --instance=instance_name
[--help]

处理函数为do_delete_instance。

（6） 将指定的连接、压缩、日志等相关设置添加到pg_probackup.conf配置文件中，或修改已设置的值，不要手动编辑pg_probackup.conf配置文件。代码如下：

gs_probackup set-config -B backup-path --instance=instance_name
[-D pgdata-path] [-E external-directories-paths] [--restore-command=cmdline] [--archive-timeout=timeout]
[--retention-redundancy=retention-redundancy] [--retention-window=retention-window] [--wal-depth=wal-depth]
[--compress-algorithm=compress-algorithm] [--compress-level=compress-level]
[-d dbname] [-h hostname] [-p port] [-U username]
[logging_options] [remote_options]
[--help]

处理函数为do_set_config。

（7） 将备份相关设置添加到backup.control配置文件中，或修改已设置的值。代码如下：

gs_probackup set-backup -B backup-path --instance=instance_name -i backup-id
[--note=text] [pinning_options]
[--help]

处理函数为do_set_backup。

（8） 显示位于备份目录中的pg_probackup.conf配置文件的内容。可以通过指定–format=json选项，以json格式显示。默认情况下，显示为纯文本格式，代码如下：

gs_probackup show-config -B backup-path --instance=instance_name
[--format=plain|json]
[--help]

处理函数为do_show_config。

（9） 显示备份目录的内容。如果指定了instance_name和backup_id，则显示该备份的详细信息。可以通过指定–format=json选项，以json格式显示。默认情况下，备份目录的内容显示为纯文本格式，代码如下：

gs_probackup show -B backup-path
[--instance=instance_name [-i backup-id]] [--archive] [--format=plain|json]
[--help]

处理函数为do_show。

（10） 创建指定实例的备份，代码如下：

gs_probackup backup -B backup-path --instance=instance_name -b backup-mode
[-D pgdata-path] [-C] [-S slot-name] [--temp-slot] [--backup-pg-log] [-j threads_num] [--progress]
[--no-validate] [--skip-block-validation] [-E external-directories-paths] [--no-sync] [--note=text]
[--archive-timeout=timeout]
[logging_options] [retention_options] [compression_options]
[connection_options] [remote_options] [pinning_options]
[--help]

处理函数为do_backup。

（11） 从备份目录backup-path中的备份副本恢复指定实例。如果指定了恢复目标选项，gs_probackup将查找最近的备份并将其还原到指定的恢复目标。否则，使用最近一次备份，代码如下：

gs_probackup restore -B backup-path --instance=instance_name
[-D pgdata-path] [-i backup_id] [-j threads_num] [--progress] [--force] [--no-sync] [--no-validate] [--skip-block-validation]
[--external-mapping=OLDDIR=NEWDIR] [-T OLDDIR=NEWDIR] [--skip-external-dirs] [-I incremental_mode]
[recovery_options] [remote_options] [logging_options]
[--help]

处理函数为do_restore_or_validate。

（12） 将指定的增量备份与其父完全备份之间的所有增量备份合并到父完全备份。父完全备份将接收所有合并的数据，而已合并的增量备份将作为冗余被删除。代码如下：

gs_probackup merge -B backup-path --instance=instance_name -i backup_id
[-j threads_num] [--progress] [logging_options]
[--help]

处理函数为do_merge。

（13） 删除指定备份，或删除不满足当前保留策略的备份，代码如下：

gs_probackup delete -B backup-path --instance=instance_name
[-i backup-id | --delete-expired | --merge-expired | --status=backup_status]
[--delete-wal] [-j threads_num] [--progress]
[--retention-redundancy=retention-redundancy] [--retention-window=retention-window]
[--wal-depth=wal-depth] [--dry-run]
[logging_options]
[--help]

处理函数为do_delete，do_retention和do_delete_status。

（14） 验证恢复数据库所需的所有文件是否存在且未损坏。如果未指定instance_name，gs_probackup将验证备份目录中的所有可用备份。如果指定instance_name而不指定任何附加选项，gs_probackup将验证此备份实例的所有可用备份。如果指定了instance_name并且指定backup-id或恢复目标相关选项，gs_probackup将检查是否可以使用这些选项恢复数据库。代码如下：

gs_probackup validate -B backup-path
[--instance=instance_name] [-i backup-id]
[-j threads_num] [--progress] [--skip-block-validation]
[--recovery-target-time=time | --recovery-target-xid=xid | --recovery-target-lsn=lsn | --recovery-target-name=target-name]
[--recovery-target-inclusive=boolean] [--recovery-target-timeline=timeline]
[logging_options]
[--help]

处理函数为do_validate_all和do_restore_or_validate。

gs_probackup在执行各个子命令处理函数之前，需要解析各个命令的命令行参数，gs_probackup支持的命令行参数如表1所示。

表1  命令行参数

参数	类别	描述
Command	通用参数	gs_probackup除version和help以外的子命令：init、add-instance、del-instance、set-config、set-backup、show-config、show、backup、restore、merge、delete、validate
-?, --help	通用参数	显示gs_probackup命令行参数的帮助信息，然后退出。子命令中只能使用–help，不能使用-?
-V, --version	通用参数	打印gs_probackup版本，然后退出
-B backup-path, --backup-path=backup-path	通用参数	备份的路径。 系统环境变量：$BACKUP_PATH
-D pgdata-path, --pgdata=pgdata-path	通用参数	数据目录的路径。 系统环境变量：$PGDATA
–instance =instance_name	通用参数	实例名
-i backup-id, --backup-id=backup-id	通用参数	备份的唯一标识
–format=format	通用参数	指定显示备份信息的格式，支持plain和json格式。 默认值：plain
–status =backup_status	通用参数	删除指定状态的所有备份
-j threads_num, --threads=threads_num	通用参数	设置备份、还原、合并进程的并行线程数
–archive	通用参数	显示WAL归档信息
–progress	通用参数	显示进度
–note=text	通用参数	给备份添加note
-b backup-mode, --backup-mode=backup-mode	备份参数	指定备份模式，支持FULL和PTRACK。 FULL：创建全量备份，全量备份包含所有数据文件 PTRACK：创建PTRACK增量备份
-C, --smooth-checkpoint	备份参数	将检查点在一段时间内完成。默认情况下，gs_probackup会尝试尽快完成检查点
-S slot-name, --slot=slot-name	备份参数	指定WAL流处理的复制槽
–temp-slot	备份参数	在备份的实例中为WAL流处理创建一个临时物理复制槽，它确保在备份过程中，所有所需的WAL段仍然是可用的。默认的slot名为pg_probackup_slot，可通过选项–slot/-S更改
–backup-pg-log	备份参数	将日志目录包含到备份中。此目录通常包含日志消息，默认情况下不包含日志目录
-E external-directories-paths, --external-dirs=external-directories-paths	备份参数	将指定的目录包含到备份中。此选项对于备份位于数据目录外部的脚本、SQL转储和配置文件很有用。如果要备份多个外部目录，请在UNIX上用冒号分隔它们的路径，如-E /tmp/dir1:/tmp/dir2
–skip-block-validation	备份参数	关闭块级校验，加快备份速度
–no-validate	备份参数	在完成备份后跳过自动验证
–no-sync	备份参数	不将备份文件同步到磁盘
–archive-timeout=timeout	备份参数	以秒为单位设置流式处理的超时时间。 默认值：300
-I, --incremental-mode=none	checksum	lsn
–external-mapping=OLDDIR=NEWDIR	恢复参数	在恢复时，将包含在备份中的外部目录从OLDDIR重新定位到NEWDIR目录。OLDDIR和NEWDIR都必须是绝对路径。如果路径中包含“=”，则使用反斜杠转义。此选项可为多个目录多次指定
-T OLDDIR=NEWDIR, --tablespace-mapping=OLDDIR=NEWDIR	恢复参数	在恢复时，将表空间从OLDDIR重新定位到NEWDIR目录。OLDDIR和NEWDIR必须都是绝对路径。如果路径中包含“=”，则使用反斜杠转义。多个表空间可以多次指定此选项。此选项必须和–external-mapping一起使用
–skip-external-dirs	恢复参数	跳过备份中包含的使用–external-dirs选项指定的外部目录。这些目录的内容将不会被恢复
–skip-block-validation	恢复参数	跳过块级校验，以加快验证速度。在恢复之前的自动验证期间，将仅做文件级别的校验
–no-validate	恢复参数	跳过备份验证

文末有福利领取哦~

👉一、Python所有方向的学习路线

Python所有方向的技术点做的整理，形成各个领域的知识点汇总，它的用处就在于，你可以按照上面的知识点去找对应的学习资源，保证自己学得较为全面。

👉二、Python必备开发工具

👉三、Python视频合集

观看零基础学习视频，看视频学习是最快捷也是最有效果的方式，跟着视频中老师的思路，从基础到深入，还是很容易入门的。

👉 四、实战案例

光学理论是没用的，要学会跟着一起敲，要动手实操，才能将自己的所学运用到实际当中去，这时候可以搞点实战案例来学习。（文末领读者福利）

👉五、Python练习题

检查学习结果。

👉六、面试资料

我们学习Python必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有阿里大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

👉因篇幅有限，仅展示部分资料，这份完整版的Python全套学习资料已经上传

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！