PostgreSQL / 系统课时
创建 PostgreSQL 原生增量备份
创建 PostgreSQL 原生增量备份
PostgreSQL 17 起,pg_basebackup 可以依据较早备份的 backup_manifest,结合服务端 WAL summaries 只传输发生变化的关系数据块。本课完成 WAL 汇总配置、全量基线和两级增量链创建,并验证哪些依赖必须保留才能继续备份和恢复。
学习目标
- 启用并验证 WAL summaries,理解其与原生增量备份的关系
- 使用
backup_manifest创建全量基线后的连续增量备份 - 区分 WAL summary 保留范围与备份依赖链的保留要求
准备 WAL summaries
原生增量备份要求服务端为 PostgreSQL 17 或更高版本,并启用 WAL summarization。wal_level 不能为 minimal;pg_basebackup 仍通过复制协议连接,因此备份账号需要 REPLICATION 权限或超级用户权限,pg_hba.conf 和 max_wal_senders 也必须允许复制连接。
先检查版本和 WAL 级别:
psql -X -d postgres -Atc "SELECT current_setting('server_version_num')::int >= 170000 AND current_setting('wal_level') <> 'minimal';"预期输出:
t在 postgresql.conf 中启用 WAL 汇总,并让保留期覆盖两次相关备份之间可能出现的最大间隔:
summarize_wal = on
wal_summary_keep_time = '14d'这是配置片段。重新加载配置后验证参数:
psql -X -d postgres -c "SELECT pg_reload_conf();" -c "SELECT current_setting('summarize_wal') AS summarize_wal, current_setting('wal_summary_keep_time') AS wal_summary_keep_time;"预期输出中的保留时间可能按服务器格式显示为等价值:
pg_reload_conf
----------------
t
(1 row)
summarize_wal | wal_summary_keep_time
---------------+-----------------------
on | 14d
(1 row)wal_summary_keep_time 不是按“备份文件要保存多久”来设置的。创建增量备份时,服务端需要已有 summary 覆盖参考备份起始 LSN 到当前备份起始 LSN 的范围;如果必要 summary 已被清理,即使参考 backup_manifest 仍在,新的增量备份也会失败。
建立全量与两级增量链
下面假设连接目标为 <HOST>:<PORT>,备份账号为 backup,密码已通过 .pgpass 等安全方式提供。主示例先创建全量基线,再让 inc-001 引用全量 manifest,让 inc-002 引用上一份增量 manifest,从而形成连续依赖链:
set -e
pg_basebackup -h <HOST> -p <PORT> -U backup \
-D /backup/full-001 -Fp -X stream
test -f /backup/full-001/backup_manifest
pg_basebackup -h <HOST> -p <PORT> -U backup \
-D /backup/inc-001 -Fp -X stream \
--incremental=/backup/full-001/backup_manifest
test -f /backup/inc-001/backup_manifest
pg_basebackup -h <HOST> -p <PORT> -U backup \
-D /backup/inc-002 -Fp -X stream \
--incremental=/backup/inc-001/backup_manifest
test -f /backup/inc-002/backup_manifest
echo "full-001 -> inc-001 -> inc-002 ready"预期输出:
full-001 -> inc-001 -> inc-002 ready--incremental 接收的是来源于同一服务器实例的较早备份 manifest。增量备份中的非关系文件仍会完整包含,而部分关系文件会被只保存变化数据块的增量文件替代。因此 inc-001 和 inc-002 都不能直接作为 PostgreSQL 数据目录启动。

验证备份依赖链
恢复增量备份前,需要用 pg_combinebackup 按从最旧到最新的顺序提供完整依赖链。创建完成后可以先执行 dry run,检查三份备份是否构成合法链,而不真正生成合成全量目录。pg_combinebackup 即使在 dry run 模式下也要求指定输出目录:
pg_combinebackup --dry-run \
-o /backup/combined-002 \
/backup/full-001 \
/backup/inc-001 \
/backup/inc-002 \
&& echo "backup chain valid"预期输出:
backup chain valid真正恢复 inc-002 时,不能只保留最新增量;本例中的 full-001、inc-001 和 inc-002 都是重建所需输入。PostgreSQL 不会替你维护这些备份之间的依赖关系,因此删除旧备份前必须确认没有后续增量直接或间接依赖它。
检查汇总器与保留边界
备份窗口内可以检查 WAL summarizer 的推进状态。LSN 与进程号是动态值,实际结果会不同:
SELECT summarized_tli, summarized_lsn, pending_lsn, summarizer_pid
FROM pg_get_wal_summarizer_state();预期结果:
summarized_tli | summarized_lsn | pending_lsn | summarizer_pid
----------------+----------------+-------------+---------------
1 | <VALUE> | <VALUE> | <PID>
(1 row)如果 summarizer_pid 长期为空、汇总进度异常,或 pg_basebackup 报告缺少所需 WAL summaries,应检查 summarize_wal、wal_level、汇总进度和 summary 保留期,而不是反复重试。还要区分两类依赖:WAL summaries 用于创建新的增量备份,备份链与归档 WAL 则关系到重建备份和后续恢复;原生增量节省了传输与存储量,但没有消除这些保留与恢复责任。