PostgreSQL / 系统课时

完成序列与数据最终校验

完成序列与数据最终校验

逻辑复制追平表数据并不等于目标库已经能安全接管写流量。切换前还要冻结源库写入、同步序列状态,并用结构化校验确认两端关键数据一致,避免接管后出现主键冲突或业务结果漂移。

学习目标

  • 建立切换临界点的写入冻结与复制追平门禁。
  • 正确同步序列的 last_value 与 is_called 状态。
  • 用计数、抽样和业务关键查询判断目标库是否可接管。

建立最终一致窗口

最终校验必须在“源库不再产生新业务写入”的窗口内执行。先在应用层关闭写入口或进入维护模式,再等待逻辑复制追平;此时目标库也不要提前接受业务写入,否则两端会重新产生分叉。

PostgreSQL 逻辑复制会复制表中由 serial 或 identity 列产生的值,但不会同步背后的序列状态。因此,表数据追平之后还必须单独处理序列。

sql
SELECT pg_current_wal_lsn() AS freeze_lsn;

预期输出

text
 freeze_lsn
------------
 <VALUE>

在目标库检查订阅 worker 是否仍正常运行,并观察上游已报告的最新 WAL 位置。实际的 LSN 和时间值会因环境而不同。

sql
SELECT subname, pid, latest_end_lsn, latest_end_time
FROM pg_stat_subscription
ORDER BY subname, pid;

预期输出

text
    subname    |  pid  | latest_end_lsn |    latest_end_time
---------------+-------+----------------+------------------------
 migration_sub | <PID> | <VALUE>        | <TIME>

应把冻结时记录的源端 LSN 与订阅进度结合业务写入停止时间判断,并确认订阅没有报错、关键表已完成初始同步。只看“worker 存在”不足以证明数据已经满足切换条件。

低停机切换最终校验门禁

同步每个业务序列

序列同步要保留两个状态:last_value 表示当前保存值,is_called 决定下一次 nextval 是返回当前值还是先递增。不要只用目标表的 MAX(id) 粗暴覆盖,因为源序列可能因回滚、缓存或提前取号而领先于表中最大主键。

先在源库读取每个业务序列的真实状态。下面以订单主键序列为例:

sql
SELECT last_value, is_called
FROM public.orders_id_seq;

预期输出

text
 last_value | is_called
------------+-----------
 <VALUE>    | t

然后在目标库使用源端结果设置同名序列。将 <VALUE> 替换为源端 last_value,将 <BOOLEAN> 替换为 true 或 false。

sql
\set seq_value <VALUE>
\set seq_called <BOOLEAN>
SELECT setval('public.orders_id_seq', :seq_value, :seq_called);
SELECT last_value, is_called
FROM public.orders_id_seq;

预期输出

text
 setval
--------
 <VALUE>

 last_value | is_called
------------+-----------
 <VALUE>    | <BOOLEAN>

用三层查询校验数据

最终数据校验不应只做一条 COUNT(*)。更可靠的做法是同时检查总体规模、关键业务分布和确定性样本,并在源库与目标库执行完全相同的 SQL。

sql
SELECT COUNT(*) AS order_count,
       MIN(id) AS min_id,
       MAX(id) AS max_id,
       COALESCE(SUM(total_amount), 0) AS total_amount
FROM public.orders;

SELECT status, COUNT(*) AS rows_per_status
FROM public.orders
GROUP BY status
ORDER BY status;

SELECT id, customer_id, status, total_amount, updated_at
FROM public.orders
ORDER BY id DESC
LIMIT 20;

预期结果

text
源库与目标库的 order_count、min_id、max_id、total_amount 完全一致;
每个 status 的 rows_per_status 完全一致;
按 id 倒序取得的 20 条记录逐列一致。
实际计数、金额、ID 与时间值以当前业务数据为准。

计数相同仍可能掩盖“少一行又多一行”的问题,所以必须保留聚合分布和抽样比对。资金、库存、账户余额等高风险表还应加入对应的业务不变量查询,例如余额总额、未完成订单数或库存占用量。

设定可接管的放行门槛

只有以下条件同时满足才进入连接切换:源库写入口已冻结且没有遗漏的长事务;订阅处于健康状态并追平冻结点;全部业务序列已按源端最终状态同步;关键表计数、聚合和抽样结果一致。

如果任一项失败,应保持应用写入关闭并继续修复,而不是先把流量切到目标库再观察。真正的低停机来自把验证压缩到确定的切换窗口,而不是省略最终一致性检查。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成序列与数据最终校验

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

登录哪都通