PostgreSQL / 系统课时
提升备库为新主库
提升备库为新主库
当原主库已经不能继续提供写服务时,故障切换的核心动作是选择状态合格的备库执行 promote。本课完成提升操作,并用恢复状态、时间线与测试事务三类证据确认它已经成为可写的新主库。
学习目标
- 使用
pg_promote()或pg_ctl promote提升 PostgreSQL 备库 - 理解提升后恢复结束、时间线分叉与继续生成 WAL 的关系
- 用 SQL 验证新主库已经能够接受正常读写事务
提升前确认候选备库状态
不要因为主库失联就立即提升任意节点。候选实例至少应仍处于恢复状态,并且已确认是本次故障切换选择的目标。如果旧主仍可能接受写入,还必须先通过网络、存储或编排系统完成 fencing,避免新旧两个节点同时对外写入。
在候选备库执行:
SELECT pg_is_in_recovery();
SELECT pg_last_wal_replay_lsn();预期结果:
pg_is_in_recovery
-------------------
t
(1 row)
pg_last_wal_replay_lsn
------------------------
<LSN>
(1 row)pg_is_in_recovery() 返回 t 表示当前实例仍是备库。<LSN> 会随复制进度变化;如果原主已经完全不可达,这个位置只能证明备库回放到了本地已有 WAL 的某处,不能证明故障前所有已提交事务都已经复制过来。
执行 promote
能够连接候选数据库时,可直接调用 pg_promote() 请求服务器结束恢复并完成提升:
SELECT pg_promote(true, 60);预期结果:
pg_promote
------------
t
(1 row)第一个参数 true 表示等待提升完成,60 是最多等待的秒数。返回 t 表示服务器在等待期限内完成了提升;若返回 f,应继续检查服务器日志和恢复状态,而不能直接认为节点已经成为新主。
无法通过 SQL 执行操作时,也可以在数据库服务器上使用:
pg_ctl -D <PATH> promote -w -t 60预期输出:
waiting for server to promote.... done
server promoted<PATH> 应替换为该 PostgreSQL 实例的数据目录,实际等待输出可能因版本和环境略有差异。两种方式最终触发的是同一类状态转换,生产流程通常选择更容易被自动化平台可靠执行的一种。

验证实例已经退出恢复
提升完成后首先重新检查恢复状态和当前 WAL 位置:
SELECT pg_is_in_recovery();
SELECT pg_current_wal_lsn();预期结果:
pg_is_in_recovery
-------------------
f
(1 row)
pg_current_wal_lsn
--------------------
<LSN>
(1 row)pg_is_in_recovery() 返回 f 才说明实例已经退出恢复模式。此时服务器能够生成自己的 WAL,pg_current_wal_lsn() 也可以作为新主继续写日志的辅助证据;<LSN> 的实际值会随写入推进。
观察新的时间线
PostgreSQL 在恢复后形成新的历史分支时,会使用新的 timeline 区分后续 WAL。它不是简单的主库编号,而是在说明:从某个分叉点开始,新主产生的 WAL 已经属于另一条历史。
可以读取当前 WAL 文件名辅助确认新主所在的时间线:
SELECT pg_walfile_name(pg_current_wal_lsn()) AS wal_file;预期结果:
wal_file
--------------------------
<WAL_FILE>
(1 row)WAL 文件名开头的 8 个十六进制字符表示 timeline ID,<WAL_FILE> 的实际值会随当前 WAL 段变化。故障节点重新上线后不能直接恢复写流量,应先判断它与新主是否发生数据分叉,再决定使用 pg_rewind 还是重新执行基础备份。
用事务验证新主可写
退出恢复只是控制面证据,还应进行一次低风险写入验证。下面使用临时表完成事务、DDL、写入和提交检查,不会留下永久业务对象。
BEGIN;
CREATE TEMP TABLE failover_write_check (
id integer PRIMARY KEY,
note text
);
INSERT INTO failover_write_check VALUES (1, 'new-primary');
SELECT * FROM failover_write_check;
COMMIT;预期结果:
BEGIN
CREATE TABLE
INSERT 0 1
id | note
----+-------------
1 | new-primary
(1 row)
COMMIT这组结果证明新主能够开启事务、执行 DDL、产生写入并提交。开放客户端写流量前,至少应同时满足 pg_is_in_recovery() = false、新时间线已经建立、测试事务可提交以及旧主已完成隔离;随后再持续观察数据库日志、WAL 生成和客户端连接是否正常。