描述

pg_rewind 是一个用于在 PostgreSQL 集群的逻辑时间线（timeline）发生分叉后，将一个 PostgreSQL 集群与同一个集群的另一个副本进行同步的工具。一个典型的场景是在主备切换后，将旧的主服务器重新上线，使其成为跟随新主服务器的备服务器。

成功执行 rewind 操作后，目标数据目录的状态类似于源数据目录的基础备份。与执行新的基础备份或使用 rsync 等工具不同，pg_rewind 不需要比较或复制集群中未更改的关联块。它只复制现有关联文件中已更改的块；所有其他文件，包括新的关联文件、配置文件和 WAL 段，都会被完整复制。因此，当数据库很大而集群之间只有一小部分块不同时，rewind 操作会比其他方法快得多。

pg_rewind 会检查源集群和目标集群的时间线历史，以确定它们分叉的点，并期望在目标集群的 pg_wal 目录中找到一直追溯到分叉点的 WAL。分叉点可能位于目标时间线、源时间线或它们的共同祖先上。在典型的切换场景中，目标集群在分叉后很快关闭，这不是问题。但如果目标集群在分叉后运行了很长时间，其旧的 WAL 文件可能已不再存在。在这种情况下，您可以手动将它们从 WAL 归档复制到 pg_wal 目录，或者运行带有 -c 选项的 pg_rewind 来自动从 WAL 归档检索它们。pg_rewind 的使用不限于切换场景，例如，可以将备服务器提升为主服务器，运行一些写事务，然后再进行 rewind 操作使其重新成为备服务器。

运行 pg_rewind 后，需要完成 WAL 重放（replay），数据目录才能处于一致状态。当目标服务器再次启动时，它将进入归档恢复（archive recovery）模式，并重放从分叉点之前最后一个检查点开始由源服务器生成的全部 WAL。如果在运行 pg_rewind 时源服务器上的一些 WAL 已不再可用，因此无法被 pg_rewind 会话复制，那么在目标服务器启动时必须提供这些 WAL。这可以通过在目标数据目录中创建 recovery.signal 文件，并在 postgresql.conf 中配置合适的 restore_command 来实现。

pg_rewind 要求目标服务器的 postgresql.conf 中启用 wal_log_hints 选项，或者在初始化集群时启用了数据校验和（data checksums）。这两个选项目前默认都未开启。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;