PostgreSQL / 系统课时

用 VERBOSE 读懂 VACUUM 结果

用 VERBOSE 读懂 VACUUM 结果

VACUUM VERBOSE 的价值不在于“日志更多”,而在于把扫描页数、可回收元组、暂不能回收的版本、索引清理、可见性位和 I/O 成本串成证据链。本课用一张测试表跑一次清理,再把输出翻译成可验证的维护结论。

学习目标

  • 能从 VACUUM VERBOSE 输出中区分“已清理”“暂不能清理”和“未发生页截断”
  • 能用 removable cutoff、索引清理与 Visibility Map 信息判断下一步排查方向
  • 能用统计视图复核 VACUUM 是否执行以及死元组估算是否下降

构造一次可观察的清理

下面在独立测试表中制造 UPDATE 和 DELETE 产生的旧版本,再执行普通 VACUUM。不要把 VACUUM 放进显式事务块;它必须作为独立命令运行。

sql
DROP TABLE IF EXISTS vacuum_verbose_demo;

CREATE TABLE vacuum_verbose_demo (
    id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    payload text NOT NULL
);

INSERT INTO vacuum_verbose_demo (payload)
SELECT repeat('x', 100)
FROM generate_series(1, 20000);

UPDATE vacuum_verbose_demo
SET payload = payload || 'u'
WHERE id % 2 = 0;

DELETE FROM vacuum_verbose_demo
WHERE id % 5 = 0;

SET client_min_messages = info;
VACUUM (VERBOSE) vacuum_verbose_demo;

预期输出(保留关键行;页数、事务号、I/O 数字会随环境变化):

text
DROP TABLE
CREATE TABLE
INSERT 0 20000
UPDATE 10000
DELETE 4000
SET
INFO:  vacuuming "<DATABASE>.public.vacuum_verbose_demo"
INFO:  finished vacuuming "<DATABASE>.public.vacuum_verbose_demo": index scans: <VALUE>
pages: <VALUE> removed, <VALUE> remain, <VALUE> scanned (<VALUE>% of total)
tuples: <VALUE> removed, 16000 remain, 0 are dead but not yet removable
removable cutoff: <ID>, which was <VALUE> XIDs old when operation ended
visibility map: <VALUE> pages set all-visible, <VALUE> pages set all-frozen (<VALUE> were all-visible)
buffer usage: <VALUE> hits, <VALUE> reads, <VALUE> dirtied
VACUUM

这里最稳定的业务结论是:DELETE 后应剩约 16000 个逻辑行;具体有多少旧版本由 VACUUM 自己移除,可能受 HOT、页剪枝和执行期间并发影响,因此不要把 tuples removed 预设成固定值。

把关键行翻译成维护结论

pages 描述的是 heap 页处理情况。remain 是关系仍保留的页数;removed 只表示尾部空页被截断并从关系中移除,不等于“删除了多少行”。看到大量元组被清理但 pages removed: 0 完全正常,因为普通 VACUUM 主要复用页内空间,并不主动重写整张表。

tuples 是判断版本清理最直接的一组数字。removed 表示本轮移除的可回收行版本;remain 是仍保留的行版本估计;dead but not yet removable 若大于 0,说明确实存在死版本,但当前清理安全边界还不能越过。此时继续频繁手工 VACUUM 通常不是答案,应检查长事务、旧快照或复制相关保留源。

removable cutoff 是本轮 VACUUM 计算出的安全回收边界。它越被旧事务拖住,越多已失效版本可能留在表中。这个值本身不是“越大越好”的调优参数,而是解释为什么某些死元组仍不能删除的证据。

index scans 与 index scan needed 或 index scan not needed 说明本轮是否需要清理索引中的失效 TID。不要把 index scans: 0 直接理解为异常:若没有足够的死条目需要索引清理,或采用了可跳过索引清理的路径,零次扫描是合理结果。

visibility map 反映本轮把多少 heap 页重新标记为 all-visible 或 all-frozen。它既影响后续 VACUUM 可以跳过哪些页,也会影响 Index-Only Scan 是否能少访问 heap。buffer usage、WAL usage 和耗时数据则用来评估维护成本,而不是判断“有没有清干净”的唯一标准。

用统计视图复核结果

VERBOSE 输出是一次操作的现场证据,统计视图适合复核“最近是否真的跑过 VACUUM”以及死元组估算是否回落。执行:

sql
SELECT
    relname,
    n_live_tup,
    n_dead_tup,
    last_vacuum
FROM pg_stat_user_tables
WHERE relname = 'vacuum_verbose_demo';

预期输出:

text
        relname        | n_live_tup | n_dead_tup |         last_vacuum
-----------------------+------------+------------+------------------------------
 vacuum_verbose_demo   |    <VALUE> |    <VALUE> | <TIME>
(1 row)

last_vacuum 应为本次操作时间;n_live_tup、n_dead_tup 都是统计估算,不要求精确等于 16000 和 0,但在无并发写入的测试环境中,VACUUM 后 n_dead_tup 应明显下降。若 VERBOSE 持续出现较多 dead but not yet removable,而重复 VACUUM 没有改善,就应把问题从“清理是否执行”转向“谁在持有回收边界”。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 VERBOSE 读懂 VACUUM 结果

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

登录哪都通