PostgreSQL备份管理

1. 备份计划

1.1 PG物理备份

备份计划->PG物理备份，在此页面设置备份计划参数：
PG物理备份详情

源库模式
源库模式：选择指定的数据库实例，然后对其进行备份。
注意事项：如果选择备份的定时备份时间点(星期)包含今天，那么当备份计划创建后，会自动
- 备份计划名：输入一个备份计划的名称
- 备份来源：选择从单个数据库备份，然后在弹出的数据库列表中选择需要备份的数据库实例
- 备份主库用户名：通过选择的数据库实例自动检索获取，可修改
- 备份主库密码：通过选择的数据库实例自动检索获取，可修改
- 备份保存节点：要保存备份的主机ip，只能是已启动clup-agent服务的主机
- 备份保存目录：数据保存目录，注意此目录需要对应的操作系统用户有读写权限
- pg_basebackup附加参数：如“-r 100M”限制备份速率，输入“-F t -z” 使用压缩备份
- 备份使用的操作系统用户：备份节点上操作系统用户名称
- 保存节点上数据库程序路径：备份数据保存节点上的数据库安装目录，注意数据库版本应与要备份的主库版本一致
- WAL备份延迟告警兆字节数：WAL备份延迟告警参数，默认200，高于此值会触发告警，单位MB
- WAL备份保留时间(天)：WAL备份保存时间，单位天，超出此时间段会自动删除此备份计划的WAL备份
- 全量备份保留时间(天)：全量备份保留时间，单位天，超出此时间段会自动删除此备份计划的全量备份
- 全量定时备份时间点(星期)：开始执行全量备份的时间点，单位星期(周一到周日)，可多选
- 全量定时备份时间点(小时)：开始执行全量备份的时间点，整点时间，可多选
- 全量备份最低保留份数：保留最近备份成功的几份数据，就算超出设置的天数也不会被删除

注意事项：

集群模式
集群模式：选择指定的集群，由CLup选取一个备库做备份（主库的一级子节点），当这个备库故障时，CLup会自动切换备份来源（主库的一级子节点），如果没有可用的备库，则会将主库作为备份源，直到有可用的备库为止。
- 备份计划名：输入一个备份计划的名称
- 备份来源：选择从集群备份，然后在弹出的集群列表中选择需要目标集群
- 备份主库用户名：通过选择的数据库实例自动检索获取，可修改
- 备份主库密码：通过选择的数据库实例自动检索获取，可修改
- 备份保存节点：要保存备份的主机ip，只能是已启动clup-agent服务的主机
- 备份保存目录：数据保存目录，注意此目录需要对应的操作系统用户有读写权限
- pg_basebackup附加参数：如“-r 100M”限制备份速率，输入“-F t -z” 使用压缩备份
- 备份使用的操作系统用户：备份节点上操作系统用户名称
- 保存节点上数据库程序路径：备份数据保存节点上的数据库安装目录，注意数据库版本应与要备份的主库版本一致
- WAL备份延迟告警兆字节数：WAL备份延迟告警参数，默认200，高于此值会触发告警，单位MB
- WAL备份保留时间(天)：WAL备份保存时间，单位天，超出此时间段会自动删除此备份计划的WAL备份
- 全量备份保留时间(天)：全量备份保留时间，单位天，超出此时间段会自动删除此备份计划的全量备份
- 全量定时备份时间点(星期)：开始执行全量备份的时间点，单位星期(周一到周日)，可多选
- 全量定时备份时间点(小时)：开始执行全量备份的时间点，整点时间，可多选
- 全量备份最低保留份数：保留最近备份成功的几份数据，就算超出设置的天数也不会被删除

1.2 自定义备份

自定义备份，可以根据配置的计划执行自定义的备份脚本或者备份命令。

备份计划名：输入一个备份计划的名称
备份最低保留份数：保留最近备份成功的几份数据，就算超出设置的天数也不会被删除
备份保留时间(天)：全量备份保留时间，单位天，超出此时间段会自动删除此备份计划的全量备份
备份主库ip地址：要备份的数据库IP地址
备份主库端口：要备份的数据库端口
备份保存节点：要保存备份的主机ip，只能是已启动clup-agent服务的主机
备份保存目录：数据保存目录，注意此目录需要对应的操作系统用户有读写权限
备份使用的操作系统用户：备份节点上操作系统用户名称
备份命令：可以是执行一个脚本(bash xxx/script.sh)，也可以备份的命令(pg_basebackup xxxx)
全量定时备份时间点(星期)：开始执行全量备份的时间点，单位星期(周一到周日)，可多选
全量定时备份时间点(小时)：开始执行全量备份的时间点，整点时间，可多选

注意：如使用脚本，请严格审查脚本内容；使用备份命令时，需要提前配置环境变量和.pgpass文件。

2. 备份数据

在备份数据列表中，可以查看备份历史记录和日志等信息。

PG备份数据导入

点击PG备份数据导入来导入其他CLup机器上的备份数据：
导入备份数据

备份计划名：备份计划的名称
备份主库IP地址：记录原备份数据所属数据库的IP
备份主库端口：用于恢复时启动的端口
原备份计划id: 记录原平台备份计划的id
原备份数据id：记录原平台备份数据的id
备份保存节点：保存到当前连接的哪一台主机
备份保存目录：保存到主机上的那个目录

3. 恢复数据库

点击恢复数据库按钮，选择恢复PG数据库来恢复数据库：

选择要恢复的数据库：选择执行成功的备份数据，备份计划名加备份主机ip
选择要恢复到的主机：要恢复数据的数据库主机ip
恢复的数据库的端口：执行恢复数据的数据库端口
数据库的数据目录：数据库恢复的存储目录，要求目录为空且存在，操作系统用户有此文件夹的读写权限
恢复时间点：选择时间点后，默认会选择此时间点之前最近的一次备份作为要恢复的数据
数据库的操作系统用户：要恢复数据库主机的操作系统用户名
数据库软件的bin目录：要恢复数据主机的数据库软件的目录

等待CLup将数据库的备份拷贝和解压缩到目标机器，日志最后一条记录打印”Success”则为成功，然后按照如下步骤启动数据库：

登录到恢复数据库的主机
切换到恢复时填写的操作系统用户，如postgres
启动数据库：CLup恢复时不会修改用户的环境变量，启动数据库时注意使用对应版本的数据库软件，携带-D 参数指定数据目录。

示例：

su - postgres
/usr/pgsql-15/bin/pg_ctl start -D /backup/recoveryT1
.....

启动过程可能会比较慢，触发超时，是因为需要滚WAL日志，并非是启动失败。

登录