PostgreSQL / 系统课时
判断旧主能否直接重新加入
判断旧主能否直接重新加入
新主完成提升后,旧主不能仅靠修改连接地址就直接作为备库启动。判断依据不是机器是否恢复,而是旧主的数据目录是否仍位于新主当前 WAL 历史的共同路径上;只要旧主在分叉点之后保留了另一条时间线上的状态,就必须先执行重同步。
学习目标
- 理解新主提升后 WAL 时间线发生分叉的原因
- 根据控制信息和 Timeline history 判断旧主是否存在分叉风险
- 正确选择直接跟随、
pg_rewind或重新制作基础备份
为什么提升后会产生两条历史
故障前,主库和备库沿同一条 WAL 历史前进。备库提升为新主后会创建新的时间线,并从提升点继续接受写事务;旧主磁盘仍保留原时间线上的状态。如果旧主在隔离不完整时继续产生过 WAL,两端就形成了不能由流复制自动合并的两套历史。

流复制只会沿上游提供的有效 WAL 历史继续恢复,不会比较两边的数据页并自动解决分叉。因此,“数据看起来基本一致”或“旧主还能启动”都不能证明它可以直接重新加入。
先保持旧主离线并读取控制信息
判断期间应继续隔离旧主,禁止客户端写入。先在 PostgreSQL 停止状态下读取控制文件,确认关闭状态以及最近 checkpoint 所属时间线。
pg_controldata <PATH> | grep -E "Database cluster state|Latest checkpoint location|Latest checkpoint's TimeLineID|Latest checkpoint's PrevTimeLineID"预期输出中的 LSN 和时间线编号取决于现场环境。
Database cluster state: shut down
Latest checkpoint location: <VALUE>
Latest checkpoint's TimeLineID: <ID>
Latest checkpoint's PrevTimeLineID: <ID>Latest checkpoint location 是最近 checkpoint 的位置,并不等同于旧主 WAL 的最终末端,因此不能只比较这一项就宣布可以直接跟随。这里的目标是先确认旧主状态和时间线,为后续分叉判断建立证据。
用 Timeline history 确认分叉位置
新主提升到新的时间线后,会生成对应的 Timeline history 文件。文件名形如 00000002.history;下面使用 <ID> 表示当前新时间线对应的 8 位十六进制编号。文件通常可以从新主的 pg_wal 或 WAL 归档中取得。
先读取完整 history 文件,再提取其中的父时间线和切换 WAL 位置:
cat <PATH>/pg_wal/<ID>.history
awk 'NF >= 2 && $1 !~ /^#/ {print "parent_tli=" $1, "switchpoint=" $2}' <PATH>/pg_wal/<ID>.history预期结果会显示父时间线编号以及新时间线从父时间线分出的 WAL 位置;history 中还可能包含描述提升原因的文字。
<ID> <VALUE> <VALUE>
parent_tli=<ID> switchpoint=<VALUE>这个 switchpoint 就是判断共同历史的重要边界。如果旧主在该位置之后已经沿旧时间线产生并落盘了独立变化,就不能通过创建 standby.signal 和修改连接参数来撤销这些变化。若无法可靠证明旧主从未越过分叉点,也应按存在分叉处理。
不要用修改连接参数代替重同步
一种危险做法是在旧主数据目录中直接配置新的 primary_conninfo、创建 standby.signal 后启动实例。连接配置只能告诉 PostgreSQL 去哪里接收 WAL,并不会把旧时间线分叉后已经修改的数据页恢复成新主的状态。
下面仅是备库连接配置片段,不代表当前数据目录已经具备安全启动条件:
primary_conninfo = 'host=<IP> port=<PORT> user=<VALUE> application_name=<VALUE>'这是片段示例,依赖已经完成历史一致性处理的数据目录、可用的复制账号以及正确的认证配置。只有确认无需重同步,或者已经完成 pg_rewind、基础备份重建后,才能据此启动旧主作为备库。
在 pg_rewind 与重新建立备库之间选择
如果旧主和新主拥有共同祖先、旧主数据目录完整,而且目标集群在发生分叉前已经启用数据校验和或 wal_log_hints 等 pg_rewind 所需条件,可以优先使用 pg_rewind。执行时 PostgreSQL 必须停止,并应先保留必要的原始数据目录副本。
pg_rewind \
--target-pgdata=<PATH> \
--source-server="host=<IP> port=<PORT> dbname=postgres user=<VALUE>"预期结果:存在分叉时,工具会识别共同历史并修正目标数据目录;具体 WAL 位置和复制量随现场变化,成功完成时以 Done! 结束。
pg_rewind: servers diverged at WAL location <VALUE> on timeline <ID>
pg_rewind: Done!如果 pg_rewind 的前置条件不满足、无法取得所需 WAL、数据目录损坏,或旧主状态无法可靠确认,应放弃就地修复,直接从新主重新制作基础备份。
pg_basebackup \
-h <IP> \
-p <PORT> \
-U <VALUE> \
-D <PATH> \
-R \
-X stream \
-P预期输出会显示基础备份进度并正常完成,字节数取决于数据库规模。
<VALUE>/<VALUE> kB (100%), 1/1 tablespace用角色和复制状态完成验收
无论旧主可以安全直接跟随,还是经过 pg_rewind 或基础备份重建,启动后都必须证明它已经以备库身份连接新主,而不是只检查进程是否启动。
SELECT pg_is_in_recovery() AS in_recovery;
SELECT status,
sender_host,
sender_port,
latest_end_lsn
FROM pg_stat_wal_receiver;预期结果:重新加入后的旧主应处于恢复状态;建立流复制连接后,WAL receiver 通常显示为 streaming。
in_recovery
-------------
t
status | sender_host | sender_port | latest_end_lsn
-----------+-------------+-------------+---------------
streaming | <IP> | <PORT> | <VALUE>判断旧主能否重新加入的核心原则,是能否证明其数据目录仍与新主当前 WAL 历史兼容。只有能够排除分叉并确认旧主没有独立历史时才考虑直接跟随;存在分叉或证据不足时,应先用 pg_rewind 消除差异,无法安全 rewind 时则重新建立备库。