跳转到主要内容

autovacuum_worker_slots

autovacuum_worker_slots:设置为 autovacuum worker 分配的后端槽位数量。实测在档范围为 PG18–19 Beta 3;最后在档的 PG19 Beta 3 启动默认值为 16,context 为 postmaster。这是测试版快照事实,PostgreSQL 19 正式发布前仍可能变化。
说明

Fact — 官方简述译文:设置为 autovacuum worker 分配的后端槽位数量。

身份

类型 , integer
上游 pg_settings 类型
Context , postmaster
修改后需要重启数据库
单位 ,
原始单位
范围 , 1262143
最后在档版本的原始上下限
枚举值 ,
非枚举类型记为 —
分类 , Vacuuming / Automatic Vacuuming
上游分类
最后 boot 值 , 16
16

生命周期

Fact
首次观测 PG18
在档版本 PG18–19 Beta 3
移除版本
引入提交 c758119e5bfb — Allow changing autovacuum_max_workers without restarting.
提交日期 2025-01-06
Discussion 讨论 1

默认值变迁

PG9.0–19 Beta 3 实测 boot 默认值
版本 原始 boot_val 单位 人类可读值
PG18–19 Beta 3 16 16

机制详解

设置为 autovacuum worker 分配的后端槽位数量。该值在服务器启动时固定,修改后必须重启。

PG18 把可注册的 autovacuum worker 后端槽数量与实际并发上限 autovacuum_max_workers 分离。槽位在启动时分配,使 reload 后可以在既有槽预算内改变 worker 并发。

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

调优建议

提示

Advice。 以下建议是工作负载起点,必须用真实测量验证。

场景 建议
OLTP 根据表大小、变更速率与维护 SLA 调 autovacuum_worker_slots,大表优先使用表级阈值;观察触发间隔、死元组和 ANALYZE/VACUUM 时长。
OLAP 批量装载后主动 ANALYZE/VACUUM,不要只等待比例阈值;对 append-only 分区单独规划冻结与 visibility map 推进。
小规格 先保持默认或 Pigsty 矩阵值;小表固定阈值比比例项更重要,修改后确认 worker 数量和 I/O 仍有余量。

Pigsty 取值

以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具,并按 PG19 Beta 3 渲染当前 Pigsty 模板;这不表示 Pigsty 当前支持该历史或测试版本。

模板 有效值 与上游 boot 比较 源表达式
OLTP 未修改
OLAP 未修改
CRIT 未修改
TINY 未修改
注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实:OLTP: PG18–19 Beta 3 未修改;OLAP: PG18–19 Beta 3 未修改;CRIT: PG18–19 Beta 3 未修改;TINY: PG18–19 Beta 3 未修改。 未发现覆盖值,因此不推断 Pigsty 专属理由。

常见坑

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

autovacuum · autovacuum_naptime · autovacuum_max_workers · autovacuum_work_mem · track_counts · autovacuum_analyze_scale_factor

参考资料