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 发布,用系统目录先看分区树,再切换并确认发布参数。

sql
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';

预期结果

text
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。

切换前至少验证三件事:发布参数与设计一致、目标端存在覆盖当前写入范围的分区、参与更新删除的表具有可用行标识。只要把“发布关系是谁”和“目标端如何路由”分开检查,源端与目标端的分区结构就不必被误认为必须逐分区一模一样。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理分区表复制语义

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

登录哪都通