vacuumdb

PostgreSQL 清理与统计信息维护

补充说明

vacuumdb 是 VACUUM / ANALYZE 的命令行封装，用来回收死元组、更新统计信息、防止事务 ID 回卷。日常维护通常交给 autovacuum，特殊场景才手工执行。

常用示例

vacuumdb -d appdb --analyze
vacuumdb --all --analyze --jobs=4
vacuumdb -d appdb -t orders --vacuum --analyze --verbose
vacuumdb -d appdb --full -t orders        # 会长时间持锁
vacuumdb -d appdb --freeze --all
vacuumdb -d appdb --dry-run --all --analyze

易错点与排错

• VACUUM FULL 会重写整表并持有排他锁；生产环境优先 pg_repack 或维护窗口。
• 长事务、复制槽和未提交的 idle in transaction 会阻止死元组回收；先查 pg_stat_activity。
• --analyze 只更新统计信息，不回收空间；--vacuum 也不等同于 FULL。
• --jobs 只能和 --all 或 -d 的部分模式配合；不是所有版本都支持。
• 事务 ID 接近回卷时必须尽快处理；只看磁盘空间会漏掉这个风险。
• --freeze 会加速冻住旧元组，但可能增加 I/O；按版本行为确认。
• autovacuum 被关闭或参数过保守时，手工维护只能救急，不能替代配置。

相关命令

• reindexdb — 重建索引
• psql — 查看 pg_stat_activity 和表膨胀
• pg_dump — 维护前备份