PostgreSQL / 系统课时

设计迁移回退路径

设计迁移回退路径

迁移后的回退不是“把连接串改回旧库”这么简单。真正的判断点是切换后新库是否已经产生独有写入:没有新写入时可以快速回切;一旦有新写入,就必须先冻结、补偿或反向同步,再把旧库恢复成可信写入端。

学习目标

  • 根据切换后是否产生新写入选择可执行的回退路径
  • 预置反向复制能力,避免回退时才发现增量无法补齐
  • 用数据、序列与连接验证定义回退完成条件

先判断旧库还能不能直接接管

切换完成后应把旧库视为只读候选,而不是默认的“备用主库”。如果新库尚未接受任何提交,且旧库在切换后也没有被误写,可以在验证连接和数据状态后把流量切回旧库。这个窗口通常很短,但风险最低。

只要新库已经产生订单、账户、库存等新事务,旧库就不再拥有完整状态。此时直接切回会把这些已提交事务从业务视野中“抹掉”,即使旧库本身没有报错,也属于数据丢失式回退。

迁移回退条件与执行路径

可以先用业务表的切换时间做一个“是否存在新写入”的快速信号。下面的查询应分别在旧库和新库执行;<TIME> 替换为实际切换时刻。若系统允许删除或原地覆盖,时间戳只能作为辅助判断,还必须结合审计、Outbox 或 CDC 记录。

sql
SELECT
    count(*) AS total_rows,
    count(*) FILTER (
        WHERE updated_at >= TIMESTAMPTZ '<TIME>'
    ) AS changed_after_cutover,
    max(updated_at) AS latest_update
FROM public.orders;

预期结果

text
 total_rows | changed_after_cutover | latest_update
------------+-----------------------+----------------
 <VALUE>    | <VALUE>               | <TIME>
(1 row)

如果新库的 changed_after_cutover 大于旧库,或抽样主键在旧库不存在,就不能按“无新写入”路径回切。

预置能覆盖新写入的回退通道

需要支持“切换后仍可回退”时,反向通道必须在新库开放写入前就准备好。做法是让新库具备发布能力,在旧库创建一个默认禁用、copy_data = false 的反向订阅。这样复制槽会从预置时点开始保留后续 WAL,而不会重新全量复制已有表数据。

下面用 rollback_pub 和 rollback_sub 作为示例名称。执行前要保证新库已启用逻辑复制所需配置,复制账号能读取发布表,旧库表结构与主键/Replica Identity 仍与新库兼容。

sql
-- 在新库执行
CREATE PUBLICATION rollback_pub
FOR TABLE public.orders, public.order_items;

-- 在旧库执行,并在新库开放业务写入前完成
CREATE SUBSCRIPTION rollback_sub
CONNECTION 'host=<IP> port=<PORT> dbname=app user=replicator password=<VALUE>'
PUBLICATION rollback_pub
WITH (copy_data = false, enabled = false);

预期输出

text
CREATE PUBLICATION
CREATE SUBSCRIPTION

创建后应在新库确认反向复制槽存在且尚未被消费。默认情况下,自动创建的槽名与订阅名一致。

sql
SELECT slot_name, active, restart_lsn, confirmed_flush_lsn
FROM pg_replication_slots
WHERE slot_name = 'rollback_sub';

预期结果

text
  slot_name   | active | restart_lsn | confirmed_flush_lsn
--------------+--------+-------------+---------------------
 rollback_sub | f      | <VALUE>     | <VALUE>
(1 row)

禁用订阅并不等于“没有成本”:反向槽会保留尚未消费的 WAL,所以回退窗口必须有明确时限,并持续监控磁盘与槽的滞后量。

带新写入时按冻结、回灌、验证执行

真正触发回退时,先停止新库写入并排空在途请求,再停止旧库到新库的正向订阅,避免两个方向同时修改同一批表。随后才启用已经预置的反向订阅,把切换后的增量应用回旧库。

sql
-- 在新库:停止旧库到新库的正向订阅
ALTER SUBSCRIPTION migration_sub DISABLE;

-- 在旧库:开始消费切换后由新库产生的增量
ALTER SUBSCRIPTION rollback_sub ENABLE;

预期输出

text
ALTER SUBSCRIPTION
ALTER SUBSCRIPTION

执行顺序应保持固定:

  1. 冻结新库写入,等待应用事务、队列消费者和批处理进入可控状态。
  2. 记录切换时间、关键业务计数、反向槽位置和待补偿事件范围。
  3. 停止正向复制,再启用反向复制或执行经过审计的增量补偿。
  4. 等待旧库追平,并对关键表做总量、金额、状态分布和关键主键抽样。
  5. 校准由序列生成的主键,再把应用连接切回旧库。
  6. 旧库恢复写入后,将新库保持只读观察,确认故障已消除再结束回退窗口。

如果反向订阅是在故障发生后才创建,它无法自动补回创建槽之前已经提交到新库的历史增量。此时必须从可靠的审计表、Outbox、CDC 日志或业务流水中提取差异并幂等重放;若无法证明增量集合完整,前向修复通常比盲目回退安全。

把回退完成定义成可验收状态

回退不能以“应用能连上旧库”为结束条件。至少要确认反向增量已经追平、关键业务对账一致、序列不会生成已存在的键,并核对迁移期间的 DDL 是否已在旧库同步执行。PostgreSQL 逻辑复制不会替你同步所有序列状态和 DDL,这两项必须单独纳入清单。

最终放开写入前,还应完成一轮最小读写冒烟:创建一条可识别测试数据、读取并更新它,再确认下游任务和连接池都指向旧库。只有数据面、连接面和业务面同时通过,旧库才真正重新成为可信写入端。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计迁移回退路径

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

登录哪都通