↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

百科 / 配置参数 / 查询规划

CONFIGURATION PARAMETER查询规划 / 其他规划器选项

constraint_exclusion

允许规划器利用约束排除不可能匹配的表。

Enables the planner to use constraints to optimize queries.

枚举 会话 引入 9.0（基线） 现存至 20 devel 0 次默认值变更

类型
枚举enum
上下文
会话任何用户都可在会话内用 SET 修改
默认值
partition
枚举值
partition, on, off
分类
查询规划 / 其他规划器选项
引入版本
9.0（基线）
状态
现存

PostgreSQL 18 手册 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

partition 9.0 – 20

已记录的默认值在 PostgreSQL 9.0–20 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18 手册 · 19.7 查询规划 本站手册 官方原文

控制查询规划器对表约束的使用，以优化查询。constraint_exclusion的允许值是on（对所有表检查约束）、off（从不检查约束）和partition（只对继承的子表和UNION ALL子查询检查约束）。partition是默认设置。它通常与传统的继承树一起使用来提高性能。

当此参数允许对某个表使用约束排除时，规划器会比较查询条件与该表的CHECK约束，并且忽略那些条件违反约束的表扫描。例如：

CREATE TABLE parent(key integer, ...);
CREATE TABLE child1000(check (key between 1000 and 1999)) INHERITS(parent);
CREATE TABLE child2000(check (key between 2000 and 2999)) INHERITS(parent);
...
SELECT * FROM parent WHERE key = 2400;

在启用约束排除时，这个SELECT将完全不会扫描child1000，从而提高性能。

目前，约束排除仅在通常用于通过继承树实现表分区的情况下默认启用。为所有表启用它会增加额外的规划开销，这在简单查询上相当明显，而且通常不会为简单查询带来好处。如果没有通过传统继承方式进行分区的表，你可能希望完全关闭它。（注意，分区表的等效功能由另一个参数enable_partition_pruning控制。）

更多关于使用约束排除实现分区的信息请参阅第 5.12.5 节。

机制详解

constraint_exclusion 允许规划器把查询谓词与 CHECK 约束比较，并排除约束可证明不可能匹配的关系。partition 只对传统继承子表和 UNION ALL 分支执行该工作；它与声明式分区裁剪不同。

证明发生在规划阶段，因此更广泛地开启会增加规划工作，即使最终没有关系可排除。它依赖规划器可见且与查询条件逻辑矛盾的约束。

对声明式分区表，enable_partition_pruning 才是主要开关。constraint_exclusion 仍适用于继承式分区以及精心构造、由约束支撑的 UNION ALL 视图。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

  • OLTP在线事务处理

    除非代表性计划显示可重复的全负载问题，否则保留 constraint_exclusion 上游默认值。先测试局部覆盖，并同时计入规划延迟与执行延迟。

  • OLAP分析与批处理

    分析 SQL 的连接、游标或递归规模更大，constraint_exclusion 的影响可能更明显。应测试完整语句族并检查估算，不要照搬一次成功的取值。

  • 小规格低配实例与开发机

    小主机上不要在无实测收益时通过 constraint_exclusion 增加规划搜索或内存压力。优先调整查询结构或使用限定角色设置，而不是集群级覆盖。

常见问题

  • 把 constraint_exclusion 当作执行器资源上限，而不是规划假设或策略。
  • 只测试一组参数值或一种数据分布。
  • 期待已经缓存的计划自动重写。
  • 用全局覆盖掩盖陈旧统计信息或脆弱 SQL 结构。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

版本 默认值单位上下文类型最小值最大值枚举值
9.0 partition — 会话 枚举 — — partition, on, off
9.1 partition — 会话 枚举 — — partition, on, off
9.2 partition — 会话 枚举 — — partition, on, off
9.3 partition — 会话 枚举 — — partition, on, off
9.4 partition — 会话 枚举 — — partition, on, off
9.5 partition — 会话 枚举 — — partition, on, off
9.6 partition — 会话 枚举 — — partition, on, off
10 partition — 会话 枚举 — — partition, on, off
11 partition — 会话 枚举 — — partition, on, off
12 partition — 会话 枚举 — — partition, on, off
13 partition — 会话 枚举 — — partition, on, off
14 partition — 会话 枚举 — — partition, on, off
15 partition — 会话 枚举 — — partition, on, off
16 partition — 会话 枚举 — — partition, on, off
17 partition — 会话 枚举 — — partition, on, off
18 partition — 会话 枚举 — — partition, on, off
19 partition — 会话 枚举 — — partition, on, off
20 沿用 partition — 会话 枚举 — — partition, on, off

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Query Tuning 查询规划 8 个 ↗
其他规划器选项 8
constraint_exclusion 枚举 会话 partition —
允许规划器利用约束排除不可能匹配的表。 现存
cursor_tuple_fraction 浮点 会话 0.1 —
设置规划器对游标实际取回行比例的估计。 现存
default_statistics_target 整数 会话 100 —
设置未单独指定目标值的列所使用的默认统计目标。 现存
from_collapse_limit 整数 会话 8 —
设置不再折叠子查询的 FROM 列表规模阈值。 现存
jit 布尔 会话 on 192 次
在 JIT 可用且成本规则选中查询时允许即时编译。 现存
join_collapse_limit 整数 会话 8 —
设置不再展平 JOIN 构造的 FROM 列表规模阈值。 现存
plan_cache_mode 枚举 会话 auto —
控制规划器选择自定义计划还是通用计划。 现存
recursive_worktable_factor 浮点 会话 10 —
设置递归查询工作表平均大小的规划器估计倍数。 现存