PostgreSQL / 系统课时
排查路由与边界错误
排查路由与边界错误
月初写入报“找不到分区”,应先核对失败值和真实边界,再决定补建还是修正时间口径。本课复现缺少月份的路由错误,检查目录中的边界,补建后验证重试,并处理 DEFAULT 分区已经接住数据时的另一条路径。
学习目标
- 用失败值、时间类型和实际边界定位路由错误
- 区分缺分区、重叠边界与 DEFAULT 数据冲突
- 补齐路由后验证写入并建立提前预警
保存失败请求的关键值
示例使用 PostgreSQL 18 独立练习库。先创建仅覆盖一月的日期分区:
CREATE TABLE route_events_lab (day date NOT NULL, id bigint NOT NULL)
PARTITION BY RANGE (day);
CREATE TABLE route_events_lab_jan PARTITION OF route_events_lab
FOR VALUES FROM ('2026-01-01') TO ('2026-02-01');
INSERT INTO route_events_lab VALUES ('2026-01-31', 1);
SELECT tableoid::regclass, day, id FROM route_events_lab;预期结果:成功写入 1 行,目标为 route_events_lab_jan。接着单独执行失败用例:
INSERT INTO route_events_lab VALUES ('2026-02-01', 2);预期结果:报没有匹配分区,SQLSTATE 为 23514,写入未成功。错误文本受服务端语言影响,不逐字匹配中文或英文。若在显式事务中运行,事务会进入错误状态,先 ROLLBACK 再排查;本例使用自动提交。
保存真实参数类型、值、时区、目标父表与请求 ID,避免只留下“月初报错”。日志对敏感字段应脱敏;不能用整个业务 payload 代替必要的路由证据。
读目录里的真实边界
SELECT c.oid::regclass AS child,
pg_get_expr(c.relpartbound, c.oid) AS bound,
i.inhdetachpending
FROM pg_inherits i
JOIN pg_class c ON c.oid = i.inhrelid
WHERE i.inhparent = 'route_events_lab'::regclass
ORDER BY c.oid::regclass::text;预期结果:只有一月节点,边界下限为 2026-01-01、上限为 2026-02-01,pending 为 f。表名带 feb 不代表边界就是二月,实际以目录表达式为准;若有多级分区,继续检查命中的中间节点和叶子覆盖。
RANGE 的上界不包含本身,2026-02-01 必须由下一个分区接收。重叠边界会在建分区时被拒绝;这与已有分区之间留空洞导致写入失败不同。规则见 分区路由说明。
补齐后用原始边界值重试
CREATE TABLE route_events_lab_feb PARTITION OF route_events_lab
FOR VALUES FROM ('2026-02-01') TO ('2026-03-01');
INSERT INTO route_events_lab VALUES ('2026-02-01', 2);
SELECT id, tableoid::regclass AS partition
FROM route_events_lab ORDER BY id;预期结果:创建成功,id=1 在一月,id=2 在二月。生产重试前要确认第一次请求没有部分业务副作用,使用幂等键或明确的事务边界,避免数据库修好后产生重复订单。
若分区键是 timestamptz,应比较时间点,确认应用传入的时区与边界时区一致。若允许 NULL,RANGE 普通范围不能接收 NULL,需明确 NOT NULL 或合适兜底策略;本例用 NOT NULL 提前拒绝缺失日期。
DEFAULT 已有数据时先搬迁
父表含 DEFAULT 分区且二月数据已落入其中时,直接创建或挂接二月分区可能因兜底数据违反新边界而失败。此时不要不断重试 DDL,也不要直接删掉兜底数据。
先统计 DEFAULT 中该范围的行数,准备符合结构与边界的独立表,设计短暂写入协调与数据搬迁,再检查 DEFAULT 已排除目标范围后挂接。校验可能扫描 DEFAULT 并持强锁,生产应把锁和扫描成本列入计划;相关行为见 ATTACH PARTITION 参考。
让覆盖检查领先于时钟
为按月分区设置至少覆盖未来两个月的准备任务,并监控最远上界、DEFAULT 增长量与 DDL 失败。保留期外的补录需要单独规则,不能简单归入“未来分区缺失”。
验收使用下界、上界前一天、精确上界、NULL 与迟到数据;发生过 pending detach 的表还需确认摘除状态。把真实边界、修复 DDL、重试结果和告警变化放进记录,才能证明持续写入已经恢复。