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

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

文档 / 配置参数 / 清理

CONFIGURATION PARAMETER清理 / 自动清理

autovacuum_vacuum_score_weight

设置 autovacuum 优先级中普通 VACUUM 得分的缩放系数。

Scaling factor of vacuum score for autovacuum prioritization.

浮点 重载生效 引入 19 现存至 20 devel 0 次默认值变更 开发版

类型
浮点real
上下文
重载生效改配置文件后重载(pg_ctl reload / SIGHUP)即可生效
默认值
1
取值范围
0 – 10
引入版本
19
状态
现存

PostgreSQL 20 devel 手册 官方文档 引入提交 d7965d65fc

版本轨迹

PostgreSQL 20 开发版沿用 19 的 pg_settings 事实,说明取自 devel 手册。 20 开发版尚未定稿:pg_settings 事实沿用 19,说明取自本站 devel 手册。

默认值变迁

1 19 – 20

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

手册说明

PostgreSQL 20 devel 手册 · 19.10 清理 本站手册 官方原文

指定自动清理在确定优先级时所用评分中,清理阈值分量的缩放因子。默认值为1.0。该参数只能在postgresql.conf文件中或服务器命令行上设置。更多信息见Section 24.1.6.1

机制详解

autovacuum_vacuum_score_weight:设置 autovacuum 优先级中普通 VACUUM 得分的缩放系数。重新加载配置即可让服务器采用新值,无需完整重启。 本站在 PG19 Beta 3 实测到它;boot_val 是编译或初始化基线,并不能证明某个运行集群的当前有效值。

PostgreSQL 19 会为每个候选表计算得分,并按加权分量的最大值安排工作。该参数乘在更新或删除元组带来的清理压力分量上:大于 1 会提高其调度影响,0 到 1 会降低影响;把全部得分权重设为 0 可恢复 PG19 之前按目录顺序处理的策略。可通过 pg_stat_autovacuum_scores 检查各分量。

应与 autovacuum_freeze_score_weight、autovacuum_multixact_freeze_score_weight、autovacuum_vacuum_insert_score_weight、autovacuum_analyze_score_weight 一起理解。请在目标服务器检查 SHOW 与 pg_settings,确认 source 和 pending_restart,并在修改前后对比真实负载、日志和资源指标。

调优建议

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

  • OLTP在线事务处理

    先使用上游默认值,再依据 pg_stat_autovacuum_scores、表变更量、冻结年龄、排队与前台延迟决定是否修改。必须保护防回卷任务,避免偏爱忙表而饿死低流量表。

  • OLAP分析与批处理

    批处理环境可能受益于优先处理最大维护债务或并行清理索引,但必须衡量整个维护窗口的 I/O 饱和、维护内存、worker 竞争与完成时间。

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

    权重和并行度应保守;一个额外 worker 就可能占据很大比例的 CPU、内存与存储队列。先修正阈值,并确保 autovacuum 有足够时间完成。

常见问题

  • 把 autovacuum_vacuum_score_weight 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
  • 忽略 pg_settings 报告的 sighup context,误以为修改会立即生效。
  • 孤立修改该参数,没有检查关联上限、可观测性和回滚路径。
  • 在生产中依赖测试版行为,却没有在 PostgreSQL 19 正式版发布后重新验证。

演化历史

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

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

  2. PostgreSQL 19 ← 18 新增此参数

    PostgreSQL 19 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
19 1 重载生效 浮点 0 10
20 沿用 1 重载生效 浮点 0 10

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Vacuuming 清理 21 个
自动清理 21
autovacuum 布尔 重载生效 on
控制 PostgreSQL 是否运行自动清理启动器。 现存
autovacuum_analyze_scale_factor 浮点 重载生效 0.1
以 reltuples 的比例设置触发 ANALYZE 前的元组插入、更新或删除数量。 现存
autovacuum_analyze_score_weight 浮点 重载生效 1
设置 autovacuum 优先级中 ANALYZE 得分的缩放系数。 现存
autovacuum_analyze_threshold 整数 重载生效 50
设置触发 ANALYZE 前元组插入、更新或删除数量的最低阈值。 现存
autovacuum_freeze_max_age 整数 重启生效 200000000
设置为防止事务 ID 回卷而强制自动清理表的年龄。 现存
autovacuum_freeze_score_weight 浮点 重载生效 1
设置 autovacuum 优先级中事务 ID 冻结得分的缩放系数。 现存
autovacuum_max_parallel_workers 整数 重载生效 0
设置单个 autovacuum worker 可使用的最大并行 worker 数。 现存
autovacuum_max_workers 整数 重载生效 3 183 次
限制可同时运行的 autovacuum worker 进程数量。 现存
autovacuum_multixact_freeze_max_age 整数 重启生效 400000000
设置为防止 MultiXact 回卷而强制自动清理表的 MultiXact 年龄。 现存
autovacuum_multixact_freeze_score_weight 浮点 重载生效 1
设置 autovacuum 优先级中 MultiXact 冻结得分的缩放系数。 现存
autovacuum_naptime 整数 重载生效 1 min
设置两轮 autovacuum 扫描之间的休眠时间。 现存
autovacuum_vacuum_cost_delay 浮点 重载生效 2 ms 121 次
设置 autovacuum 的清理成本延迟(毫秒)。 现存
autovacuum_vacuum_cost_limit 整数 重载生效 -1
设置 autovacuum 休眠前可用的清理成本额度。 现存
autovacuum_vacuum_insert_scale_factor 浮点 重载生效 0.2
以 reltuples 的比例设置触发 VACUUM 前的插入元组数量。 现存
autovacuum_vacuum_insert_score_weight 浮点 重载生效 1
设置 autovacuum 优先级中仅插入清理得分的缩放系数。 现存
autovacuum_vacuum_insert_threshold 整数 重载生效 1000
设置触发 VACUUM 前插入元组数量的最低阈值。 现存
autovacuum_vacuum_max_threshold 整数 重载生效 100000000
设置触发 VACUUM 前更新或删除元组数量的最高阈值。 现存
autovacuum_vacuum_scale_factor 浮点 重载生效 0.2
把表大小的一定比例加入触发 VACUUM 的元组变更阈值。 现存
autovacuum_vacuum_score_weight 浮点 重载生效 1
设置 autovacuum 优先级中普通 VACUUM 得分的缩放系数。 现存
autovacuum_vacuum_threshold 整数 重载生效 50
设置触发 VACUUM 前更新或删除元组数量的最低阈值。 现存
autovacuum_worker_slots 整数 重启生效 16
设置为 autovacuum worker 分配的后端槽位数量。 现存