描述

pg_rewind 是一个用于在集群的时间线发生分叉之后，把一个 PostgreSQL 集群与同一集群的另一个副本进行同步的工具。一个典型的场景是：在故障转移之后，把一台旧的主服务器作为追随新主服务器的后备重新联机。

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

pg_rewind 会检查源集群和目标集群的时间线历史，以确定两者发生分叉的位置，并且期望能在目标集群的 pg_wal 目录中找到一直回溯到分叉点的 WAL。分叉点可能位于目标时间线、源时间线或它们共同的祖先之上。在目标集群在分叉后不久即被关闭的典型故障转移场景中，这不是问题；但如果目标集群在分叉之后运行了很长时间，其旧的 WAL 文件可能已经不存在了。在这种情况下，你可以手工把它们从 WAL 归档复制到 pg_wal 目录，或者运行 pg_rewind 并带上 -c 选项来从 WAL 归档自动取回它们。pg_rewind 的使用并不限于故障转移，例如一台后备服务器可以被提升、执行一些写事务，然后再被回卷成一台后备服务器。

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

pg_rewind 要求目标服务器或者启用了 wal_log_hints 选项（在 postgresql.conf 中），或者在集群用 initdb 初始化时启用了数据校验和（默认情况）。full_page_writes 也必须被设置为 on，但它在默认情况下是启用的。

选项

pg_rewind 接受下列命令行参数：

环境

当使用 --source-server 选项时，pg_rewind 还会使用 libpq 支持的环境变量（参见 Section 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;