PostgreSQL / 系统课时
物理基础备份
物理基础备份
物理基础备份复制的是整个 PostgreSQL 实例的数据目录基础状态,而不是逐个导出 SQL 对象。本节使用 pg_basebackup 创建可恢复副本,说明 WAL 如何保证备份一致性,并给出完整性检查与隔离启动前的关键注意事项。
学习目标
- 准备
pg_basebackup所需的复制权限与连接条件。 - 创建包含必要 WAL 的实例级基础备份。
- 验证备份文件完整性,并理解物理备份的恢复边界。
准备复制连接
pg_basebackup 通过复制协议连接源实例,因此连接用户需要 REPLICATION 权限,pg_hba.conf 也必须允许该用户从备份机地址发起复制连接。下面的 SQL 由具备足够权限的管理员执行。
CREATE ROLE backup_user WITH LOGIN REPLICATION PASSWORD '<PASSWORD>';预期结果:
CREATE ROLE还需要在 pg_hba.conf 中允许复制连接,例如下面是配置片段示例;把 <IP> 替换为备份机地址,并按实际安全要求选择认证方式。
host replication backup_user <IP>/32 scram-sha-256该配置本身不会产生控制台输出。修改后可通过重新加载配置使认证规则生效,并用实际环境中的连接测试确认规则匹配。
创建基础备份
使用 plain 格式 -Fp 可以直接得到一个 PostgreSQL 数据目录副本。-X stream 会在备份过程中通过第二条复制连接同步所需 WAL,确保恢复时具备把数据文件推进到一致状态所需的日志。
pg_basebackup -h <IP> -p <PORT> -U backup_user -D <PATH>/basebackup -Fp -X stream -P && echo "basebackup-ok"预期输出:
<PROGRESS>
basebackup-ok-P 会显示进度,因此前面的进度文本会随版本、数据量和终端环境变化。命令成功后,<PATH>/basebackup 是一个实例级数据目录副本,不能像逻辑备份那样只挑一张表直接恢复。

检查备份是否完整
仅看到目录生成不等于备份可靠。较新的 PostgreSQL 版本可使用 pg_verifybackup 根据备份清单检查文件、校验和以及所需 WAL 范围是否满足要求。
pg_verifybackup <PATH>/basebackup && echo "verify-ok"预期输出:
backup successfully verified
verify-ok如果工具报告缺失文件、校验失败或 WAL 不完整,应把该备份视为不可用并重新生成。若所用 PostgreSQL 版本没有 pg_verifybackup,至少要检查命令退出状态,并通过隔离恢复演练验证副本能够启动。
理解恢复边界
物理基础备份与源实例的主版本和底层存储格式强绑定,适合灾难恢复、搭建物理副本和时间点恢复的基础数据集,不适合直接跨主版本迁移,也不能像 pg_restore 那样选择单表恢复。
恢复演练时应把备份复制到隔离主机或隔离目录,使用不同端口和独立配置启动,避免与生产实例共享数据目录、归档目标或监听端口。若需要恢复到备份之后的某个时间点,还必须同时保存从基础备份开始之后连续可用的 WAL 归档;只有基础备份而没有所需 WAL,就无法完成对应的时间点恢复。