选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

文档 / 配置参数 / 查询规划

CONFIGURATION PARAMETER查询规划 / 其他规划器选项

default_statistics_target

设置未单独指定目标值的列所使用的默认统计目标。

Sets the default statistics target.

整数 会话 引入 9.0(基线) 现存至 20 devel 0 次默认值变更

类型
整数integer
上下文
会话任何用户都可在会话内用 SET 修改
默认值
100
取值范围
1 – 10000
引入版本
9.0(基线)
状态
现存

PostgreSQL 18 手册 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

100 9.0 – 20

默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18 手册 · 19.7 查询规划 本站手册 官方原文

为没有通过ALTER TABLE SET STATISTICS设置列相关目标的表列设置默认统计目标。更大的值增加了需要做ANALYZE的时间,但是可能会改善规划器的估计质量。默认值是 100。有关PostgreSQL查询规划器使用的统计信息的更多内容, 请参考Section 14.2

机制详解

该目标限制列的最常见值列表条目数和直方图桶数。规划器用这些统计估算行数,进而选择访问路径、连接顺序与连接算法。

ANALYZE 对大表采用抽样而不是读取全部行。抽样规模由本次分析列中的最大统计目标驱动,因此提高目标会大致按比例增加分析时间和空间。

ALTER TABLE ... ALTER COLUMN ... SET STATISTICS 可按列覆盖全局默认值。多列相关性是另一类问题,通常应使用 CREATE STATISTICS,而不是仅提高本参数。

调优建议

按典型负载给出的取值思路,不是放之四海皆准的配方:实际取值要看数据量、并发度与硬件。

  • OLTP在线事务处理

    保持适中的全局目标,只对确实产生行数误估的倾斜列提高;重新运行 ANALYZE,并比较调整前后的估算行数与实际行数。

  • OLAP分析与批处理

    较高基线有助于复杂过滤和连接,但相关谓词应使用扩展统计;批量装载后还要为增加的 ANALYZE 时间留预算。

  • 小规格低配实例与开发机

    适度提高全局值通常成本不高,但按列调优更精确;从不参与过滤、分组或排序的列不需要深直方图。

常见问题

  • 修改参数不会刷新已有统计,之后必须运行 ANALYZE。
  • 提高单列目标本身无法描述跨列相关性。
  • 过高的全局值会让不重要列也承担额外 ANALYZE 工作。
  • 分区子表变化不会触发父表分析,父表可能需要手工 ANALYZE。
  • 抽样仍是近似过程,可能出现估算误差与计划波动。

演化历史

相邻两个大版本之间的差异,新的在前。版本号链到该版的快照。

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

逐版本快照

每个收录版本里的 7 项事实,与上一个存在的版本不同的格子带底色。版本号链到该版。

版本 默认值单位上下文类型最小值最大值枚举值
9.0 100 会话 整数 1 10000
9.1 100 会话 整数 1 10000
9.2 100 会话 整数 1 10000
9.3 100 会话 整数 1 10000
9.4 100 会话 整数 1 10000
9.5 100 会话 整数 1 10000
9.6 100 会话 整数 1 10000
10 100 会话 整数 1 10000
11 100 会话 整数 1 10000
12 100 会话 整数 1 10000
13 100 会话 整数 1 10000
14 100 会话 整数 1 10000
15 100 会话 整数 1 10000
16 100 会话 整数 1 10000
17 100 会话 整数 1 10000
18 100 会话 整数 1 10000
19 100 会话 整数 1 10000
20 沿用 100 会话 整数 1 10000

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Query Tuning 查询规划 8 个
其他规划器选项 8
constraint_exclusion 枚举 会话 partition
允许规划器利用约束排除不可能匹配的表。 现存
cursor_tuple_fraction 浮点 会话 0.1
设置规划器对游标实际取回行比例的估计。 现存
default_statistics_target 整数 会话 100
设置未单独指定目标值的列所使用的默认统计目标。 现存
from_collapse_limit 整数 会话 8
设置不再折叠子查询的 FROM 列表规模阈值。 现存
jit 布尔 会话 on 192 次
在 JIT 可用且成本规则选中查询时允许即时编译。 现存
join_collapse_limit 整数 会话 8
设置不再展平 JOIN 构造的 FROM 列表规模阈值。 现存
plan_cache_mode 枚举 会话 auto
控制规划器选择自定义计划还是通用计划。 现存
recursive_worktable_factor 浮点 会话 10
设置递归查询工作表平均大小的规划器估计倍数。 现存