autovacuum_vacuum_insert_threshold

手册说明

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

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

机制详解

设置触发 VACUUM 前插入元组数量的最低阈值。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。

仅插入表的触发量由 insert threshold + insert scale factor × reltuples × 未 all-frozen 比例计算。该清理主要推进 visibility map 与冻结，即使没有死元组也能减少未来 aggressive VACUUM 工作。

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

调优建议

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

• OLTP在线事务处理

  根据表大小、变更速率与维护 SLA 调 autovacuum_vacuum_insert_threshold，大表优先使用表级阈值；观察触发间隔、死元组和 ANALYZE/VACUUM 时长。

• OLAP分析与批处理

  批量装载后主动 ANALYZE/VACUUM，不要只等待比例阈值；对 append-only 分区单独规划冻结与 visibility map 推进。

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

  先保持默认；小表固定阈值比比例项更重要，修改后确认 worker 数量和 I/O 仍有余量。

常见问题

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

演化历史

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

1. PostgreSQL 20 ← 19 沿用 19

   事实沿用 19

2. PostgreSQL 18 ← 17 仅描述更新

   分类 Autovacuum → Vacuuming / Automatic Vacuuming 简述 Minimum number of tuple inserts prior to vacuum, or -1 to disable insert vacuums. → Minimum number of tuple inserts prior to vacuum. 补充说明 （无） → -1 disables insert vacuums.

3. PostgreSQL 13 ← 12 新增此参数

   +PostgreSQL 13 起可用

逐版本快照

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

关联参数

autovacuum_vacuum_thresholdautovacuum_vacuum_scale_factorautovacuum_vacuum_max_thresholdautovacuum_vacuum_insert_scale_factorautovacuumautovacuum_analyze_scale_factor

参考资料

• PostgreSQL 19 Beta 3：autovacuum_vacuum_insert_threshold
• PostgreSQL 19 发行说明

同类参数