PostgreSQL / 系统课时

计算 VACUUM 触发阈值

计算 VACUUM 触发阈值

VACUUM 是否进入 autovacuum 候选队列,核心不是“表大不大”,而是失效元组数量是否越过按表规模计算出的阈值。本课把默认公式、表级覆盖和实际更新量放到同一个计算模型里。

学习目标

  • 根据 reltuples、基础阈值和比例因子计算 VACUUM 触发点
  • 判断一批 UPDATE、DELETE 是否已经让表满足触发条件
  • 用表级存储参数为高更新表设置更合适的阈值

先把触发公式算清楚

对 UPDATE 和 DELETE 产生的失效元组,PostgreSQL 18 使用下面的普通 VACUUM 阈值:

Tvacuum=min⁡(M,B+S×N)T_{vacuum}=\min(M, B+S\times N)

其中 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 后,同样的更新量已经越过阈值。

sql
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;

预期输出

text
 policy  | reltuples | vacuum_threshold | obsolete_tuples | eligible
---------+-----------+------------------+-----------------+----------
 custom  |   1000000 |            20500 |           25000 | t
 default |   1000000 |           200050 |           25000 | f

这个结果说明比例因子对大表影响最明显。对千万、亿级行数的高更新表,默认 0.2 可能让大量死元组积累后才满足普通触发条件;表级参数可以降低门槛,而不必把全库默认值一起调低。

把自定义阈值落到单表

表级配置通过 storage parameters 覆盖全局值。下面创建一个演示表,设置基础阈值和比例因子,再从系统目录读取实际保存的参数。

sql
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;

预期输出

text
            option_name             | option_value
------------------------------------+--------------
 autovacuum_vacuum_scale_factor     | 0.02
 autovacuum_vacuum_threshold        | 500

实际治理时先看当前实例的全局参数,再决定是否覆盖单表;不要直接照搬默认值。可以用 pg_settings 核对当前配置,因为实例可能已经被平台层修改。

sql
SELECT name, setting
FROM pg_settings
WHERE name IN (
    'autovacuum_vacuum_threshold',
    'autovacuum_vacuum_scale_factor',
    'autovacuum_vacuum_max_threshold'
)
ORDER BY name;

预期输出

text
               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 和资源负载一起观察。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

计算 VACUUM 触发阈值

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通