pg_basebackup

PostgreSQL 物理基础备份

补充说明

pg_basebackup 通过流复制协议复制整个数据目录，用于搭建备库或做物理备份。它要求源库开启归档/复制相关配置，产物不能按表选择性恢复。

常用示例

pg_basebackup -h 127.0.0.1 -U replicator -D /backup/base -Ft -z -P
pg_basebackup -h 127.0.0.1 -U replicator -D /var/lib/pgsql/data -X stream -R
pg_basebackup -h 127.0.0.1 -U replicator -D /backup/base -X stream --checkpoint=fast
pg_basebackup -h 127.0.0.1 -U replicator -D /backup/base -Ft -z -Xs -P

易错点与排错

• 需要 REPLICATION 角色或超级用户，并且 pg_hba.conf 允许复制连接。
• 源库要设置 wal_level=replica、足够的 max_wal_senders；否则直接失败。
• 目标目录必须为空；覆盖已有数据目录是危险操作。
• -X stream 同时接收 WAL，-X fetch 在结束时抓取；高写入场景优先 stream。
• -R 会自动写 standby.signal 和连接配置，适合直接拉起备库；做主备份时不要加。
• 主备大版本必须一致；小版本也建议一致。
• 并行 -j 与 -X stream 有限制；确认版本支持再组合使用。
• 备份不含配置文件（postgresql.conf、pg_hba.conf）时，恢复后要手动补齐。
• 表空间使用绝对路径；换机器恢复需要 tablespace_map 和路径映射。

相关命令

• pg_dump — 逻辑备份，可选择性恢复
• pg_restore — 恢复逻辑归档
• pg_isready — 检查服务可用性