CONFIGURATION PARAMETER清理 / 自动清理

autovacuum_vacuum_scale_factor

把表大小的一定比例加入触发 VACUUM 的元组变更阈值。

Number of tuple updates or deletes prior to vacuum as a fraction of reltuples.

浮点重载生效引入 9.0（基线）现存至 20 devel 0 次默认值变更

类型: 浮点real
上下文: 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
默认值: 0.2
取值范围: 0 – 100
分类: 清理 / 自动清理
引入版本: 9.0（基线）
状态: 现存

PostgreSQL 18 手册官方文档

版本轨迹

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

默认值变迁

0.2 9.0 – 20

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

手册说明

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

本版译文与 PostgreSQL 10 完全一致，下面就是同一段文字。

指定一个表尺寸的分数，在决定是否触发VACUUM时将它加到autovacuum_vacuum_threshold上。默认值为0.2（表尺寸的20%）。该参数只能在postgresql.conf文件或在服务器命令中设置。但是对个别表可以通过修改表存储参数来覆盖该设置。

机制详解

核心触发值为基础阈值加上本参数乘以 pg_class.reltuples；后者是近似行数。PostgreSQL 18 还会用 autovacuum_vacuum_max_threshold 对结果封顶。

该触发器统计 UPDATE 或 DELETE 产生的旧元组；仅插入负载有独立的 insert threshold 与 scale factor。防回卷清理由事务年龄规则控制，不依赖本参数。

表级 autovacuum_vacuum_scale_factor storage parameter 会覆盖全局值。当不同表的大小和更新率差异很大时，表级设置通常更合适。

调优建议

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

OLTP在线事务处理

对大型高更新表使用更低的表级值，避免死元组形成巨大的绝对积压；应依据实际变更量与清理时长验证，而不是只看百分比。
OLAP分析与批处理

追加与批处理负载应让阈值配合装载周期及显式 VACUUM/ANALYZE；过低的全局值可能在批处理期间触发不必要维护。
小规格低配实例与开发机

真正的小表通常可使用上游默认值。优先逐表处理例外；过低的集群级值可能导致频繁而细碎的 vacuum。

常见问题

看似很小的比例在大表上仍可能代表数百万死元组。
全局降低可能让大量表持续产生 I/O 压力。
它不控制仅插入触发的 vacuum，也不控制防回卷 vacuum。
reltuples 是估算值，触发点不是精确的死元组比例。
表级 storage parameter 可能让该表忽略全局值。

演化历史

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

PostgreSQL 20 ← 19 沿用 19

事实沿用 19
PostgreSQL 18 ← 17 仅描述更新

分类 Autovacuum Vacuuming / Automatic Vacuuming

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
9.0	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
9.1	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
9.2	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
9.3	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
9.4	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
9.5	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
9.6	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
10	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
11	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
12	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
13	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
14	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
15	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
16	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
17	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
18	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
19	`0.2`	`—`	`重载生效`	`浮点`	`0`	`100`	`—`
20 沿用	`0.2`	`—`	`重载生效`	`浮点`	`0`	`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 分配的后端槽位数量。				现存

快速链接