PostgreSQL / 系统课时

制定迁移切换检查单

制定迁移切换检查单

低停机迁移真正危险的不是“忘记某条命令”,而是切换前仍有未确认的复制、对象、应用或人员依赖。本课把这些依赖收敛成一张可执行检查单,并给出 PostgreSQL 侧的核验 SQL,让切换会议只处理明确的通过、阻塞与回退条件。

学习目标

  • 建立覆盖复制状态、数据库对象、应用配置、监控与人员分工的切换前检查单
  • 使用 PostgreSQL 系统视图确认订阅工作正常且表同步已进入就绪状态
  • 为每个检查项定义通过条件、负责人和阻塞切换的判定

把检查单写成可判定的门禁

检查单不是“确认一下复制正常”这样的提醒,而要让任何值班人员都能判断是否允许继续。每一项至少写清检查对象、通过条件、负责人和失败动作;没有通过条件的项目只能算备忘录,不能作为切换门禁。

检查域 必须确认的内容 通过条件
逻辑复制 Subscription、表同步、复制槽、复制延迟 订阅启用;目标表均 ready;无异常积压
数据库对象 表、索引、约束、函数、扩展、权限 目标端对象已提前创建并通过抽查
非复制状态 Sequence、DDL、Large Object 等 已制定单独同步或冻结方案
应用配置 新旧连接串、连接池、只读/写入开关 配置已发布或可在窗口内原子切换
可观测性 数据库、复制、应用错误与业务指标 仪表盘和告警可用,阈值已约定
人员与回退 执行、观察、业务确认、回退决策 角色到人,回退触发条件明确

核对订阅与表同步状态

先在订阅端确认订阅处于启用状态,并检查是否仍有表没有进入 ready 状态。下面的 SQL 适合作为切换前的固定门禁查询。

sql
SELECT subname, subenabled
FROM pg_subscription
WHERE subname = '<SUBSCRIPTION_NAME>';

SELECT srrelid::regclass AS relation_name, srsubstate
FROM pg_subscription_rel
WHERE srsubstate <> 'r'
ORDER BY 1;

预期结果

text
subname              | subenabled
---------------------+-----------
<SUBSCRIPTION_NAME>  | t

relation_name | srsubstate
--------------+-----------
(0 rows)

第二个查询返回 0 行表示该订阅记录的表均已进入 ready 状态。若仍有 srsubstate 非 r 的记录,应先查明初始化、同步或 apply worker 是否失败,而不是直接进入切换。

随后在发布端确认复制槽仍然存在且未失效,并观察它是否积压了大量待确认 WAL。

sql
SELECT slot_name,
       active,
       confirmed_flush_lsn,
       pg_size_pretty(
         pg_wal_lsn_diff(pg_current_wal_lsn(), confirmed_flush_lsn)
       ) AS pending_wal
FROM pg_replication_slots
WHERE slot_name = '<SLOT_NAME>';

预期结果

text
slot_name   | active | confirmed_flush_lsn | pending_wal
------------+--------+---------------------+------------
<SLOT_NAME> | t      | <LSN>               | <VALUE>

pending_wal 没有通用的固定阈值,应以迁移演练得到的追平速度和允许切换窗口判断。若复制槽不存在、长期不活跃或积压明显超过演练基线,都应视为阻塞项。

核对目标库对象与应用入口

逻辑复制负责的是已发布表的数据变化,不会替你完成目标库的所有结构准备。至少抽查关键表的主键或唯一约束、必要索引、扩展、函数和应用账号权限;涉及 UPDATE 或 DELETE 的发布表尤其要确认目标端具备正确的 replica identity 条件。

应用侧则要把“切到新库”拆成可回退的动作:准备目标连接配置、明确旧连接池何时停止接新写请求、确认新连接池如何预热,并定义切换后第一批业务探针。不要在窗口内临时修改大量环境变量或手工拼接连接串。

把监控和人员也纳入门禁

切换会议开始前,应让数据库负责人盯复制位置与数据库错误,应用负责人盯连接池和请求错误,业务负责人验证关键交易,另指定一人拥有继续或回退的最终决策权。多人同时“负责全部”通常等于关键时刻没人负责具体指标。

检查单最后只保留三种状态:通过、阻塞、不适用并说明原因。只要复制状态、目标对象、应用入口、监控或回退责任中仍有一项是“待确认”,就不应进入控制写入和最终追平阶段。

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

目录与阅读设置

阅读设置

17

记录一个想法

制定迁移切换检查单

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

登录哪都通