↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

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

百科 / 配置参数 / 查询规划

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

default_statistics_target

为没有通过 ALTER TABLE SET STATISTICS 设置列相关目标的表列设置默认统计目标。

Sets the default statistics target.

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

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

PostgreSQL 18.7 手册 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

100 9.0 – 9.4 100 9.5 – 19

默认值一共换过 2 档,每段的宽度按它覆盖的大版本数伸展,深色的一段是当前查看的 PostgreSQL 18.7。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。

手册说明

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

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

机制详解

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

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

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

调优建议

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

  • OLTP在线事务处理

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

  • OLAP分析与批处理

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

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

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

常见问题

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

演化历史

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

  1. 本数据集收录 default_statistics_target 以来没有记录到变化。

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
7.4 — — — 整数 — — —
8.0 — — — 整数 — — —
8.1 — — — 整数 — — —
8.2 — — — 整数 — — —
8.3 — — — 整数 — — —
8.4 — — — 整数 — — —
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 — — — 整数 — — —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Query Tuning 查询规划 8 个 ↗
其他规划器选项 8
constraint_exclusion 枚举 会话 partition 8.41 次
控制查询规划器对表约束的使用,以优化查询。 现存
cursor_tuple_fraction 浮点 会话 0.1 —
设置规划器对将被检索的一个游标的行的比例的估计。 现存
default_statistics_target 整数 会话 100 —
为没有通过 ALTER TABLE SET STATISTICS 设置列相关目标的表列设置默认统计目标。 现存
from_collapse_limit 整数 会话 8 —
如果生成的 FROM 列表不超过这么多项,规划器将把子查询融合到上层查询。 现存
jit 布尔 会话 on 192 次
决定如果可用(见第 30 章),PostgreSQL 是否可以使用 JIT 编译。 现存
join_collapse_limit 整数 会话 8 —
如果得出的列表中不超过这么多项,那么规划器将把显式 JOIN(除了 FULL JOIN)结构重写到 FROM 项列表中。 现存
plan_cache_mode 枚举 会话 auto —
预备语句(无论是显式预备的,还是由 PL/pgSQL 等隐式生成的)可以使用自定义计划或通用计划执行。 现存
recursive_worktable_factor 浮点 会话 10 —
设置规划器对递归查询的工作表的平均大小的估计值,作为查询初始非递归项的估计大小的倍数。 现存