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

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

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

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

constraint_exclusion

控制查询规划器对表约束的使用，以优化查询。

Enables the planner to use constraints to optimize queries.

枚举 会话 引入 8.1 现存至 20 devel 0 次默认值变更

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

PostgreSQL 18.7 手册 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

partition 9.0 – 19

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

手册说明

PostgreSQL 18.7 手册 · 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 8.4 ← 8.3 属性变更

    类型 布尔 枚举

  2. PostgreSQL 8.1 ← 8.0 新增此参数

    PostgreSQL 8.1 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
8.1 — — — 布尔 — — —
8.2 — — — 布尔 — — —
8.3 — — — 布尔 — — —
8.4 — — — 枚举 — — —
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 — — — 枚举 — — —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Query Tuning 查询规划 8 个 ↗
其他规划器选项 8
constraint_exclusion 枚举 会话 partition 8.41 次
控制查询规划器对表约束的使用，以优化查询。 现存
cursor_tuple_fraction 浮点 会话 0.1 —
设置规划器对将被检索的一个游标的行的比例的估计。 现存
default_statistics_target 整数 会话 100 —
为没有通过 ALTER TABLE SET STATISTICS 设置列相关目标的表列设置默认统计目标。 现存
from_collapse_limit 整数 会话 8 —
如果生成的 FROM 列表不超过这么多项，规划器将把子查询融合到上层查询。 现存
jit 布尔 会话 on 192 次
决定如果可用（见第 30 章），PostgreSQL 是否可以使用 JIT 编译。 现存
join_collapse_limit 整数 会话 8 —
如果得出的列表中不超过这么多项，那么规划器将把显式 JOIN（除了 FULL JOIN）结构重写到 FROM 项列表中。 现存
plan_cache_mode 枚举 会话 auto —
预备语句（无论是显式预备的，还是由 PL/pgSQL 等隐式生成的）可以使用自定义计划或通用计划执行。 现存
recursive_worktable_factor 浮点 会话 10 —
设置规划器对递归查询的工作表的平均大小的估计值，作为查询初始非递归项的估计大小的倍数。 现存