描述

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 会话无法复制，则必须在启动目标服务器时提供这些 WAL。这可以通过在目标数据目录中创建 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;