CONFIGURATION PARAMETER查询规划 / 规划器代价常量
min_parallel_index_scan_size
设置考虑并行索引扫描所需的最小索引数据量。
Sets the minimum amount of index data for a parallel scan.
整数 会话 引入 10 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
512 KiB (64 × 8kB)原始值 64 8kB- 取值范围
0 – 715827882- 引入版本
- 10
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 10 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
为必须扫描的索引数据量设置一个最小值，扫描的索引数据量超过这一个值时才会考虑使用并行扫描。 注意并行索引扫描通常并不会触及整个索引，它是规划器认为该扫描会实际用到的相关页面的数量。 这个参数还用于决定特定的索引是否参与并行vacuum。参见VACUUM。 如果指定值时没有单位，则以块为单位，即BLCKSZ字节，通常为8kB。默认值是512千字节（512kB）。
机制详解
min_parallel_index_scan_size 是规划器的候选资格下限：只有预计会访问的索引页面量达到配置规模时，才会考虑并行扫描路径。
越过该下限并不保证产生并行计划。规划器仍会比较成本、检查并行安全性，并受 max_parallel_workers_per_gather 与集群 worker 池约束。
索引阈值还参与判断索引能否并行 vacuum。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
提高 min_parallel_index_scan_size 可减少短 OLTP 扫描启动并行，但要确认报表与维护任务没有回归。
-
OLAP分析与批处理
除非较小但昂贵的扫描被错误排除，否则保留上游阈值。降低 min_parallel_index_scan_size 会在大量并发查询时增加规划与 worker 开销。
-
小规格低配实例与开发机
小主机上 worker 启动与内存竞争更突出，宜采用保守或更高阈值，并与 max_parallel_workers_per_gather 联动，而不是单独调整。
常见问题
- 误以为阈值限制实际读取字节；它只控制规划器候选资格。
- 认为规模估计一越过阈值就必然产生并行计划。
- 降低阈值却没有为并发下的 worker 与节点内存做预算。
- 比较裸数值时忘记应用 8kB 块单位。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 10 ← 9.6 新增此参数
PostgreSQL 10 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 10 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 11 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 12 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 13 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 14 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 15 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 16 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 17 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 18 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 19 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
| 20 沿用 | 512 KiB (64 × 8kB) |
8kB |
会话 |
整数 |
0 |
715827882 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 规划器代价常量 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 |
— | |
| 设置规划器顺序读取磁盘页面的成本估计。 | 现存 | ||||