CONFIGURATION PARAMETER查询规划 / 规划器代价常量
random_page_cost
设置规划器对非顺序读取页面的相对成本估计。
Sets the planner's estimate of the cost of a nonsequentially fetched disk page.
浮点 会话 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 浮点real
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
4- 取值范围
0 – 1.79769e+308- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
已记录的默认值在 PostgreSQL 9.0–20 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
设置规划器对一次非顺序磁盘页面读取的代价估计。默认值是 4.0。对于某个表空间内的表和索引，可以通过设置该表空间的同名参数来覆盖此值（见ALTER TABLESPACE）。
减少这个值（相对于seq_page_cost）将导致系统更倾向于索引扫描；提高它将让索引扫描看起来相对更昂贵。你可以一起提高或降低两个值来改变磁盘 I/O 代价相对于 CPU 代价的重要性，后者由下列参数描述。
对持久存储的随机访问通常远不止比顺序访问贵四倍。不过，仍使用较低的默认值（4.0），因为假定对存储的大多数随机访问（例如索引读取）都将在缓存中命中。此外，网络附加存储的延迟往往会降低随机访问的相对额外开销。
如果你认为缓存命中的频率低于默认值所反映的情况，并且网络延迟很低，则可以增大 random_page_cost，以更好地反映随机存储读取的真实代价。若某种存储的随机读取代价相对于顺序读取更高，例如机械磁盘，也可以用更高的 random_page_cost 值来更好地建模。对应地，如果你的数据很可能完全缓存在内存中，例如数据库小于服务器总内存，或者网络延迟较高，则降低 random_page_cost 可能更合适。
尽管系统允许将random_page_cost设置得小于seq_page_cost，但这不符合实际物理情况。不过，如果数据库完全缓存在 RAM 中，将它们设置为相等是合理的，因为此时非顺序访问页面不会产生额外代价。同样，对于大部分数据已缓存的数据库，应相对于 CPU 参数降低这两个值，因为读取一个已在 RAM 中的页面的代价远小于通常的页面读取代价。
机制详解
规划器成本单位是任意尺度，主要看各成本常量之间的相对关系。seq_page_cost 通常约定为 1.0，random_page_cost 则在考虑缓存命中与存储特性后描述随机访问的平均惩罚。
相对 seq_page_cost 降低本值会偏向索引扫描，提高则会让索引扫描显得更贵。两者都可按 tablespace 覆盖，适合一个集群存在多种存储层级的情况。
官方建议把这些常量视为整个查询组合的平均模型，并警告不要根据少量实验贸然修改。执行计划还受统计信息、effective_cache_size、数据相关性和查询形态影响。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
低延迟 SSD 且缓存命中率高时，1.1 可作为试验起点而非普遍真理；上线前比较代表性 EXPLAIN (ANALYZE, BUFFERS) 与尾延迟。
-
OLAP分析与批处理
不要仅因使用 SSD 就降低它；分析查询仍可能适合顺序扫描。应依据完整的扫描与索引访问组合校准，并考虑 tablespace 级设置。
-
小规格低配实例与开发机
若数据库通常完全驻留缓存，可考虑接近 seq_page_cost 的值；不要设得更低，并应先排除统计信息陈旧造成的错误计划。
常见问题
- 该数值是相对规划成本，不是毫秒或设备实测延迟。
- 为修复单条查询而降低它可能伤害整体负载。
- 基数估算错误常被误认为存储成本参数错误。
- 低于 seq_page_cost 通常不符合物理直觉。
- 全局值可能无法表示 SSD、HDD、网络存储混合的 tablespace。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.1 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.2 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.3 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.4 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.5 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 9.6 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 10 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 11 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 12 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 13 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 14 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 15 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 16 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 17 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 18 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 19 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
| 20 沿用 | 4 |
— |
会话 |
浮点 |
0 |
1.79769e+308 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 规划器代价常量 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.41 次 | |
| 设置规划器对有效数据缓存总规模的假设。 | 现存 | ||||
jit_above_cost |
浮点 | 会话 | 100000 |
— | |
| 设置启用 JIT 编译的查询成本阈值。 | 现存 | ||||
jit_inline_above_cost |
浮点 | 会话 | 500000 |
— | |
| 设置 JIT 尝试内联的查询成本阈值。 | 现存 | ||||
jit_optimize_above_cost |
浮点 | 会话 | 500000 |
— | |
| 设置 JIT 执行昂贵优化的查询成本阈值。 | 现存 | ||||
min_eager_agg_group_size |
浮点 | 会话 | 8 |
— | |
| 设置考虑提前聚合所需的最小平均分组大小。 | 现存 | ||||
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 |
— | |
| 设置把每行从并行 worker 传给 leader 的成本估计。 | 现存 | ||||
random_page_cost |
浮点 | 会话 | 4 |
— | |
| 设置规划器对非顺序读取页面的相对成本估计。 | 现存 | ||||
seq_page_cost |
浮点 | 会话 | 1 |
— | |
| 设置规划器顺序读取磁盘页面的成本估计。 | 现存 | ||||