PostgreSQL / 系统课时
计算 VACUUM 触发阈值
计算 VACUUM 触发阈值
VACUUM 是否进入 autovacuum 候选队列,核心不是“表大不大”,而是失效元组数量是否越过按表规模计算出的阈值。本课把默认公式、表级覆盖和实际更新量放到同一个计算模型里。
学习目标
- 根据
reltuples、基础阈值和比例因子计算 VACUUM 触发点 - 判断一批
UPDATE、DELETE是否已经让表满足触发条件 - 用表级存储参数为高更新表设置更合适的阈值
先把触发公式算清楚
对 UPDATE 和 DELETE 产生的失效元组,PostgreSQL 18 使用下面的普通 VACUUM 阈值:
其中 B 是 autovacuum_vacuum_threshold,S 是 autovacuum_vacuum_scale_factor,N 是 pg_class.reltuples 的估算行数,M 是 PostgreSQL 18 引入的 autovacuum_vacuum_max_threshold 上限。满足条件的判断是“失效元组计数大于阈值”,而不是等于阈值。
PostgreSQL 18 的默认值是 B=50、S=0.2、M=100000000。因此估算 100 万行的表,默认阈值为 50 + 0.2 × 1000000 = 200050。如果版本早于 PostgreSQL 18,则没有 autovacuum_vacuum_max_threshold 这一上限项,按 B + S × N 计算即可。
比较默认与自定义触发点
下面用同一张“100 万行、累计 2.5 万个失效元组”的表比较两套策略。默认策略不会触发;把比例因子降到 0.02 后,同样的更新量已经越过阈值。
WITH sample(policy, reltuples, base_threshold, scale_factor, max_threshold, obsolete_tuples) AS (
VALUES
('default', 1000000::numeric, 50::numeric, 0.20::numeric, 100000000::numeric, 25000::numeric),
('custom', 1000000::numeric, 500::numeric, 0.02::numeric, 100000000::numeric, 25000::numeric)
)
SELECT
policy,
reltuples::bigint,
LEAST(max_threshold, base_threshold + scale_factor * reltuples)::bigint AS vacuum_threshold,
obsolete_tuples::bigint,
obsolete_tuples > LEAST(max_threshold, base_threshold + scale_factor * reltuples) AS eligible
FROM sample
ORDER BY policy;预期输出
policy | reltuples | vacuum_threshold | obsolete_tuples | eligible
---------+-----------+------------------+-----------------+----------
custom | 1000000 | 20500 | 25000 | t
default | 1000000 | 200050 | 25000 | f这个结果说明比例因子对大表影响最明显。对千万、亿级行数的高更新表,默认 0.2 可能让大量死元组积累后才满足普通触发条件;表级参数可以降低门槛,而不必把全库默认值一起调低。
把自定义阈值落到单表
表级配置通过 storage parameters 覆盖全局值。下面创建一个演示表,设置基础阈值和比例因子,再从系统目录读取实际保存的参数。
CREATE TABLE IF NOT EXISTS public.vacuum_policy_demo (
id bigint PRIMARY KEY,
payload text
);
ALTER TABLE public.vacuum_policy_demo SET (
autovacuum_vacuum_threshold = 500,
autovacuum_vacuum_scale_factor = 0.02
);
SELECT option_name, option_value
FROM pg_class AS c
CROSS JOIN LATERAL pg_options_to_table(c.reloptions)
WHERE c.oid = 'public.vacuum_policy_demo'::regclass
AND option_name IN ('autovacuum_vacuum_threshold', 'autovacuum_vacuum_scale_factor')
ORDER BY option_name;预期输出
option_name | option_value
------------------------------------+--------------
autovacuum_vacuum_scale_factor | 0.02
autovacuum_vacuum_threshold | 500实际治理时先看当前实例的全局参数,再决定是否覆盖单表;不要直接照搬默认值。可以用 pg_settings 核对当前配置,因为实例可能已经被平台层修改。
SELECT name, setting
FROM pg_settings
WHERE name IN (
'autovacuum_vacuum_threshold',
'autovacuum_vacuum_scale_factor',
'autovacuum_vacuum_max_threshold'
)
ORDER BY name;预期输出
name | setting
-----------------------------------+-----------
autovacuum_vacuum_max_threshold | 100000000
autovacuum_vacuum_scale_factor | 0.2
autovacuum_vacuum_threshold | 50以上输出对应 PostgreSQL 18 未修改的默认配置;实际值可能不同。PostgreSQL 17 及更早版本不会返回 autovacuum_vacuum_max_threshold 这一行。
不要把所有 VACUUM 都归因于死元组阈值
普通更新/删除阈值只是 autovacuum 的一个入口。插入密集型表还有独立的 insert vacuum 触发条件;事务 ID 或 MultiXact 接近冻结安全边界时,也可能触发防回卷 VACUUM。看到一次 autovacuum 时,不能只用 n_dead_tup 反推原因。
pg_stat_user_tables.n_dead_tup 可以作为当前死元组规模的运维信号,但它同样是估算值,而且“已经满足阈值”也不等于 worker 会瞬间启动:launcher 检查周期、worker 数量、其他表的维护任务和锁等待都会影响实际启动时间。真正调参时,应把阈值计算与 autovacuum 日志、last_autovacuum 和资源负载一起观察。