CONFIGURATION PARAMETER查询规划 / 规划器代价常量
min_eager_agg_group_size
设置考虑应用急切聚合所需的最小平均分组大小。
Sets the minimum average group size required to consider applying eager aggregation.
浮点 引入 19 现存至 20 devel 0 次默认值变更 开发版
- 类型
- 浮点real
- 引入版本
- 19
- 状态
- 现存
版本轨迹
相对 PostgreSQL 19 无变化。 20 开发版尚未定稿：类型与说明取自手册，默认值、上下文和运行值尚未采样。
默认值变迁
仅记录了 PostgreSQL 19 的默认值。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
设置考虑应用急切聚合所需的最小平均分组大小。这有助于在急切聚合不能显著减少行数时避免其开销。默认值为 8。
机制详解
min_eager_agg_group_size：设置考虑提前聚合所需的最小平均分组大小。它可以按会话修改，便于在不影响全部负载的前提下比较计划或行为。 本站在 PG19 Beta 3 实测到它；boot_val 是编译或初始化基线，并不能证明某个运行集群的当前有效值。
这个成本阈值表示：估算每组平均至少有多少输入行，提前聚合才值得考虑。提高它会要求更明显的行数缩减；降低它会探索更多提前聚合路径，但可能把规划与执行开销花在几乎不能缩小连接输入的分组上。
应与 enable_eager_aggregate、enable_hashagg、enable_partitionwise_aggregate、work_mem 一起理解。请在目标服务器检查 SHOW 与 pg_settings，确认 source 和 pending_restart，并在修改前后对比真实负载、日志和资源指标。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
先按会话使用 EXPLAIN (ANALYZE, BUFFERS) 和有代表性的参数分布实验。只有提前聚合能稳定减少行数和延迟、且不引入计划抖动时才偏离默认值。
-
OLAP分析与批处理
测试确有预聚合机会的连接，并覆盖新旧统计信息与落盘压力；比较总 CPU、峰值内存、中间行数和并行计划，而不只看一次耗时。
-
小规格低配实例与开发机
在定位出可复现回归前保持规划器开关与阈值默认。先修复基数统计；全局强制路径常会用一个查询的收益换来更多回归。
常见问题
- 把 min_eager_agg_group_size 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
- 忽略 pg_settings 报告的 user context，误以为修改会立即生效。
- 孤立修改该参数，没有检查关联上限、可观测性和回滚路径。
- 在生产中依赖测试版行为，却没有在 PostgreSQL 19 正式版发布后重新验证。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 19 ← 18 新增此参数
PostgreSQL 19 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 规划器代价常量 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 |
— | |
| 设置规划器对一系列顺序磁盘页面读取中单次读取的代价估计。 | 现存 | ||||