PostgreSQL / 系统课时

执行计划内主备切换

执行计划内主备切换

计划内主备切换要解决的不是“怎样更快提升备库”,而是怎样形成一个可证明的最终写入边界:先让旧主进入写入静默,确认切换前已提交事务的 WAL 已在备库重放,再围栏旧主、提升备库并恢复连接,避免数据缺口和双主写入。

学习目标

  • 按写入静默、边界确认、追平、旧主围栏、提升和连接恢复的顺序执行切换
  • 用已刷盘 LSN 与备库重放位置证明切换前已提交事务不存在缺口
  • 在恢复业务写入前验证新主角色、关键数据和受控写入能力

先建立真正的写入静默

计划内 Switchover 的前提是旧主仍然健康,因此必须先停止所有受控、可能产生持久 WAL 的写入来源,包括应用流量、定时任务、ETL、批处理、DDL 发布、运维脚本、人工维护以及扩展触发的写入。仅查询 pg_stat_activity 并看到“没有客户端事务”,只能证明当前没有可见的客户端事务,不能证明调度器、维护任务或其他入口不会马上再次写入。

PostgreSQL 自身后台活动仍可能产生与业务无关的 WAL,因此不要把“静默成功”理解为 LSN 从此绝对不再变化。这里的 cutoff_lsn 定义为:所有业务与运维写入入口已被冻结、在途写事务已结束,并完成一次 CHECKPOINT 后记录的已刷盘 WAL 位置。记录后立即进入旧主围栏阶段,不再允许任何业务或运维写入恢复。

计划内主备切换的安全时序

先检查是否仍有客户端事务;确认外部写入入口已经冻结后,再执行检查点并记录最终边界。

sql
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;

预期结果

text
 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 已应用到备库恢复状态。

sql
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;

预期结果

text
 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 服务。围栏完成后再提升备库,顺序不能反过来,否则两个实例可能短暂同时接受写入。

sql
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;

预期结果

text
 promoted
----------
 t
(1 row)

 in_recovery | current_lsn
-------------+-------------
 f           | 0/<VALUE>
(1 row)

promoted = t 且 in_recovery = f 表示提升已完成。此时才能把数据库连接入口切向新主;不要在提升前提前放开客户端。

切换连接并做受控验收

连接入口更新后,先用受控连接确认目标实例确实是新主,再校验一组切换前已确认提交的关键数据。最后用临时表做事务内写探针,验证新主可写且不污染业务表。

sql
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;

预期结果

text
 server_addr | in_recovery
-------------+-------------
 <IP>        | f
(1 row)

BEGIN
CREATE TABLE
INSERT 0 1
 rows_written
--------------
            1
(1 row)
ROLLBACK

确认连接只指向新主、关键数据可读、受控写入成功后,才恢复正常业务写入并持续观察错误率、连接失败和复制拓扑。计划切换的安全性来自完整门禁链:写入静默后确定边界,备库重放到边界,旧主完成围栏,新主完成提升,最后才恢复客户端写入。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行计划内主备切换

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通