PostgreSQL / 系统课时

理解插入路由与跨分区更新

理解插入路由与跨分区更新

分区表的写入问题常见于两类现象:INSERT 找不到任何匹配分区,或者 UPDATE 修改分区键后行“消失”在原分区。理解父表如何路由 INSERT,以及 PostgreSQL 如何把跨边界 UPDATE 实现为行移动,就能沿着固定顺序定位边界缺口、直接写叶子分区和路由异常。

学习目标

  • 通过 tableoid 验证 INSERT 经父表路由到哪个叶子分区
  • 复现“无匹配分区”和“直接写错误叶子分区”两类典型失败
  • 验证修改分区键后的 UPDATE 会把行移动到新的目标分区

插入路由只认当前分区边界

下面创建 9 月和 10 月两个 RANGE 分区。应用应向父表 orders 写入,让执行器根据 ordered_on 自上而下选择唯一匹配的叶子分区。

sql
DROP TABLE IF EXISTS orders CASCADE;

CREATE TABLE orders (
    id bigint NOT NULL,
    ordered_on date NOT NULL,
    status text NOT NULL
) PARTITION BY RANGE (ordered_on);

CREATE TABLE orders_2026_09 PARTITION OF orders
FOR VALUES FROM ('2026-09-01') TO ('2026-10-01');

CREATE TABLE orders_2026_10 PARTITION OF orders
FOR VALUES FROM ('2026-10-01') TO ('2026-11-01');

INSERT INTO orders (id, ordered_on, status)
VALUES (1, DATE '2026-09-29', 'paid');

SELECT tableoid::regclass AS partition_name, id, ordered_on
FROM orders
WHERE id = 1;

预期输出:

text
 partition_name | id | ordered_on
----------------+----+-------------
 orders_2026_09 |  1 | 2026-09-29
(1 row)

tableoid 是定位路由结果最直接的证据之一。它显示当前行实际存在哪个物理分区,而不是只看应用原本向哪个表名发起 SQL。

INSERT 路由与跨分区 UPDATE 的执行路径

无匹配分区先检查边界是否缺失

如果分区键不落在任何已有分区,且没有 DEFAULT 分区,向父表 INSERT 会直接失败。下面的 11 月日期正好能复现这个问题。

sql
INSERT INTO orders (id, ordered_on, status)
VALUES (2, DATE '2026-11-01', 'paid');

预期输出:

text
ERROR:  no partition of relation "orders" found for row
DETAIL:  Partition key of the failing row contains (ordered_on) = (2026-11-01).

排查时先核对实际分区键值,再查看父表已有边界。不要先怀疑索引,因为分区路由发生在行进入目标叶子分区之前,索引不会补齐缺失的分区范围。

直接写叶子分区不会替你重新路由

另一个常见误区是应用绕过父表,直接向某个叶子分区写入。此时 PostgreSQL 只检查这个分区自己的约束;即使兄弟分区能够接收该行,也不会自动把它转过去。

sql
INSERT INTO orders_2026_09 (id, ordered_on, status)
VALUES (3, DATE '2026-10-03', 'paid');

预期输出:

text
ERROR:  new row for relation "orders_2026_09" violates partition constraint

因此常规业务写入应面向分区父表。只有明确知道目标分区并愿意自行承担边界正确性时,才考虑直接访问叶子分区。

修改分区键会触发行移动

当 UPDATE 通过父表命中一行,并把分区键改到另一个已有分区的范围内时,PostgreSQL 会把它从旧分区移动到新分区。逻辑上仍是一条 UPDATE,内部效果相当于从旧分区删除并向目标分区插入新行。

sql
UPDATE orders
SET ordered_on = DATE '2026-10-02'
WHERE id = 1
RETURNING tableoid::regclass AS partition_name, id, ordered_on;

预期输出:

text
 partition_name | id | ordered_on
----------------+----+-------------
 orders_2026_10 |  1 | 2026-10-02
(1 row)

UPDATE 1

如果新的分区键同样没有任何目标分区,这次 UPDATE 也会失败,原行不会因为语句失败而半途丢失。排查“更新后原分区找不到行”时,应先查父表或用 tableoid 确认它是否已经移动到别的叶子分区。

用固定证据链定位路由异常

遇到写入异常时,按“输入键值 → 分区边界 → 实际目标分区”检查最快:先确认 SQL 实际写的是父表还是叶子分区,再确认分区键最终值是否被表达式、触发器或应用转换,最后用系统目录或 tableoid 验证真实落点。对于周期分区,还应把未来分区预创建纳入发布或定时任务,避免把边界缺失暴露成线上写入错误。

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

目录与阅读设置

记录一个想法

理解插入路由与跨分区更新

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

登录哪都通