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

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

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

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

jit

决定如果可用(见第 30 章),PostgreSQL 是否可以使用 JIT 编译。

Allow JIT compilation.

布尔 会话 引入 11 现存至 20 devel 2 次默认值变更

类型
布尔bool
上下文
会话任何用户都可在会话内用 SET 修改
默认值
on
引入版本
11
状态
现存

PostgreSQL 18.7 手册 官方文档 引入提交 432bb9e04d

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

off 11 on 12 – 18 off 19

默认值一共换过 3 档,每段的宽度按它覆盖的大版本数伸展,深色的一段是当前查看的 PostgreSQL 18.7。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。

手册说明

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

决定如果可用(见第 30 章),PostgreSQL 是否可以使用 JIT 编译。默认值是 on。

机制详解

jit 是总开关。开启后,jit_above_cost 决定是否开始编译,jit_inline_above_cost 与 jit_optimize_above_cost 控制额外且成本更高的内联和优化工作。

JIT 主要有利于运行时间长、CPU 密集的查询,常见于分析负载。编译本身增加延迟,因此过度降低阈值可能让短语句更慢。

决策发生在规划阶段。使用通用计划的预备语句由生成该计划时的配置决定;EXPLAIN ANALYZE 会显示 JIT 是否执行以及各阶段耗时。

调优建议

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

  • OLTP在线事务处理

    保持较高默认阈值;若短请求尾延迟中出现编译开销,可关闭 JIT。应先按语句或角色测试,再考虑全局修改。

  • OLAP分析与批处理

    保持可用,并针对 CPU 密集的聚合、表达式和扫描做基准;评估总执行时间时必须包含生成、内联、优化和代码发射开销。

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

    小型且 CPU 受限系统上的普通查询通常获益有限。保持开启并使用保守阈值,与降低阈值强制编译是两回事。

常见问题

  • 若 PostgreSQL 构建没有可用 JIT 实现,jit=on 也不会生效。
  • 开启不等于每条查询都编译,成本阈值仍会筛选。
  • 降低阈值可能让短查询比解释执行更慢。
  • 通用预备计划采用生成计划时的配置。
  • 估算成本不是执行时间,必须用代表性计划实测阈值效果。

演化历史

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

  1. PostgreSQL 19 ← 18 默认值变更

    默认值 on off

  2. PostgreSQL 12 ← 11 默认值变更

    默认值 off on

  3. PostgreSQL 11 ← 10 新增此参数

    PostgreSQL 11 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
11 off — 会话 布尔 — — —
12 on — 会话 布尔 — — —
13 on — 会话 布尔 — — —
14 on — 会话 布尔 — — —
15 on — 会话 布尔 — — —
16 on — 会话 布尔 — — —
17 on — 会话 布尔 — — —
18 on — 会话 布尔 — — —
19 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 —
设置规划器对递归查询的工作表的平均大小的估计值,作为查询初始非递归项的估计大小的倍数。 现存