pg_rewind—使一个PostgreSQL数据目录与另一个数据目录（该目录从第一个PostgreSQL数据目录创建而来）一致。

描述

pg_rewind是一个在集群的时间线参数偏离之后，用于使一个PostgreSQL集群与另一个相同集群的拷贝同步的工具。一个典型的场景是在故障转移之后，让一个老的主服务器重新在线作为一个standby跟随新主服务器。

其结果相当于使用源数据目录替换目标数据目录。所有的文件都被拷贝，包括配置文件。与做一个基础备份或者像rsync这样的工具相比，pg_rewind的优势是pg_rewind不需要读取所有集群中没有更改的文件。当数据库很大，并且只有一小部分不同的集群之间，使它的速度快得多。

pg_rewind检查源集群与目标集群的时间线历史来检测它们产生分歧的点，并希望在目标集群的pg_xlog目录找到WAL回到分歧点的所有方式。在典型的故障转移场景：目标集群在分歧之后立即被关闭，那是没有问题的，但是，如果目标集群在分歧之后运行了很长一段时间，老的WAL文件可能不存在了。在这种情况下，它们可以手动从WAL归档复制到pg_xlog目录。目前不支持从一个WAL归档中自动获取丢失的文件。

在运行pg_rewind之后，当目标服务器第一次被启动，它将进入恢复模式并重放从分歧点之后源服务器产生的所有WAL。当pg_rewind被运行时，如果一些 WAL在源服务器上不再可用，因此不能用pg_rewind回话复制，当目标服务器被启动时时可以的。这可以通过在目标数据目录创建一个带有合适的restore_command命令的recovery.conf文件来实现。

选项

pg_rewind 接受下列命令行参数：

-D 目录

–target-pgdata=目录

该选项指定与源同步的目标数据目录。

–source-pgdata=目录

指定源服务器的数据目录的路径，以使目标数据目录与之同步。当—source-pgdata被使用时，源服务器必须被关闭。

–source-server=连接字符串

指定一个libpq连接字符串以连接到源PostgreSQL服务器来使目标同步。服务器必须开启并允许，并且不能处于恢复模式。

-n

–dry-run

做除了修改目标目录的所有事情。

-P

–progress

开启进程报告。在从源集群复制数据时，打开这个功能将提供一个近似的进度报告。

–debug

打印详细的调试输出对开发者调试pg_rewind来说是非常有用的。

-V

–version

显示版本信息并退出。

-?

–help

显示帮助，然后退出

环境

当—source-server选项被使用时，pg_rewind也使用libpq支持的环境变量（见31.14节）。

注意

pg_rewind需要启用postgresql.conf中的wal_log_hints 选项，或者当集群被使用initdb初始化时启用数据校验。full_page_writes也必须启用。

pg_rewind是如何工作的

基本的思想是从新的集群拷贝所有的东西到老的集群，除了我们知道的相同的（数据）块。

1.从最后一个检查点开始扫描老集群的WAL日志，在该检查点之前，新集群的时间线历史从老集群被创建出来。对于每一个WAL记录，做一个数据块被触及的记录。在新的集群被创建出来以后，这产生所有在老集群中被更改的数据块的列表。

2.从新集群复制所有这些被更改的数据块到老集群。

3.从新集群复制所有其它像clog，conf这样的文件等等到老集群。每个文件，除了表文件。

4.从新集群应用WAL，从故障转移创建的检查点开始。（严格的说，pg_rewind不应用WAL，它只是创建一个备份标签文件以表明PostgreSQL被启动了，它会从检查点重放并应用所有需要的WAL）

https://wiki.postgresql.org/wiki/What%27s_new_in_PostgreSQL_9.5