描述

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

不带参数时，VACUUM会处理当前数据库中当前用户有权清理的每个表。带参数时，VACUUM则只处理该表。

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

普通的VACUUM（不带FULL）只是回收空间并使其可被重用。 这种形式的命令可以与表的正常读写并行运行，因为它不会获得独占锁。 不过，在大多数情况下，额外空间不会返还给操作系统；它只是保留在同一张表内供再次使用。 VACUUM FULL会把表的全部内容重写到一个没有额外空闲空间的新磁盘文件中， 从而让未使用的空间能够返还给操作系统。这种形式要慢得多，并且在处理每个表时都需要 独占锁。

当选项列表被圆括号包围时，选项可以按任意顺序书写。不带圆括号时，选项必须完全按照上面所示的顺序指定。在PostgreSQL 9.0 之前，只支持不带圆括号的语法。预计所有新选项将只在带圆括号的语法中受支持。

参数

输出

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

注解

要清理一个表，通常调用者必须是该表的拥有者或超级用户。 不过，数据库拥有者可以清理其数据库中的所有表，但共享系统目录除外。 （对共享系统目录的这一限制意味着，真正意义上的全数据库 VACUUM 只能由超级用户执行。） VACUUM 会跳过调用用户无权清理的任何表。

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

对于带有GIN索引的表，VACUUM（任何形式）还会通过把待处理的索引项移动到主 GIN索引结构中的适当位置，来完成所有挂起的索引插入。详见 第 53.3.1 节。

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

FULL选项不建议在日常场景中使用，但在某些特殊情况下可能很有用。 例如，当你删除或更新了表中的绝大多数行，并希望该表在物理上收缩以占用更少磁盘空间、 让表扫描更快时，这个选项就比较合适。VACUUM FULL通常会比普通 VACUUM更大幅度地收缩表。

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

PostgreSQL提供了一个“自动清理（autovacuum）”机制，可以自动执行常规清理维护。有关自动与手动清理的更多信息，参见第 23.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语句。

另见