CONFIGURATION PARAMETER清理 / 自动清理
autovacuum_max_parallel_workers
设置单个自动清理工作进程在处理索引时可使用的并行工作进程最大数量。
Maximum number of parallel workers that can be used by a single autovacuum worker.
整数 引入 19 现存至 20 devel 0 次默认值变更 开发版
版本轨迹
相对 PostgreSQL 19 无变化。 20 开发版尚未定稿：类型与说明取自手册，默认值、上下文和运行值尚未采样。
默认值变迁
仅记录了 PostgreSQL 19 的默认值。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
设置单个自动清理工作进程在处理索引时可使用的并行工作进程最大数量。此限制只适用于索引清理（index vacuuming）和索引收尾清理（index cleanup）阶段（有关自动清理各阶段的细节，请参见表 27.52）。实际可用的并行工作进程数量还会进一步受到 max_parallel_workers 的限制。它相当于每个自动清理工作进程上的 VACUUM 命令 PARALLEL 选项。将该值设为 0 会在自动清理期间禁用并行清理。默认值为 0。
机制详解
autovacuum_max_parallel_workers：设置单个 autovacuum worker 可使用的最大并行 worker 数。重新加载配置即可让服务器采用新值，无需完整重启。 本站在 PG19 Beta 3 实测到它；boot_val 是编译或初始化基线，并不能证明某个运行集群的当前有效值。
这个上限按单个 autovacuum worker 计算，只作用于索引清理与索引 cleanup 阶段。0 会禁用并行 autovacuum；实际数量还受 max_parallel_workers 限制，同时每个参与进程都会消耗 CPU 与维护内存。
应与 autovacuum_max_workers、autovacuum_worker_slots、max_parallel_workers、maintenance_work_mem 一起理解。请在目标服务器检查 SHOW 与 pg_settings，确认 source 和 pending_restart，并在修改前后对比真实负载、日志和资源指标。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
先使用上游默认值，再依据 pg_stat_autovacuum_scores、表变更量、冻结年龄、排队与前台延迟决定是否修改。必须保护防回卷任务，避免偏爱忙表而饿死低流量表。
-
OLAP分析与批处理
批处理环境可能受益于优先处理最大维护债务或并行清理索引，但必须衡量整个维护窗口的 I/O 饱和、维护内存、worker 竞争与完成时间。
-
小规格低配实例与开发机
权重和并行度应保守；一个额外 worker 就可能占据很大比例的 CPU、内存与存储队列。先修正阈值，并确保 autovacuum 有足够时间完成。
常见问题
- 把 autovacuum_max_parallel_workers 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
- 忽略 pg_settings 报告的 sighup context，误以为修改会立即生效。
- 孤立修改该参数，没有检查关联上限、可观测性和回滚路径。
- 在生产中依赖测试版行为，却没有在 PostgreSQL 19 正式版发布后重新验证。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 19 ← 18 新增此参数
PostgreSQL 19 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 自动清理 21 | |||||
autovacuum |
布尔 | 重载生效 | on |
— | |
| 控制服务器是否运行自动清理启动器后台进程。 | 现存 | ||||
autovacuum_analyze_scale_factor |
浮点 | 重载生效 | 0.1 |
— | |
| 指定一个表尺寸的分数，在决定是否触发 ANALYZE 时将它加到 autovacuum_analyze_threshold 上。 | 现存 | ||||
autovacuum_analyze_score_weight |
浮点 | — | — | ||
| 指定自动清理在确定优先级时所用评分中，分析阈值分量的缩放因子。 | 现存 | ||||
autovacuum_analyze_threshold |
整数 | 重载生效 | 50 |
— | |
| 指定能在一个表上触发 ANALYZE 的被插入、被更新或被删除元组的最小数量。 | 现存 | ||||
autovacuum_freeze_max_age |
整数 | 重启生效 | 200000000 |
— | |
| 指定在必须强制执行 VACUUM 以防止表内事务 ID 回卷之前，一个表的 pg_class.relfrozenxid 字段可以达到的最大年龄（以事务计）。 | 现存 | ||||
autovacuum_freeze_score_weight |
浮点 | — | — | ||
| 指定自动清理在确定优先级时所用评分中，事务 ID 年龄分量的缩放因子。 | 现存 | ||||
autovacuum_max_parallel_workers |
整数 | — | — | ||
| 设置单个自动清理工作进程在处理索引时可使用的并行工作进程最大数量。 | 现存 | ||||
autovacuum_max_workers |
整数 | 重载生效 | 3 |
183 次 | |
| 指定能同时运行的自动清理进程（除了自动清理启动器之外）的最大数量。 | 现存 | ||||
autovacuum_multixact_freeze_max_age |
整数 | 重启生效 | 400000000 |
— | |
| 指定在必须强制执行 VACUUM 以防止表内多事务 ID 回卷之前，一个表的 pg_class.relminmxid 字段可以达到的最大年龄（以多事务计）。 | 现存 | ||||
autovacuum_multixact_freeze_score_weight |
浮点 | — | — | ||
| 指定自动清理在确定优先级时所用评分中，多事务 ID 年龄分量的缩放因子。 | 现存 | ||||
autovacuum_naptime |
整数 | 重载生效 | 1 min |
— | |
| 指定自动清理在任意给定数据库上各次运行之间的最小间隔。 | 现存 | ||||
autovacuum_vacuum_cost_delay |
浮点 | 重载生效 | 2 ms |
121 次 | |
| 指定用于自动 VACUUM 操作中的代价延迟值。 | 现存 | ||||
autovacuum_vacuum_cost_limit |
整数 | 重载生效 | -1 |
— | |
| 指定用于自动 VACUUM 操作中的代价限制值。 | 现存 | ||||
autovacuum_vacuum_insert_scale_factor |
浮点 | 重载生效 | 0.2 |
— | |
| 指定表中未冻结页面的比例，在决定是否触发 VACUUM 时，将由该比例计算出的数量加到 autovacuum_vacuum_insert_threshold 上。 | 现存 | ||||
autovacuum_vacuum_insert_score_weight |
浮点 | — | — | ||
| 指定自动清理在确定优先级时所用评分中，由插入触发的清理阈值分量的缩放因子。 | 现存 | ||||
autovacuum_vacuum_insert_threshold |
整数 | 重载生效 | 1000 |
— | |
| 指定在任何一个表中触发 VACUUM 所需要插入的元组数。 | 现存 | ||||
autovacuum_vacuum_max_threshold |
整数 | 重载生效 | 100000000 |
— | |
| 指定在任意一个表上触发 VACUUM 所需更新或删除元组数的最大值，也就是对 autovacuum_vacuum_threshold 和 autovacuum_vacuum_scale_factor 计算结果所施加的上限。 | 现存 | ||||
autovacuum_vacuum_scale_factor |
浮点 | 重载生效 | 0.2 |
— | |
| 指定一个表尺寸的分数，在决定是否触发 VACUUM 时将它加到 autovacuum_vacuum_threshold 上。 | 现存 | ||||
autovacuum_vacuum_score_weight |
浮点 | — | — | ||
| 指定自动清理在确定优先级时所用评分中，清理阈值分量的缩放因子。 | 现存 | ||||
autovacuum_vacuum_threshold |
整数 | 重载生效 | 50 |
— | |
| 指定能在一个表上触发 VACUUM 的被更新或被删除元组的最小数量。 | 现存 | ||||
autovacuum_worker_slots |
整数 | 重启生效 | 16 |
— | |
| 指定为自动清理工作进程保留的后端槽位数。 | 现存 | ||||