文档首页/ 云数据库 GaussDB/ 开发指南（主备版_8.x）/ SQL参考/ SQL语法/ V/ VACUUM
更新时间：2024-08-20 GMT+08:00
查看PDF
分享

VACUUM

功能描述

VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。在一般的数据库操作里，那些已经DELETE的行并没有从它们所属的表中物理删除；在完成VACUUM之前它们仍然存在。因此有必要周期地运行VACUUM，特别是在经常更新的表上。

注意事项

  • 如果没有参数，VACUUM处理当前数据库里用户拥有相应权限的每个表。如果参数指定了一个表，VACUUM只处理指定的表。
  • 要对一个表进行VACUUM操作，通常用户必须是表的所有者或者被授予了指定表VACUUM权限的用户，三权分立开关关闭时，默认系统管理员有该权限。数据库的所有者允许对数据库中除了共享目录以外的所有表进行VACUUM操作（该限制意味着只有系统管理员才能真正对一个数据库进行VACUUM操作）。VACUUM命令会跳过那些用户没有权限的表进行垃圾回收操作。
  • VACUUM不能在事务块内执行。
  • 建议生产数据库经常清理（至少每晚一次），以保证不断地删除失效的行。尤其是在增删了大量记录之后，对受影响的表执行VACUUM ANALYZE命令是一个很好的习惯。这样将更新系统目录为最近的更改，并且允许查询优化器在规划用户查询时有更好地选择。
  • 不建议日常使用FULL选项，但是可以在特殊情况下使用。例如在用户删除了一个表的大部分行之后，希望从物理上缩小该表以减少磁盘空间占用。VACUUM FULL通常要比单纯的VACUUM收缩更多的表尺寸。FULL选项并不清理索引，所以推荐周期性的运行REINDEX命令。如果执行此命令后所占用物理空间无变化（未减少），请确认是否有其他活跃事务（删除数据事务开始之前开始的事务，并在VACUUM FULL执行前未结束）存在，如果有等其他活跃事务退出进行重试。
  • VACUUM FULL通过重建表的方式将表内空闲空间归还给表空间，重建过程需要额外申请表中有效数据相当的存储空间。对于非段页式表，VACUUM FULL执行结束后，原表所占物理文件会被删除，原表所占的物理文件的空间会归还给操作系统；对于段页式表，VACUUM FULL执行结束后，原表所占的物理空间，会被归还给段页式数据文件，不会归还给操作系统。
  • VACUUM会导致I/O流量的大幅增加，这可能会影响其他活动会话的性能。因此，有时候会建议使用基于开销的VACUUM延迟特性。
  • 如果指定了VERBOSE选项，VACUUM将打印处理过程中的信息，以表明当前正在处理的表。各种有关当前表的统计信息也会打印出来。
  • 当含有带括号的选项列表时，选项可以以任何顺序写入。如果没有括号，则选项必须按语法显示的顺序给出。
  • VACUUM和VACUUM FULL时，会根据参数vacuum_defer_cleanup_age延迟清理行存表记录，即不会立即清理刚刚删除的元组。
  • VACUUM ANALYZE先执行一个VACUUM操作，然后给每个选定的表执行一个ANALYZE。对于日常维护脚本而言，这是一个很方便的组合。
  • 简单的VACUUM（不带FULL选项）只是简单地回收空间并且令其可以再次使用。这种形式的命令可以和对表的普通读写并发操作，因为没有请求排他锁。VACUUM FULL执行更广泛的处理，包括跨块移动行，以便把表压缩到最少的磁盘块数目里。这种形式要慢许多并且在处理的时候需要在表上施加一个排他锁。
  • 同时执行多个VACUUM FULL可能出现死锁。
  • 如果没有打开xc_maintenance_mode参数，那么VACUUM FULL操作将跳过所有系统表。
  • 执行DELETE后立即执行VACUUM FULL命令不会回收空间。执行DELETE后再执行1000个非SELECT事务，或者等待1s后再执行1个事务，之后再执行VACUUM FULL命令空间才会回收。
  • VACUUM FULL期间会对表加排他锁，不建议在业务高峰期运行VACUUM FULL，可能导致等待时间过长或者业务中断。
  • Ustore手动VACUUM与Astore手动VACUUM行为一致、会对堆表、索引等进行加锁清理；而Ustore的AUTOVACUUM仅做分区表GPI清理、堆表FSM更新以及索引页面回收。
  • VACUUM FULL分区表时，会遍历分区进行清理，并在分区清理后重建GPI，因此当分区较多时，建议先删除GPI，在VACUUM FULL执行完成后重新创建索引，以此降低VACUUM FULL的执行时间。

