说明

pg_rewind 是一款工具，用于在集群时间线分叉后，将一个 PostgreSQL 集群与同一集群的另一个副本进行同步。一种典型的方案是在故障转移后，将旧的主服务器重新联机并作为追随新主服务器的备用服务器。

完成倒带操作后，目标数据目录的状态类似于源数据目录的基本备份。与创建新的基本备份或使用 rsync 等工具不同，pg_rewind 无需比较或复制集群中未更改的关系块。只复制现有关系文件中的已更改块；包括新关系文件、配置文件和 WAL 段在内的所有其他文件都将被完整复制。因此，当数据库很大且各个集群之间只有少部分块不同时，与其他方法相比，倒带操作要快得多。

pg_rewind 检查源集群和目标集群的时间线历史记录，以确定它们分歧的位置并希望在目标集群的 pg_wal 目录中找到一直到分歧点为止的 WAL。分歧点可以在目标时间线上、源时间线上或它们的共同祖先上找到。在目标集群在分歧后不久关闭的典型故障转移场景中这不是问题，但是如果目标集群在分歧后运行很长时间，其旧 WAL 文件可能不再存在。在这种情况下，您可以手动将它们从 WAL 存档复制到 pg_wal 目录，或使用 -c 选项运行 pg_rewind 以自动从 WAL 存档检索它们。pg_rewind 的使用不限于故障转移，例如，备用服务器可以提升，运行一些写入事务，然后再倒带以再次成为备用。

运行 pg_rewind 后，必须完成 WAL 重放，这样数据目录才能处于一致状态。当目标服务器再次启动时，它将进入归档恢复，并重放从分歧点之前最后检查点以来源服务器中生成的所有 WAL。如果在运行 pg_rewind 时源服务器中不再有某些 WAL，因此 pg_rewind 会话无法复制，则必须在启动目标服务器时使其可用。可以通过在目标数据目录中创建 recovery.signal 文件并在 postgresql.conf 中配置合适的 restore_command 来完成此操作。

pg_rewind 要求目标服务器在 postgresql.conf 中启用 wal_log_hints 选项或在使用 initdb 初始化集群时启用数据校验和。这两个目前都不是默认启用的。full_page_writes 也必须设置为 on，但默认启用。

选项

pg_rewind 接受以下命令行参数

环境

使用 --source-server 选项时，pg_rewind 也使用 libpq 支持的环境变量（请参见 第 32.15 节）。

环境变量 PG_COLOR 指定是否在诊断消息中使用颜色。可能的值有 always、auto 和 never。

备注

在将在线集群用作源使用 pg_rewind 时，可以对在源集群上执行 pg_rewind 使用的函数拥有足够权限的角色进行操作（而不是超级用户）。以下是创建在此处名为 rewind_user 的此类角色的方法

CREATE USER rewind_user LOGIN;
GRANT EXECUTE ON function pg_catalog.pg_ls_dir(text, boolean, boolean) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_stat_file(text, boolean) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_read_binary_file(text) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_read_binary_file(text, bigint, bigint, boolean) TO rewind_user;