PostgreSQL / 系统课时

提升备库为新主库

提升备库为新主库

当原主库已经不能继续提供写服务时,故障切换的核心动作是选择状态合格的备库执行 promote。本课完成提升操作,并用恢复状态、时间线与测试事务三类证据确认它已经成为可写的新主库。

学习目标

  • 使用 pg_promote() 或 pg_ctl promote 提升 PostgreSQL 备库
  • 理解提升后恢复结束、时间线分叉与继续生成 WAL 的关系
  • 用 SQL 验证新主库已经能够接受正常读写事务

提升前确认候选备库状态

不要因为主库失联就立即提升任意节点。候选实例至少应仍处于恢复状态,并且已确认是本次故障切换选择的目标。如果旧主仍可能接受写入,还必须先通过网络、存储或编排系统完成 fencing,避免新旧两个节点同时对外写入。

在候选备库执行:

sql
SELECT pg_is_in_recovery();
SELECT pg_last_wal_replay_lsn();

预期结果:

text
 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() 请求服务器结束恢复并完成提升:

sql
SELECT pg_promote(true, 60);

预期结果:

text
 pg_promote
------------
 t
(1 row)

第一个参数 true 表示等待提升完成,60 是最多等待的秒数。返回 t 表示服务器在等待期限内完成了提升;若返回 f,应继续检查服务器日志和恢复状态,而不能直接认为节点已经成为新主。

无法通过 SQL 执行操作时,也可以在数据库服务器上使用:

bash
pg_ctl -D <PATH> promote -w -t 60

预期输出:

text
waiting for server to promote.... done
server promoted

<PATH> 应替换为该 PostgreSQL 实例的数据目录,实际等待输出可能因版本和环境略有差异。两种方式最终触发的是同一类状态转换,生产流程通常选择更容易被自动化平台可靠执行的一种。

备库提升后恢复结束与新时间线形成的关系

验证实例已经退出恢复

提升完成后首先重新检查恢复状态和当前 WAL 位置:

sql
SELECT pg_is_in_recovery();
SELECT pg_current_wal_lsn();

预期结果:

text
 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 文件名辅助确认新主所在的时间线:

sql
SELECT pg_walfile_name(pg_current_wal_lsn()) AS wal_file;

预期结果:

text
         wal_file
--------------------------
 <WAL_FILE>
(1 row)

WAL 文件名开头的 8 个十六进制字符表示 timeline ID,<WAL_FILE> 的实际值会随当前 WAL 段变化。故障节点重新上线后不能直接恢复写流量,应先判断它与新主是否发生数据分叉,再决定使用 pg_rewind 还是重新执行基础备份。

用事务验证新主可写

退出恢复只是控制面证据,还应进行一次低风险写入验证。下面使用临时表完成事务、DDL、写入和提交检查,不会留下永久业务对象。

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

预期结果:

text
BEGIN
CREATE TABLE
INSERT 0 1
 id |    note
----+-------------
  1 | new-primary
(1 row)

COMMIT

这组结果证明新主能够开启事务、执行 DDL、产生写入并提交。开放客户端写流量前,至少应同时满足 pg_is_in_recovery() = false、新时间线已经建立、测试事务可提交以及旧主已完成隔离;随后再持续观察数据库日志、WAL 生成和客户端连接是否正常。

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

目录与阅读设置

阅读设置

17

记录一个想法

提升备库为新主库

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

登录哪都通