语法格式

  • 回收空间并更新统计信息，对关键字顺序无要求。 
    VACUUM [ ( { FULL | FREEZE | VERBOSE | {ANALYZE | ANALYSE }} [,...] ) ]
    [ table_name [ (column_name [, ...] ) ] [ PARTITION ( partition_name ) | SUBPARTITION ( subpartition_name ) ] ];
  • 仅回收空间，不更新统计信息。 
    VACUUM [ FULL [COMPACT] ] [ FREEZE ] [ VERBOSE ] [ table_name 
[ PARTITION ( partition_name )  | SUBPARTITION ( subpartition_name ) ] ];
  • 回收空间并更新统计信息，且对关键字顺序有要求。 
    VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] { ANALYZE | ANALYSE } [ VERBOSE ] 
    [ table_name [ (column_name [, ...] ) ] ] [ PARTITION ( partition_name ) ];
  • 仅回收指定bucket的空间，更新pg_hashbucket系统表的bucketxid列，不更新统计信息。当前版本暂不支持。 
    1
    		 
    VACUUM FREEZE BUCKETS (bucketid [, ...]);

参数说明

  • FULL

    选择“FULL”清理，这样可以恢复更多的空间，但是需要耗时更多，并且在表上施加了排他锁。

    使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。

  • FREEZE

    指定FREEZE相当于执行VACUUM时将vacuum_freeze_min_age参数设为0。

  • VERBOSE

    为每个表打印一份详细的清理工作报告。

  • ANALYZE | ANALYSE

    更新用于优化器的统计信息，以决定执行查询的最有效方法。

    ustore分区表在autovacuum=analyze的时候也会触发vacuum。

  • table_name

    要清理的表的名称（可以有模式修饰）。

    取值范围：要清理的表的名称。缺省时为当前数据库中的所有表。

  • column_name

    要分析的具体的字段名称，需要配合analyze选项使用。

    取值范围：要分析的具体的字段名称。缺省时为所有字段。

    由于VACUUM ANALYZE语句的机制是依次执行VACUUM和ANALYZE，因此当column_name错误时，会存在VACUUM执行成功但ANALYZE执行失败的情况；对于分区表，则会出现对某个分区VACUUM执行成功之后ANALYZE执行失败的情况。

  • PARTITION

    COMPACT和PARTITION参数不能同时使用。

  • partition_name

    要清理的表的一级分区名称。缺省时为所有一级分区。

  • subpartition_name

    要清理的表的二级分区名称。缺省时为所有二级分区。

示例

  • VACUUM 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
    		 
    --创建表tbl_test，并插入数据。
gaussdb=# CREATE TABLE tbl_test(c1 int); 
gaussdb=# INSERT INTO tbl_test VALUES (1); 

--查看数据，和数据的ctid。
gaussdb=# SELECT ctid,* FROM tbl_test;
 ctid  | c1 
-------+----
 (0,1) |  1
(1 row)

--删除该数据。
gaussdb=# DELETE FROM tbl_test;

--重新插入一条数据，发现使用了一个新的ctid。
gaussdb=# INSERT INTO tbl_test VALUES (2);
gaussdb=# SELECT ctid,* FROM tbl_test;
 ctid  | c1 
-------+----
 (0,2) |  2
(1 row)

--使用VACUUM命令之后，在插入数据，发现复用了旧的空间。
gaussdb=# VACUUM ANALYZE tbl_test;
gaussdb=# INSERT INTO tbl_test VALUES (3);
gaussdb=# SELECT ctid,* FROM tbl_test;
 ctid  | c1 
-------+----
 (0,1) |  3
 (0,2) |  2
(2 rows)

--删除表。
gaussdb=# DROP TABLE tbl_test;
  • VACUUM FULL 
    --建表。
gaussdb=# CREATE TABLE tbl_test2(c1 int);

--插入10万条数据并查看表的大小。
gaussdb=# INSERT INTO tbl_test2 VALUES (generate_series(1,100000));
gaussdb=# SELECT 'tbl_test2' AS tablename, pg_size_pretty(pg_relation_size('tbl_test2')) AS size;
 tablename |  size   
-----------+---------
 tbl_test2 | 3048 kB
(1 row)

--删除数据并查看表大小。
gaussdb=# DELETE FROM tbl_test2;
gaussdb=# SELECT 'tbl_test2' AS tablename, pg_size_pretty(pg_relation_size('tbl_test2')) AS size;
 tablename |  size   
-----------+---------
 tbl_test2 | 3048 kB
(1 row)

--使用VACUUM FULL回收空间,并查看表的大小。
gaussdb=# VACUUM FULL ANALYZE tbl_test2;
gaussdb=# SELECT 'tbl_test2' AS tablename, pg_size_pretty(pg_relation_size('tbl_test2')) AS size;
 tablename |  size   
-----------+---------
 tbl_test2 | 0 bytes
(1 row)


--删除。
gaussdb=# DROP TABLE tbl_test2;

优化建议

  • VACUUM
    • VACUUM不能在事务块内执行。
    • 建议生产数据库经常清理（至少每晚一次），以保证不断地删除失效的行。尤其是在增删了大量记录后，对相关表执行VACUUM ANALYZE命令。
    • 不建议日常使用FULL选项，但是可以在特殊情况下使用。例如，一个例子就是在用户删除了一个表的大部分行之后，希望从物理上缩小该表以减少磁盘空间占用。
父主题： V