PostgreSQL / 系统课时
识别发布端与订阅端角色
识别发布端与订阅端角色
建立 PostgreSQL 逻辑复制时,最容易混淆的不是 SQL,而是对象到底属于哪一端。本篇把 Publisher、Publication、Subscriber、Subscription 和复制槽放到同一条链路中,说明谁定义数据范围、谁保存连接配置、谁保留 WAL,以及一次变更怎样真正到达目标表。
学习目标
- 说清 Publisher、Publication、Subscriber、Subscription 与复制槽各自所在位置
- 理解一条源端数据变更从 WAL 到订阅端表的传递路径
- 能通过系统目录确认 Publication、Subscription 和逻辑复制槽是否建立正确
五个角色并不在同一层
Publisher 是产生业务数据变更的 PostgreSQL 数据库,也是逻辑解码发生的一侧。Publication 创建在 Publisher 数据库内部,用来描述“哪些表的哪些变更允许被发布”,它更像数据范围声明,而不是网络连接。
Subscriber 是接收并应用这些变更的目标 PostgreSQL 数据库。Subscription 创建在 Subscriber 中,保存发布端连接信息、要订阅的 Publication 名称以及订阅状态,并由订阅端相关工作进程负责拉取和应用变化。
复制槽则位于 Publisher。对于常见的内置逻辑复制订阅,它负责维护消费位置并防止发布端过早清理订阅者尚未读取的 WAL。它不是 Subscription 的别名,也不位于目标库。

一条变更怎样穿过这条链路
当业务在 Publisher 上更新已发布的表时,事务首先正常写入数据库并产生 WAL。逻辑解码读取相应 WAL,把底层变化转换为逻辑变更记录;Publication 决定这些表和操作是否属于发布范围。
Subscriber 上的 Subscription 与发布端建立复制连接。发布端依据对应逻辑复制槽的位置发送尚未消费的变化,Subscriber 的 apply worker 接收事务并在目标表执行相应的数据修改。成功处理后,复制进度推进,Publisher 才能逐步释放不再需要的旧 WAL。
首次创建 Subscription 时,如果启用了默认的初始复制行为,目标端还会先复制 Publication 中现有的表数据,并在之后与持续增量同步衔接。它解决的是“先有一份基线,再追之后的变化”,而不是只从创建订阅那一刻开始接收新记录。
用系统目录确认对象在哪一端
配置完成后,不要只凭 CREATE 命令没有报错就判断复制关系正常。可以分别在 Publisher 和 Subscriber 查询系统目录,确认对象的位置和依赖关系。
在 Publisher 执行:
SELECT pubname, pubinsert, pubupdate, pubdelete, pubtruncate
FROM pg_publication
ORDER BY pubname;
SELECT slot_name, slot_type, active
FROM pg_replication_slots
WHERE slot_type = 'logical'
ORDER BY slot_name;预期结果
pg_publication 中能够看到已创建的 Publication 及其发布操作范围。
pg_replication_slots 中能够看到对应逻辑复制槽;订阅连接工作时 active 通常为 true。在 Subscriber 执行:
SELECT subname, subenabled, subslotname
FROM pg_subscription
ORDER BY subname;预期结果
能够看到已创建的 Subscription,并确认它是否启用以及关联的复制槽名称。如果这些查询返回零行,不一定代表 PostgreSQL 异常,而是说明当前数据库中还没有相应对象。尤其要注意 pg_subscription 应在订阅数据库查询,而逻辑复制槽应到发布端查询,否则很容易因为查错实例而误判配置失败。
Publication 决定发布什么
Publication 可以包含一张表、多张表或符合配置方式的表集合,并能控制发布的操作类型。它不会自动复制表定义,因此 Subscriber 上通常需要先存在结构兼容的目标表。逻辑复制按列和数据变更工作,源表与目标表不要求拥有完全相同的物理存储布局,但复制涉及的列必须能够正确映射和写入。
对于 UPDATE 和 DELETE,发布端还必须能够识别被修改或删除的目标行。主键通常可以承担这个职责;如果表没有合适的复制标识,就需要评估 REPLICA IDENTITY 设置,否则某些更新或删除无法按预期发布。
Subscription 负责连接与应用
Subscription 是订阅端的控制对象。创建它时需要提供 Publisher 的连接信息以及 Publication 名称。正常情况下,PostgreSQL 会为订阅建立或使用一个发布端逻辑复制槽,并启动相应工作进程完成初始数据同步和后续增量应用。
因此排查复制故障时可以按链路定位:先确认 Publication 是否包含目标表,再确认 Subscription 是否启用和能够连接,随后检查 Publisher 上复制槽是否存在且有活动,最后检查 Subscriber 的复制状态与目标表数据。
掌握这五个角色后,可以把逻辑复制简化成一句话:Publisher 产生变化,Publication 定义发布范围,Publisher 上的复制槽守住消费位置,Subscription 建立订阅关系,Subscriber 最终应用变化。 后续无论配置初始同步、监控延迟还是设计迁移切换,都应沿着这条链路定位责任对象。