CONFIGURATION PARAMETER查询规划 / 规划器代价常量
cpu_tuple_cost
设置规划器对一次查询中处理每一行的代价估计。
Sets the planner's estimate of the cost of processing each tuple (row).
浮点 会话 引入 7.4（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 浮点real
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
0.01- 取值范围
0 – 1.79769e+308- 引入版本
- 7.4（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
已记录的默认值在 PostgreSQL 9.0–19 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
设置规划器对一次查询中处理每一行的代价估计。默认值是 0.01。
机制详解
cpu_tuple_cost 用于刻画处理一行的 CPU 工作量。它只是路径估算成本的一项，不会直接分配资源或改变执行器行为。
规划器成本单位是任意尺度，只有比例有意义。把所有成本常量同比例缩放不会改变路径排序；只改一项则会改变 I/O、行处理、操作符与并行开销之间的权衡。
生成计划时才会读取该值。统计信息、行数估计、缓存假设、tablespace 覆盖以及可用计划方法，都可能比小幅调整这个常量影响更大。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
只应依据代表性负载校准 cpu_tuple_cost，不能依据单个计划。先修复陈旧统计，并用 EXPLAIN (ANALYZE, BUFFERS) 比较估算与实际；能按角色或 tablespace 限定时不要全局修改。
-
OLAP分析与批处理
分析负载可能需要不同的 CPU 与 I/O 权衡，但应把 cpu_tuple_cost 与相关成本模型一起调整，并验证完整的扫描、连接与聚合组合。
-
小规格低配实例与开发机
除非反复证据表明存在系统性建模偏差，否则保留上游值。小系统上并发与缓存驻留通常比细调 cpu_tuple_cost 更重要。
常见问题
- 把数值解释为实际耗时或硬资源上限。
- 为修复单条查询而调整，导致更广泛负载回归。
- 在修正统计信息与基数估计之前先改成本常量。
- 忘记只有各成本项的相对值会影响路径选择。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
- 本数据集收录 cpu_tuple_cost 以来没有记录到变化。
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 7.4 | — | — | — | 浮点 |
— | — | — |
| 8.0 | — | — | — | 浮点 |
— | — | — |
| 8.1 | — | — | — | 浮点 |
— | — | — |
| 8.2 | — | — | — | 浮点 |
— | — | — |
| 8.3 | — | — | — | 浮点 |
— | — | — |
| 8.4 | — | — | — | 浮点 |
— | — | — |
| 9.0 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.1 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.2 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.3 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.4 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.5 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.6 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 10 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 11 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 12 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 13 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 14 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 15 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 16 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 17 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 18 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 19 | 0.01 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 20 | — | — | — | 浮点 |
— | — | — |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 规划器代价常量 15 | |||||
cpu_index_tuple_cost |
浮点 | 会话 | 0.005 |
— | |
| 设置规划器对一次索引扫描中处理每一个索引项的代价估计。 | 现存 | ||||
cpu_operator_cost |
浮点 | 会话 | 0.0025 |
— | |
| 设置规划器对于一次查询中处理每个操作符或函数的代价估计。 | 现存 | ||||
cpu_tuple_cost |
浮点 | 会话 | 0.01 |
— | |
| 设置规划器对一次查询中处理每一行的代价估计。 | 现存 | ||||
effective_cache_size |
整数 | 会话 | 4 GiB (524288 × 8kB) |
9.42 次 | |
| 设置规划器对一个单一查询可用的有效磁盘缓存尺寸的假设。 | 现存 | ||||
jit_above_cost |
浮点 | 会话 | 100000 |
— | |
| 设置激活 JIT 编译的查询代价，如果查询代价超过这个值就会激活 JIT 编译（如果启用了 JIT，见第 30 章）。 | 现存 | ||||
jit_inline_above_cost |
浮点 | 会话 | 500000 |
— | |
| 设置 JIT 编译尝试内联函数和操作符的查询代价阈值，如果查询代价超过这个值，JIT 编译就会尝试内联。 | 现存 | ||||
jit_optimize_above_cost |
浮点 | 会话 | 500000 |
— | |
| 设置 JIT 编译应用优化的查询代价阈值，如果查询代价超过这个值，JIT 编译就会应用开销较大的优化。 | 现存 | ||||
min_eager_agg_group_size |
浮点 | — | — | ||
| 设置考虑应用急切聚合所需的最小平均分组大小。 | 现存 | ||||
min_parallel_index_scan_size |
整数 | 会话 | 512 KiB (64 × 8kB) |
— | |
| 设置考虑使用并行扫描时必须扫描的最小索引数据量。 | 现存 | ||||
min_parallel_relation_size |
整数 | 会话 | 8 MiB (1024 × 8kB) |
— | |
| 设置为并行扫描所考虑的关系的最小尺寸。 | 于 10 移除 | ||||
min_parallel_table_scan_size |
整数 | 会话 | 8 MiB (1024 × 8kB) |
— | |
| 设置考虑使用并行扫描时必须扫描的最小表数据量。 | 现存 | ||||
parallel_setup_cost |
浮点 | 会话 | 1000 |
— | |
| 设置规划器对启动并行工作进程的代价估计。 | 现存 | ||||
parallel_tuple_cost |
浮点 | 会话 | 0.1 |
— | |
| 设置规划器对于从一个并行工作进程传递一个元组给另一个进程的代价估计。 | 现存 | ||||
random_page_cost |
浮点 | 会话 | 4 |
— | |
| 设置规划器对一次非顺序磁盘页面读取的代价估计。 | 现存 | ||||
seq_page_cost |
浮点 | 会话 | 1 |
— | |
| 设置规划器对一系列顺序磁盘页面读取中单次读取的代价估计。 | 现存 | ||||