CONFIGURATION PARAMETER查询规划 / 遗传查询优化
geqo_threshold
设置 FROM 项达到多少时改用 GEQO。
Sets the threshold of FROM items beyond which GEQO is used.
整数 会话 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
12- 取值范围
2 – 2147483647- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 10 完全一致，下面就是同一段文字。
只有当涉及的FROM项数量至少有这么多个的时候，才使用遗传查询优化（注意一个FULL OUTER JOIN只被计为一个FROM项）。默认值是 12。对于更简单的查询，通常会使用普通的穷举搜索规划器，但是对于有很多表的查询穷举搜索会花很长时间，通常比执行一个次优的计划带来的惩罚值还要长。因此，在查询尺寸上的一个阈值是管理 GEQO 使用的一种方便的方法。
机制详解
它统计 FROM 项，在达到阈值时把符合条件的连接问题切换到 GEQO；一个 FULL OUTER JOIN 构造只算一项。
GEQO 以可能错过最佳连接顺序为代价，把规划时间控制在启发式搜索范围内。构造候选之后，它仍使用普通规划器成本模型为扫描与连接路径计价。
该值在规划阶段读取；GEQO 的随机搜索意味着计划质量会随种子与搜索预算变化。折叠阈值会改变暴露给连接搜索的关系数，因此也会影响是否越过 GEQO 阈值。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
除非实测多表连接规划时间有问题，否则保留 geqo_threshold 上游默认值。全局扩大随机搜索预算前，应先简化生成 SQL 或修复连接估算。
-
OLAP分析与批处理
对反复执行的多表报表，应在多个 geqo_seed 下测试 geqo_threshold，同时比较规划与执行时间。偶然命中的好种子不是稳定生产策略。
-
小规格低配实例与开发机
小主机上不要通过调整 geqo_threshold 消耗不成比例的规划 CPU。默认自适应取值通常比照搬大系统搜索预算更安全。
常见问题
- 只根据一次随机 GEQO 运行判断计划质量。
- 调整 GEQO 旋钮却没有考虑 geqo_threshold 与折叠阈值。
- 为微小或不稳定的执行收益付出大幅规划 CPU。
- 误以为 GEQO 保证找到全局最佳连接顺序。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | 12 |
空 |
会话 |
整数 |
2 |
2147483647 |
— |
| 9.1 | 12 |
空 |
会话 |
整数 |
2 |
2147483647 |
— |
| 9.2 | 12 |
空 |
会话 |
整数 |
2 |
2147483647 |
— |
| 9.3 | 12 |
空 |
会话 |
整数 |
2 |
2147483647 |
— |
| 9.4 | 12 |
空 |
会话 |
整数 |
2 |
2147483647 |
— |
| 9.5 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 9.6 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 10 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 11 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 12 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 13 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 14 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 15 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 16 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 17 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 18 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 19 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
| 20 沿用 | 12 |
— |
会话 |
整数 |
2 |
2147483647 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 遗传查询优化 7 | |||||
geqo |
布尔 | 会话 | on |
— | |
| 启用遗传查询优化。 | 现存 | ||||
geqo_effort |
整数 | 会话 | 5 |
— | |
| 设置 GEQO 用于推导其他参数默认值的工作强度。 | 现存 | ||||
geqo_generations |
整数 | 会话 | 0 |
— | |
| 设置 GEQO 算法迭代代数。 | 现存 | ||||
geqo_pool_size |
整数 | 会话 | 0 |
— | |
| 设置 GEQO 种群中的个体数。 | 现存 | ||||
geqo_seed |
浮点 | 会话 | 0 |
— | |
| 设置 GEQO 随机路径选择的种子。 | 现存 | ||||
geqo_selection_bias |
浮点 | 会话 | 2 |
— | |
| 设置 GEQO 种群内的选择压力。 | 现存 | ||||
geqo_threshold |
整数 | 会话 | 12 |
— | |
| 设置 FROM 项达到多少时改用 GEQO。 | 现存 | ||||