PostgreSQL / 系统课时
制定迁移切换检查单
制定迁移切换检查单
低停机迁移真正危险的不是“忘记某条命令”,而是切换前仍有未确认的复制、对象、应用或人员依赖。本课把这些依赖收敛成一张可执行检查单,并给出 PostgreSQL 侧的核验 SQL,让切换会议只处理明确的通过、阻塞与回退条件。
学习目标
- 建立覆盖复制状态、数据库对象、应用配置、监控与人员分工的切换前检查单
- 使用 PostgreSQL 系统视图确认订阅工作正常且表同步已进入就绪状态
- 为每个检查项定义通过条件、负责人和阻塞切换的判定
把检查单写成可判定的门禁
检查单不是“确认一下复制正常”这样的提醒,而要让任何值班人员都能判断是否允许继续。每一项至少写清检查对象、通过条件、负责人和失败动作;没有通过条件的项目只能算备忘录,不能作为切换门禁。
| 检查域 | 必须确认的内容 | 通过条件 |
|---|---|---|
| 逻辑复制 | Subscription、表同步、复制槽、复制延迟 | 订阅启用;目标表均 ready;无异常积压 |
| 数据库对象 | 表、索引、约束、函数、扩展、权限 | 目标端对象已提前创建并通过抽查 |
| 非复制状态 | Sequence、DDL、Large Object 等 | 已制定单独同步或冻结方案 |
| 应用配置 | 新旧连接串、连接池、只读/写入开关 | 配置已发布或可在窗口内原子切换 |
| 可观测性 | 数据库、复制、应用错误与业务指标 | 仪表盘和告警可用,阈值已约定 |
| 人员与回退 | 执行、观察、业务确认、回退决策 | 角色到人,回退触发条件明确 |
核对订阅与表同步状态
先在订阅端确认订阅处于启用状态,并检查是否仍有表没有进入 ready 状态。下面的 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;预期结果
subname | subenabled
---------------------+-----------
<SUBSCRIPTION_NAME> | t
relation_name | srsubstate
--------------+-----------
(0 rows)第二个查询返回 0 行表示该订阅记录的表均已进入 ready 状态。若仍有 srsubstate 非 r 的记录,应先查明初始化、同步或 apply worker 是否失败,而不是直接进入切换。
随后在发布端确认复制槽仍然存在且未失效,并观察它是否积压了大量待确认 WAL。
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>';预期结果
slot_name | active | confirmed_flush_lsn | pending_wal
------------+--------+---------------------+------------
<SLOT_NAME> | t | <LSN> | <VALUE>pending_wal 没有通用的固定阈值,应以迁移演练得到的追平速度和允许切换窗口判断。若复制槽不存在、长期不活跃或积压明显超过演练基线,都应视为阻塞项。
核对目标库对象与应用入口
逻辑复制负责的是已发布表的数据变化,不会替你完成目标库的所有结构准备。至少抽查关键表的主键或唯一约束、必要索引、扩展、函数和应用账号权限;涉及 UPDATE 或 DELETE 的发布表尤其要确认目标端具备正确的 replica identity 条件。
应用侧则要把“切到新库”拆成可回退的动作:准备目标连接配置、明确旧连接池何时停止接新写请求、确认新连接池如何预热,并定义切换后第一批业务探针。不要在窗口内临时修改大量环境变量或手工拼接连接串。
把监控和人员也纳入门禁
切换会议开始前,应让数据库负责人盯复制位置与数据库错误,应用负责人盯连接池和请求错误,业务负责人验证关键交易,另指定一人拥有继续或回退的最终决策权。多人同时“负责全部”通常等于关键时刻没人负责具体指标。
检查单最后只保留三种状态:通过、阻塞、不适用并说明原因。只要复制状态、目标对象、应用入口、监控或回退责任中仍有一项是“待确认”,就不应进入控制写入和最终追平阶段。