PostgreSQL / 系统课时
迁移序列与 Identity 状态
迁移序列与 Identity 状态
逻辑复制能把表中的行持续同步到目标库,却不会自动推进序列或 Identity 背后的序列状态。本课完成一套可执行的切换流程:识别序列、在停写点采集当前值、同步到目标库,并在放量前验证不会因主键生成值落后而冲突。
学习目标
- 识别
serial、Identity 列与其底层序列的关联。 - 在低停机切换窗口中安全迁移序列当前状态。
- 验证目标序列不会生成已经存在的主键值。
为什么表数据追平了仍会主键冲突
PostgreSQL 的逻辑复制发布的是表数据变更。nextval() 对序列对象的推进不是表行变更,因此目标表即使已经追到最新,目标序列仍可能停留在初始化时的旧值。Identity 列同样依赖独立序列,只是依赖关系由 PostgreSQL 自动管理。
例如源库 orders.id 已经复制到 845721,而目标库序列仍停在 100000。切换后第一笔新订单调用 nextval(),就可能生成一个目标表里早已存在的值并触发唯一约束冲突。

找到 serial 与 Identity 对应的序列
pg_get_serial_sequence() 不只适用于传统 serial,也可以解析 Identity 列所拥有的序列。先在源库列出需要随切换同步的列和序列。
SELECT
n.nspname AS schema_name,
c.relname AS table_name,
a.attname AS column_name,
a.attidentity AS identity_kind,
pg_get_serial_sequence(
format('%I.%I', n.nspname, c.relname),
a.attname
) AS sequence_name
FROM pg_class AS c
JOIN pg_namespace AS n ON n.oid = c.relnamespace
JOIN pg_attribute AS a ON a.attrelid = c.oid
WHERE c.relkind = 'r'
AND a.attnum > 0
AND NOT a.attisdropped
AND pg_get_serial_sequence(
format('%I.%I', n.nspname, c.relname),
a.attname
) IS NOT NULL
ORDER BY 1, 2, 3;预期结果
schema_name | table_name | column_name | identity_kind | sequence_name
-------------+------------+-------------+---------------+----------------------
public | orders | id | d | public.orders_id_seqidentity_kind 为 a 表示 GENERATED ALWAYS,为 d 表示 GENERATED BY DEFAULT;传统 serial 通常为空字符串,但仍能通过最后一列找到它拥有的序列。
在停写点迁移真实序列状态
序列状态必须在源端业务停止生成新值之后采集,否则采集完成到真正切流之间仍可能发生 nextval(),目标就会再次落后。随后应等待订阅追平,再读取源序列的 last_value 与 is_called。
SELECT last_value, is_called
FROM public.orders_id_seq;预期结果
last_value | is_called
------------+-----------
845721 | t在目标库应用同一状态。第二个参数替换为刚从源库读取的值,第三个参数必须保留源端的 is_called 语义。
SELECT setval('public.orders_id_seq', 845721, true);预期结果
setval
--------
845721setval(..., value, true) 表示这个值已经被发放过,下一次 nextval() 会继续向后推进;如果源端 is_called 为 false,目标也应传 false。不要把 setval() 当成可通过事务回滚撤销的普通表更新,执行前应先核对序列名和值。
验证 Identity 不会从旧值重新开始
切换前至少验证两件事:目标表数据已经追平,目标序列状态与源端采集值一致。对于常见的正向递增主键,还可以检查序列是否落后于表中最大键值。
SELECT
(SELECT max(id) FROM public.orders) AS max_id,
last_value,
is_called
FROM public.orders_id_seq;预期结果
max_id | last_value | is_called
--------+------------+-----------
845721 | 845721 | t如果序列使用负步长、循环、非 1 步长,或者业务允许显式写入远大于序列值的主键,就不能只用 max(id) 判断,应以序列自身的起始值、步长、最小值、最大值和业务写入规则共同校验。
低停机切换的关键顺序是:先停源端写入,再等表数据追平,之后采集并同步序列状态,最后才让目标库承担新写入。只迁表数据而跳过这一步,Identity 也一样可能在切换后产生重复主键。