描述

pg_rewind 是一个工具，用于在同一 PostgreSQL 集簇的两份副本时间线发生分叉后，将其中一份重新同步到另一份。典型场景是故障切换后，让旧主库重新上线，作为跟随新主库的备库。

成功完成回卷后，目标数据目录的状态相当于源数据目录的一份基础备份。与重新获取一份基础备份或使用 rsync 之类的工具不同，pg_rewind 不需要比较或复制集簇中未发生变化的关系块：

因此，当数据库规模很大而两个集簇之间只有少量块不同时，回卷操作会比其他方法快得多。

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 都会拒绝运行：回卷后的服务器会在从源复制的块上无法通过校验和验证。相反的组合则允许使用，但会发出警告；除非源服务器在分叉点之后在线启用了数据校验和，否则回卷后的服务器保持数据校验和禁用。有关如何在复制环境中一致地更改状态，请参见 pg_checksums。

选项

pg_rewind 接受以下命令行参数：

环境

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

环境变量 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;