描述

VACUUM回收被删除元组占用的存储空间。在正常的 PostgreSQL运行中，被删除或因更新而过时的元组 并不会从其表中物理移除；它们会一直保留，直到执行 VACUUM。因此有必要定期执行 VACUUM，尤其是对频繁更新的表。

不带参数时，VACUUM处理当前数据库中的每个表。带参数时，VACUUM只处理该表。

VACUUM ANALYZE会对每个选定表先执行 VACUUM，再执行ANALYZE。 这种便捷的组合形式很适合例行维护脚本使用。关于其处理细节，参见 ANALYZE。

普通的VACUUM（不带FULL）只是回收空间并使其可被重用。 这种形式的命令可以与表的正常读写并行运行，因为它不会获得独占锁。VACUUM FULL会做更彻底的处理，包括跨块移动元组，以尽量把表压缩到最少数量的磁盘块。 这种形式要慢得多，并且在处理每个表时都需要独占锁。

参数

输出

指定VERBOSE时，VACUUM会输出进度消息， 指示当前正在处理哪个表，同时还会打印这些表的各种统计信息。

注解

VACUUM不能在一个事务块内被执行。

我们建议对活跃的生产数据库频繁执行清理（至少每晚一次），以移除过期的行。在添加或删除大量行之后，对受影响的表执行VACUUM ANALYZE命令可能是个好主意。这会用所有近期变更的结果更新系统目录，使PostgreSQL查询规划器在规划查询时能够做出更好的选择。

FULL选项不建议在日常场景中使用，但在某些特殊情况下可能很有用。 例如，当你删除了表中的绝大多数行，并希望该表在物理上收缩以占用更少磁盘空间时， 这个选项就比较合适。VACUUM FULL通常会比普通 VACUUM更大幅度地收缩表。FULL选项不会收缩索引；仍然建议定期执行REINDEX。事实上，先删除所有索引、执行VACUUM FULL、再重建索引，往往反而更快。

VACUUM会显著增加 I/O 流量，这可能导致其他活动会话性能变差。 因此，有时建议使用基于代价的清理延迟特性。详见第 17.4.4 节。

PostgreSQL提供了一个“自动清理（autovacuum）”机制，可以自动执行常规清理维护。有关自动与手动清理的更多信息，参见第 22.1 节。

示例

下面是对回归数据库中的一个表运行 VACUUM 的例子：

regression=# VACUUM VERBOSE ANALYZE onek;
INFO:  vacuuming "public.onek"
INFO:  index "onek_unique1" now contains 1000 tuples in 14 pages
DETAIL:  3000 index tuples were removed.
0 index pages have been deleted, 0 are currently reusable.
CPU 0.01s/0.08u sec elapsed 0.18 sec.
INFO:  index "onek_unique2" now contains 1000 tuples in 16 pages
DETAIL:  3000 index tuples were removed.
0 index pages have been deleted, 0 are currently reusable.
CPU 0.00s/0.07u sec elapsed 0.23 sec.
INFO:  index "onek_hundred" now contains 1000 tuples in 13 pages
DETAIL:  3000 index tuples were removed.
0 index pages have been deleted, 0 are currently reusable.
CPU 0.01s/0.08u sec elapsed 0.17 sec.
INFO:  index "onek_stringu1" now contains 1000 tuples in 48 pages
DETAIL:  3000 index tuples were removed.
0 index pages have been deleted, 0 are currently reusable.
CPU 0.01s/0.09u sec elapsed 0.59 sec.
INFO:  "onek": removed 3000 tuples in 108 pages
DETAIL:  CPU 0.01s/0.06u sec elapsed 0.07 sec.
INFO:  "onek": found 3000 removable, 1000 nonremovable tuples in 143 pages
DETAIL:  0 dead tuples cannot be removed yet.
There were 0 unused item pointers.
0 pages are entirely empty.
CPU 0.07s/0.39u sec elapsed 1.56 sec.
INFO:  analyzing "public.onek"
INFO:  "onek": 36 pages, 1000 rows sampled, 1000 estimated total rows
VACUUM

兼容性

在SQL标准中没有VACUUM语句。

另见