PostgreSQL / 系统课时
处理分区表复制语义
处理分区表复制语义
分区表迁移最容易出错的地方不是“有没有复制到数据”,而是发布端到底以父表还是叶子分区的身份发送变更。把对象映射先固定下来,才能决定目标端是否必须复刻同名分区,以及切换分区边界时会不会让订阅应用失败。
学习目标
- 说清默认叶子分区语义与
publish_via_partition_root的差异 - 根据目标端分区布局选择稳定的发布方式
- 在建订阅前验证分区树、发布参数和更新删除所需的行标识
先确定发布端发送的是哪个关系
逻辑复制不会复制 CREATE TABLE、分区边界等 DDL,订阅端必须预先存在可接收数据的表。对分区表而言,还要确认消息携带的是叶子分区关系,还是分区根表关系;这会直接决定订阅端按哪个表名建立 relation mapping。
默认 publish_via_partition_root = false 时,叶子分区中的变更通常按叶子分区的身份发布。源端有 sales.orders_2026_08,订阅端就要有能与该已发布关系匹配的目标关系。若两端分区命名或边界不同,这种耦合会让迁移变得脆弱。
启用 publish_via_partition_root = true 后,分区内的变更按发布端分区根表的身份发送。订阅端只需要让根表关系可匹配,再由自己的分区路由把新行放入本地叶子分区,因此更适合“源端按月、目标端按周”或分区名称不同的迁移。

用根表语义降低分区结构耦合
如果迁移要求目标端可以重新规划分区,优先把发布语义固定到根表。下面的片段示例依赖已经存在的 sales.orders 分区表和 migration_pub 发布,用系统目录先看分区树,再切换并确认发布参数。
SELECT relid::regclass AS relation, isleaf, level
FROM pg_partition_tree('sales.orders'::regclass)
ORDER BY level, (relid::regclass)::text;
ALTER PUBLICATION migration_pub
SET (publish_via_partition_root = true);
SELECT pubname, pubviaroot
FROM pg_publication
WHERE pubname = 'migration_pub';预期结果
relation | isleaf | level
sales.orders | f | 0
sales.orders_2026_08 | t | 1
sales.orders_2026_09 | t | 1
ALTER PUBLICATION
pubname | pubviaroot
migration_pub | t实际分区名称和数量会不同,但根表的 level 应为 0,叶子分区应显示为 isleaf = t,并且发布最终应显示 pubviaroot = t。如果希望两端严格保持同名、同边界分区,也可以保留默认叶子语义,但必须把这种结构一致性纳入迁移验收。
对齐订阅端的分区入口
根表语义并不意味着目标端“无需分区准备”。订阅端仍要先创建根表和覆盖待迁移数据范围的分区;如果某条记录的分区键在目标端找不到可接收的分区,apply worker 会失败并停止继续应用相关变更。
还要检查列名、类型和约束。逻辑复制不是 DDL 同步工具,目标根表缺列、类型不能接收发布值、约束更严格或触发器行为不同,都可能把结构差异放大成复制错误。迁移前应分别在源端和目标端执行 pg_partition_tree(),确认两边各自的分区范围都覆盖切换窗口,而不是只比较分区数量。
更新和删除要有稳定的行标识
INSERT 主要依赖目标端分区路由;UPDATE 和 DELETE 还需要订阅端能根据复制消息中的 replica identity 找到原行。分区表常用包含分区键的主键作为稳定标识,也可以按业务需要显式设置 REPLICA IDENTITY。
切换前至少验证三件事:发布参数与设计一致、目标端存在覆盖当前写入范围的分区、参与更新删除的表具有可用行标识。只要把“发布关系是谁”和“目标端如何路由”分开检查,源端与目标端的分区结构就不必被误认为必须逐分区一模一样。