PostgreSQL / 系统课时
逻辑复制与在线迁移
逻辑复制与在线迁移
逻辑复制可以把指定表持续同步到另一套 PostgreSQL。在线迁移时先复制历史数据,再追平增量,最后用很短的停写窗口完成切换。本节用发布与订阅走完准备、同步、验证和切流,并处理 DDL、序列与副本标识边界。
学习目标
- 创建 publication 与 subscription,实现选择性逻辑复制
- 验证初始数据复制和后续增量是否追平
- 设计低停机切换,并处理 DDL、序列和副本标识边界
先确认源库具备逻辑复制条件
源库必须启用逻辑 WAL,并为复制槽和发送进程保留足够资源。修改参数后是否需要重启取决于参数本身,其中 wal_level 的变更需要重启生效。
先在源库验证关键设置:
SHOW wal_level;
SHOW max_replication_slots;
SHOW max_wal_senders;预期输出:wal_level 应为 logical,另外两个值至少要覆盖计划中的订阅数量和复制连接。
wal_level
-----------
logical
max_replication_slots
-----------------------
<VALUE>
max_wal_senders
-----------------
<VALUE>目标库不会通过逻辑复制自动获得表结构,因此要先创建兼容的 schema、表、类型和必要索引。对于需要复制 UPDATE、DELETE 的表,最好有主键;没有合适键时可以设置 REPLICA IDENTITY FULL,但会增加更新和删除时的匹配成本。
建立发布与订阅
假设要迁移 public.orders。先在源库创建只包含该表的发布:
CREATE PUBLICATION app_migration_pub
FOR TABLE public.orders;预期输出:
CREATE PUBLICATION然后在目标库创建订阅。copy_data = true 会先复制已有行,再继续消费发布端产生的增量变更:
CREATE SUBSCRIPTION app_migration_sub
CONNECTION 'host=<IP> port=<PORT> dbname=app user=repl_user password=<VALUE>'
PUBLICATION app_migration_pub
WITH (copy_data = true, enabled = true);预期输出:
CREATE SUBSCRIPTION
逻辑复制按表选择数据,适合分批迁移或版本升级;它不是物理副本,因此目标端可以使用不同实例布局,也可以只订阅业务需要的表。
观察同步是否持续推进
在目标库查看订阅工作进程和接收到的 WAL 位置:
SELECT
subname,
pid,
received_lsn,
latest_end_lsn
FROM pg_stat_subscription;预期输出:订阅正常工作时会看到进程 PID 和不断推进的 LSN;实际值随环境变化。
subname | pid | received_lsn | latest_end_lsn
--------------------+--------+--------------+---------------
app_migration_sub | <PID> | <VALUE> | <VALUE>
(1 row)除了系统视图,还应做业务级验证,例如比较关键表行数、抽样主键和最近更新时间。单纯看到订阅进程存在,不代表目标数据一定满足切流条件。
用短暂停写完成最终切换
最终切换时先让应用停止对源库写入,记录源库最终 WAL 位置,再等待目标订阅追到该位置。源库可执行:
SELECT pg_current_wal_lsn() AS final_source_lsn;预期输出:
final_source_lsn
------------------
<VALUE>
(1 row)随后在目标库重复检查 pg_stat_subscription.latest_end_lsn,确认它已经追到最终位置,并通过只读业务校验确认关键数据一致。完成验证后,把应用写连接切到目标库,再恢复写流量。
如果业务表使用 serial 或 identity 背后的序列,还要单独校准序列值,因为逻辑复制不会替你推进目标端序列。停写后可在目标库执行:
SELECT setval(
pg_get_serial_sequence('public.orders', 'id'),
GREATEST((SELECT max(id) FROM public.orders), 1),
true
);预期输出:返回目标序列被设置到的值。
setval
--------
<VALUE>
(1 row)迁移完成后再收尾
确认应用已经稳定使用目标库后,可以先保留源库为只读回退点一段时间,再按变更计划清理订阅、复制槽和发布。不要在刚切流后立刻删除所有回退路径。
逻辑复制最容易遗漏的三件事是:DDL 不自动复制、序列值不自动同步、没有合适副本标识的表无法高效复制更新与删除。把这三项与“最终停写后追平 LSN”一起纳入切换清单,才能把在线迁移从“数据大致同步”提升到可验收的生产流程。