PostgreSQL / 系统课时
搭建 MVCC 与 VACUUM 实验环境
搭建 MVCC 与 VACUUM 实验环境
这一课搭一套可反复重置的 PostgreSQL 18 本地实验实例,打开必要的 autovacuum 日志与计时开关,并准备样本表、观察扩展和监控查询。完成后可稳定复现死元组、长事务与 VACUUM 行为。
学习目标
- 用 Docker 启动参数固定一套 MVCC/VACUUM 实验基线
- 安装
pgstattuple、pg_visibility、pageinspect三个观察扩展 - 用系统视图确认表统计、事务视界与 VACUUM 进度都可观测
确认实验前置
建议使用独立开发机或测试机,确保已安装 Docker,并让本机 5432 端口可用。下面的密码只用于本地一次性实验,不能照搬到共享或生产环境。
docker version --format '{{.Server.Version}}'预期输出是当前 Docker Server 版本,具体数字因安装环境不同:
<DOCKER_VERSION>如果这里无法返回版本,先修复 Docker daemon;不要继续排查 PostgreSQL,因为后面的容器和网络现象都会被前置故障污染。
启动 PostgreSQL 18 实验实例
启动实例时显式打开 autovacuum 与统计采集,把 autovacuum_naptime 缩短到 5 秒,并记录所有 autovacuum 动作。track_io_timing 与 track_cost_delay_timing 会增加少量计时开销,因此这里用于实验观测,不代表生产默认建议。
docker run --name pg-mvcc-lab \
-e POSTGRES_PASSWORD=postgres \
-e POSTGRES_DB=mvcc_lab \
-p 5432:5432 \
-d postgres:18 \
-c autovacuum=on \
-c autovacuum_naptime=5s \
-c log_autovacuum_min_duration=0 \
-c track_counts=on \
-c track_io_timing=on \
-c track_cost_delay_timing=on预期输出是容器 ID:
<ID>等待实例就绪后检查连接与主版本。
docker exec pg-mvcc-lab pg_isready -U postgres -d mvcc_lab
docker exec pg-mvcc-lab psql -U postgres -d mvcc_lab -Atqc "SHOW server_version;"预期输出中的小版本可能不同:
<SOCKET>:5432 - accepting connections
18.<MINOR>安装观察扩展并建立样本表
pgstattuple 用于观察活元组、死元组与空闲空间,pg_visibility 用于查看 visibility map,pageinspect 用于更低层的页与 tuple 诊断。它们都适合实验和深度排障,但不应因为“能看得更底层”就在生产高频全表调用。
docker exec -i pg-mvcc-lab psql -U postgres -d mvcc_lab <<'SQL'
CREATE EXTENSION IF NOT EXISTS pgstattuple;
CREATE EXTENSION IF NOT EXISTS pg_visibility;
CREATE EXTENSION IF NOT EXISTS pageinspect;
CREATE TABLE IF NOT EXISTS lab_accounts (
id bigint PRIMARY KEY,
owner text NOT NULL,
balance integer NOT NULL,
updated_at timestamptz NOT NULL DEFAULT clock_timestamp()
);
TRUNCATE TABLE lab_accounts;
INSERT INTO lab_accounts(id, owner, balance)
VALUES
(1, 'alice', 1000),
(2, 'bob', 2000),
(3, 'carol', 3000);
ANALYZE lab_accounts;
SQL首次执行的关键输出应包含以下结果;重复执行时 IF NOT EXISTS 还可能给出对象已存在的提示。
CREATE EXTENSION
CREATE EXTENSION
CREATE EXTENSION
CREATE TABLE
TRUNCATE TABLE
INSERT 0 3
ANALYZE这个样本表故意保持很小。后续实验真正需要观察的是版本数量、视界和清理行为,而不是先制造大量数据把 I/O 噪声混进来。
建立监控基线
先确认刚才的关键参数确实生效。任何后续实验结果异常,都应该先回到这组基线,而不是直接猜 autovacuum “没工作”。
SHOW autovacuum;
SHOW autovacuum_naptime;
SHOW log_autovacuum_min_duration;
SHOW track_counts;
SHOW track_io_timing;
SHOW track_cost_delay_timing;预期关键值:
autovacuum = on
autovacuum_naptime = 5s
log_autovacuum_min_duration = 0
track_counts = on
track_io_timing = on
track_cost_delay_timing = on然后在 mvcc_lab 中执行下面的观察查询。第一组看表级活/死元组估算,第二组用 pgstattuple 看更直接的 tuple 统计,第三组看 visibility map,最后两组分别定位事务视界与正在执行的普通 VACUUM。
SELECT relname, n_live_tup, n_dead_tup, last_vacuum, last_autovacuum
FROM pg_stat_user_tables
WHERE relname = 'lab_accounts';
SELECT tuple_count, dead_tuple_count,
round(dead_tuple_percent::numeric, 2) AS dead_pct
FROM pgstattuple('lab_accounts');
SELECT all_visible, all_frozen
FROM pg_visibility_map_summary('lab_accounts'::regclass);
SELECT pid, state, backend_xid, backend_xmin
FROM pg_stat_activity
WHERE datname = current_database()
ORDER BY pid;
SELECT pid, relid::regclass AS relation, phase,
heap_blks_scanned, heap_blks_total
FROM pg_stat_progress_vacuum;在刚初始化、尚未制造更新和删除的环境中,核心结果应满足下面这些不变量;PID、事务视界和统计时间属于动态值。
lab_accounts: n_live_tup ≈ 3, n_dead_tup = 0
pgstattuple: tuple_count = 3, dead_tuple_count = 0, dead_pct = 0.00
pg_stat_activity: 至少能看到当前数据库会话,pid/backend_xmin 为动态值
pg_stat_progress_vacuum: 当前没有 VACUUM 时为 0 rowspg_stat_user_tables 的活/死元组是统计系统维护的估算值,而 pgstattuple 会读取关系来给出更直接的 tuple 级结果;两者职责不同,出现轻微差异并不自动意味着数据库异常。pg_visibility_map_summary 则关注页面是否 all-visible/all-frozen,它回答的是另一层问题。
固定后续实验的操作习惯
后续做 MVCC 与 VACUUM 实验时,保持同一容器和数据库,但每个实验开始前重置自己的样本表,并记录三类证据:执行了什么事务、pg_stat_activity 中谁持有最老视界、表统计与 VACUUM 进度如何变化。这样才能把“现象”与“原因”对齐。
需要看 autovacuum 的后台证据时直接读取容器日志即可,日志里的时间、PID、页数和 tuple 数都会随实验变化。
docker logs pg-mvcc-lab --since 10m 2>&1 | grep -Ei 'automatic vacuum|automatic analyze|autovacuum'如果最近十分钟确有 autovacuum 动作,预期能匹配到包含 automatic vacuum 或 automatic analyze 的日志行;若当前表尚未达到触发条件,命令没有输出也是正常结果。
<匹配到的 autovacuum 日志行,或无输出>这套环境的价值不在于模拟生产规模,而在于把版本可见性、死元组、visibility map、活动事务和 VACUUM 进度放到同一条证据链上。后续任何调参都应先能用这些观测点解释现象,再决定是否修改阈值或执行手工 VACUUM。