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

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

文档 / 配置参数 / 清理

CONFIGURATION PARAMETER清理 / 自动清理

autovacuum_vacuum_cost_delay

设置 autovacuum 的清理成本延迟(毫秒)。

Vacuum cost delay in milliseconds, for autovacuum.

浮点 重载生效 引入 9.0(基线) 现存至 20 devel 1 次默认值变更

类型
浮点real
上下文
重载生效改配置文件后重载(pg_ctl reload / SIGHUP)即可生效
默认值
2 ms原始值 2 ms
取值范围
-1 – 100
引入版本
9.0(基线)
状态
现存

PostgreSQL 18 手册 官方文档

版本轨迹

相对 PostgreSQL 17 仅简述或分类有更新。

默认值变迁

20 ms 9.0 – 11 2 ms 12 – 20

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

手册说明

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

指定用于自动VACUUM操作中的代价延迟值。如果指定-1,则使用vacuum_cost_delay值。 如果指定值时没有单位,则以毫秒为单位。默认值为2毫秒。该参数只能在postgresql.conf文件或在服务器命令中设置。但是对个别表可以通过修改表存储参数来覆盖该设置。

机制详解

设置 autovacuum 的清理成本延迟(毫秒)。重新加载配置即可应用新值;已经开始的工作不会被追溯改变。

这些值控制 autovacuum worker 的成本节流;-1 表示分别继承 vacuum_cost_delay 或 vacuum_cost_limit。多个 worker 活跃时,autovacuum 成本额度会在 worker 间平衡,因此单 worker 观察值不能直接乘以并发数。

应把 autovacuum_vacuum_cost_delay 与 vacuum_cost_delay、vacuum_cost_limit、vacuum_cost_page_hit 一起监控和变更。先在对应角色与真实负载上验证,再按其 sighup context 选择会话修改、reload 或 restart;历史默认值并不等于当前有效值。

调优建议

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

  • OLTP在线事务处理

    用 autovacuum 时长、死元组增长和前台 I/O 延迟共同调 autovacuum_vacuum_cost_delay;优先表级覆盖热点表,避免全局节流让清理永远追不上。

  • OLAP分析与批处理

    在装载后维护窗口可提高成本额度或缩短延迟,但要验证扫描吞吐不会挤占查询/导入;failsafe 触发说明常态策略已失效。

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

    保持温和默认;若磁盘很慢,降低并发或给单表覆盖通常比无限增大 delay 更可控。

常见问题

  • 只改全局值,忽略表级 storage parameter 覆盖。
  • 把 reltuples 与累计变更统计当作精确实时计数。
  • 不看长事务、复制槽和 worker 饱和就责怪阈值。
  • 用降低维护频率换取短期平静,最终进入防回卷 failsafe。

演化历史

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

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

  2. PostgreSQL 18 ← 17 仅描述更新

    分类 Autovacuum Vacuuming / Automatic Vacuuming 补充说明 (无) -1 means use "vacuum_cost_delay".

  3. PostgreSQL 12 ← 11 默认值变更

    默认值 20 ms 2 ms 类型 整数 浮点

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
9.0 20 ms ms 重载生效 整数 -1 100
9.1 20 ms ms 重载生效 整数 -1 100
9.2 20 ms ms 重载生效 整数 -1 100
9.3 20 ms ms 重载生效 整数 -1 100
9.4 20 ms ms 重载生效 整数 -1 100
9.5 20 ms ms 重载生效 整数 -1 100
9.6 20 ms ms 重载生效 整数 -1 100
10 20 ms ms 重载生效 整数 -1 100
11 20 ms ms 重载生效 整数 -1 100
12 2 ms ms 重载生效 浮点 -1 100
13 2 ms ms 重载生效 浮点 -1 100
14 2 ms ms 重载生效 浮点 -1 100
15 2 ms ms 重载生效 浮点 -1 100
16 2 ms ms 重载生效 浮点 -1 100
17 2 ms ms 重载生效 浮点 -1 100
18 2 ms ms 重载生效 浮点 -1 100
19 2 ms ms 重载生效 浮点 -1 100
20 沿用 2 ms ms 重载生效 浮点 -1 100

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
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 分配的后端槽位数量。 现存