pg_rewind

修复分叉的 PostgreSQL 备库

补充说明

pg_rewind 在旧主库重新加入集群时，把它与当前主库的差异块同步过来，避免全量重做基础备份。它适合时间线分叉后的备库回退。

常用示例

pg_rewind --target-pgdata=/var/lib/pgsql/data \
  --source-server="host=primary port=5432 user=repl dbname=postgres"
pg_rewind --target-pgdata=/var/lib/pgsql/data \
  --source-server="host=primary port=5432 user=repl" --dry-run
pg_rewind --target-pgdata=/var/lib/pgsql/data \
  --source-server="..." --progress
pg_rewind --target-pgdata=/var/lib/pgsql/data \
  --source-pgdata=/backup/base

易错点与排错

• 目标实例必须停止；在线执行会损坏数据目录。
• 目标库需要开启 wal_log_hints 或数据校验和；否则可能无法完成。
• 源和目标必须是同一集群、兼容版本，且时间线关系清晰。
• 执行后目标库处于需要恢复的状态；要配置 primary_conninfo 并启动。
• --dry-run 只检查，不写数据；正式执行前先跑。
• 分叉过大时 pg_rewind 不一定比重新做基础备份更快。
• 目标目录的属主和权限要正确；用数据库用户执行。

相关命令

• pg_basebackup — 重建备库
• pg_waldump — 分析 WAL
• pg_ctl — 启动备库