PostgreSQL / 系统课时
理解插入路由与跨分区更新
理解插入路由与跨分区更新
分区表的写入问题常见于两类现象:INSERT 找不到任何匹配分区,或者 UPDATE 修改分区键后行“消失”在原分区。理解父表如何路由 INSERT,以及 PostgreSQL 如何把跨边界 UPDATE 实现为行移动,就能沿着固定顺序定位边界缺口、直接写叶子分区和路由异常。
学习目标
- 通过
tableoid验证 INSERT 经父表路由到哪个叶子分区 - 复现“无匹配分区”和“直接写错误叶子分区”两类典型失败
- 验证修改分区键后的 UPDATE 会把行移动到新的目标分区
插入路由只认当前分区边界
下面创建 9 月和 10 月两个 RANGE 分区。应用应向父表 orders 写入,让执行器根据 ordered_on 自上而下选择唯一匹配的叶子分区。
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;预期输出:
partition_name | id | ordered_on
----------------+----+-------------
orders_2026_09 | 1 | 2026-09-29
(1 row)tableoid 是定位路由结果最直接的证据之一。它显示当前行实际存在哪个物理分区,而不是只看应用原本向哪个表名发起 SQL。

无匹配分区先检查边界是否缺失
如果分区键不落在任何已有分区,且没有 DEFAULT 分区,向父表 INSERT 会直接失败。下面的 11 月日期正好能复现这个问题。
INSERT INTO orders (id, ordered_on, status)
VALUES (2, DATE '2026-11-01', 'paid');预期输出:
ERROR: no partition of relation "orders" found for row
DETAIL: Partition key of the failing row contains (ordered_on) = (2026-11-01).排查时先核对实际分区键值,再查看父表已有边界。不要先怀疑索引,因为分区路由发生在行进入目标叶子分区之前,索引不会补齐缺失的分区范围。
直接写叶子分区不会替你重新路由
另一个常见误区是应用绕过父表,直接向某个叶子分区写入。此时 PostgreSQL 只检查这个分区自己的约束;即使兄弟分区能够接收该行,也不会自动把它转过去。
INSERT INTO orders_2026_09 (id, ordered_on, status)
VALUES (3, DATE '2026-10-03', 'paid');预期输出:
ERROR: new row for relation "orders_2026_09" violates partition constraint因此常规业务写入应面向分区父表。只有明确知道目标分区并愿意自行承担边界正确性时,才考虑直接访问叶子分区。
修改分区键会触发行移动
当 UPDATE 通过父表命中一行,并把分区键改到另一个已有分区的范围内时,PostgreSQL 会把它从旧分区移动到新分区。逻辑上仍是一条 UPDATE,内部效果相当于从旧分区删除并向目标分区插入新行。
UPDATE orders
SET ordered_on = DATE '2026-10-02'
WHERE id = 1
RETURNING tableoid::regclass AS partition_name, id, ordered_on;预期输出:
partition_name | id | ordered_on
----------------+----+-------------
orders_2026_10 | 1 | 2026-10-02
(1 row)
UPDATE 1如果新的分区键同样没有任何目标分区,这次 UPDATE 也会失败,原行不会因为语句失败而半途丢失。排查“更新后原分区找不到行”时,应先查父表或用 tableoid 确认它是否已经移动到别的叶子分区。
用固定证据链定位路由异常
遇到写入异常时,按“输入键值 → 分区边界 → 实际目标分区”检查最快:先确认 SQL 实际写的是父表还是叶子分区,再确认分区键最终值是否被表达式、触发器或应用转换,最后用系统目录或 tableoid 验证真实落点。对于周期分区,还应把未来分区预创建纳入发布或定时任务,避免把边界缺失暴露成线上写入错误。