PostgreSQL / 系统课时
执行计划内主备切换
执行计划内主备切换
计划内主备切换要解决的不是“怎样更快提升备库”,而是怎样形成一个可证明的最终写入边界:先让旧主进入写入静默,确认切换前已提交事务的 WAL 已在备库重放,再围栏旧主、提升备库并恢复连接,避免数据缺口和双主写入。
学习目标
- 按写入静默、边界确认、追平、旧主围栏、提升和连接恢复的顺序执行切换
- 用已刷盘 LSN 与备库重放位置证明切换前已提交事务不存在缺口
- 在恢复业务写入前验证新主角色、关键数据和受控写入能力
先建立真正的写入静默
计划内 Switchover 的前提是旧主仍然健康,因此必须先停止所有受控、可能产生持久 WAL 的写入来源,包括应用流量、定时任务、ETL、批处理、DDL 发布、运维脚本、人工维护以及扩展触发的写入。仅查询 pg_stat_activity 并看到“没有客户端事务”,只能证明当前没有可见的客户端事务,不能证明调度器、维护任务或其他入口不会马上再次写入。
PostgreSQL 自身后台活动仍可能产生与业务无关的 WAL,因此不要把“静默成功”理解为 LSN 从此绝对不再变化。这里的 cutoff_lsn 定义为:所有业务与运维写入入口已被冻结、在途写事务已结束,并完成一次 CHECKPOINT 后记录的已刷盘 WAL 位置。记录后立即进入旧主围栏阶段,不再允许任何业务或运维写入恢复。

先检查是否仍有客户端事务;确认外部写入入口已经冻结后,再执行检查点并记录最终边界。
SELECT pid, usename, application_name, state, xact_start
FROM pg_stat_activity
WHERE pid <> pg_backend_pid()
AND backend_type = 'client backend'
AND xact_start IS NOT NULL
ORDER BY xact_start;
CHECKPOINT;
SELECT pg_current_wal_flush_lsn() AS cutoff_lsn;预期结果
pid | usename | application_name | state | xact_start
-----+---------+------------------+-------+------------
(0 rows)
CHECKPOINT
cutoff_lsn
------------
0/<VALUE>
(1 row)实际 LSN 会不同。(0 rows) 只是静默门禁的一部分;只有外部所有已知写入来源已经停止,且 CHECKPOINT 成功后记录的 cutoff_lsn,才可作为本次切换的业务数据边界。
等待备库重放到边界
在备库上应检查重放位置,而不是只看接收位置。pg_last_wal_receive_lsn() 达到目标只表示 WAL 已接收;只有 pg_last_wal_replay_lsn() 达到或超过 cutoff_lsn,才能证明该边界内的 WAL 已应用到备库恢复状态。
SELECT pg_last_wal_receive_lsn() AS receive_lsn,
pg_last_wal_replay_lsn() AS replay_lsn,
pg_is_in_recovery() AS in_recovery,
pg_last_wal_replay_lsn() >= '<CUTOFF_LSN>'::pg_lsn AS caught_up;预期结果
receive_lsn | replay_lsn | in_recovery | caught_up
-------------+------------+-------------+-----------
0/<VALUE> | 0/<VALUE> | t | t
(1 row)把 <CUTOFF_LSN> 替换为旧主刚才记录的实际值。只有 in_recovery = t 且 caught_up = t 时,才进入角色切换。
围栏旧主并提升备库
备库追平后,先让旧主失去业务写入可达性,例如从连接入口摘除并关闭应用访问,或按运行手册停止 PostgreSQL 服务。围栏完成后再提升备库,顺序不能反过来,否则两个实例可能短暂同时接受写入。
SELECT pg_promote(wait => true, wait_seconds => 60) AS promoted;
SELECT pg_is_in_recovery() AS in_recovery,
pg_current_wal_lsn() AS current_lsn;预期结果
promoted
----------
t
(1 row)
in_recovery | current_lsn
-------------+-------------
f | 0/<VALUE>
(1 row)promoted = t 且 in_recovery = f 表示提升已完成。此时才能把数据库连接入口切向新主;不要在提升前提前放开客户端。
切换连接并做受控验收
连接入口更新后,先用受控连接确认目标实例确实是新主,再校验一组切换前已确认提交的关键数据。最后用临时表做事务内写探针,验证新主可写且不污染业务表。
SELECT inet_server_addr() AS server_addr,
pg_is_in_recovery() AS in_recovery;
BEGIN;
CREATE TEMP TABLE switchover_probe(id integer);
INSERT INTO switchover_probe VALUES (1);
SELECT count(*) AS rows_written FROM switchover_probe;
ROLLBACK;预期结果
server_addr | in_recovery
-------------+-------------
<IP> | f
(1 row)
BEGIN
CREATE TABLE
INSERT 0 1
rows_written
--------------
1
(1 row)
ROLLBACK确认连接只指向新主、关键数据可读、受控写入成功后,才恢复正常业务写入并持续观察错误率、连接失败和复制拓扑。计划切换的安全性来自完整门禁链:写入静默后确定边界,备库重放到边界,旧主完成围栏,新主完成提升,最后才恢复客户端写入。