PostgreSQL / 系统课时
用 VERBOSE 读懂 VACUUM 结果
用 VERBOSE 读懂 VACUUM 结果
VACUUM VERBOSE 的价值不在于“日志更多”,而在于把扫描页数、可回收元组、暂不能回收的版本、索引清理、可见性位和 I/O 成本串成证据链。本课用一张测试表跑一次清理,再把输出翻译成可验证的维护结论。
学习目标
- 能从
VACUUM VERBOSE输出中区分“已清理”“暂不能清理”和“未发生页截断” - 能用
removable cutoff、索引清理与 Visibility Map 信息判断下一步排查方向 - 能用统计视图复核 VACUUM 是否执行以及死元组估算是否下降
构造一次可观察的清理
下面在独立测试表中制造 UPDATE 和 DELETE 产生的旧版本,再执行普通 VACUUM。不要把 VACUUM 放进显式事务块;它必须作为独立命令运行。
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 数字会随环境变化):
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”以及死元组估算是否回落。执行:
SELECT
relname,
n_live_tup,
n_dead_tup,
last_vacuum
FROM pg_stat_user_tables
WHERE relname = 'vacuum_verbose_demo';预期输出:
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 没有改善,就应把问题从“清理是否执行”转向“谁在持有回收边界”。