VACUUM TABLE

Introduced or updated: v1.2.368

企业版功能

VACUUM TABLE是企业版功能。 如需获取许可证，请联系 Databend 支持团队。

VACUUM TABLE 命令通过永久删除表中的历史数据文件来释放存储空间，从而帮助优化系统性能。这包括：

• 与表关联的快照，以及它们相关的 segment 和 block。

• 孤立文件。Databend 中的孤立文件指的是不再与表关联的快照、segment 和 block。孤立文件可能由各种操作和错误产生，例如在数据备份和恢复期间，并且会占用宝贵的磁盘空间并降低系统性能。

另请参阅：VACUUM DROP TABLE

语法和示例

VACUUM TABLE <table_name> [ DRY RUN [SUMMARY] ]

• DRY RUN [SUMMARY]: 指定此参数后，将不会删除候选的孤立文件。相反，将返回最多 1,000 个候选文件及其大小（以字节为单位）的列表，显示如果未使用该选项将删除的内容。当包含可选参数 SUMMARY 时，该命令将返回要删除的文件总数及其以字节为单位的总大小。

输出

VACUUM TABLE 命令（不带 DRY RUN）返回一个表格，总结了已清理文件的重要统计信息，包含以下列：

列	描述
snapshot_files	快照文件数
snapshot_size	快照文件总大小（以字节为单位）
segments_files	segment 文件数
segments_size	segment 文件总大小（以字节为单位）
block_files	block 文件数
block_size	block 文件总大小（以字节为单位）
index_files	索引文件数
index_size	索引文件总大小（以字节为单位）
total_files	所有类型的文件总数
total_size	所有类型的文件总大小（以字节为单位）

Example:

// highlight-next-line
VACUUM TABLE c;

┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ snapshot_files │ snapshot_size │ segments_files │ segments_size │ block_files │ block_size │ index_files │ index_size │ total_files │ total_size │
├────────────────┼───────────────┼────────────────┼───────────────┼─────────────┼────────────┼─────────────┼────────────┼─────────────┼────────────┤
│              3 │          1954 │              9 │          4802 │           9 │       1890 │           9 │       3060 │          30 │      11706 │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

当使用 VACUUM TABLE 命令指定 DRY RUN 参数时，它会返回最多 1,000 个候选文件及其大小（以字节为单位）的列表。如果指定了 DRY RUN SUMMARY，则该命令会提供要删除的文件总数及其总大小。

Example:

// highlight-next-line
VACUUM TABLE c DRY RUN;

┌──────────────────────────────────────────────────────────────┐
│                       file                       │ file_size │
├──────────────────────────────────────────────────┼───────────┤
│ 1/67/_ss/61aaf678b9af41568b539099b4b09908_v4.mpk │       543 │
│ 1/67/_ss/dd149d21151c459d8c87076f9412c12c_v4.mpk │       516 │
│ 1/67/_ss/7ba0b2e2f63c4d42897a48830027dcf3_v4.mpk │       462 │
│ 1/67/_ss/db55dac72b29452db976cf0af0f8d962_v4.mpk │       588 │
│ 1/67/_ss/d8055967298f478d97cddaa66cf67e11_v4.mpk │       563 │
│ 1/67/_ss/00c4288dac014760808006f821f1ecbe_v4.mpk │       609 │
└──────────────────────────────────────────────────────────────┘
// highlight-next-line
VACUUM TABLE c DRY RUN SUMMARY;

┌──────────────────────────┐
│ total_files │ total_size │
├─────────────┼────────────┤
│           6 │       3281 │
└──────────────────────────┘

调整数据保留时间

VACUUM TABLE 命令会删除早于 data_retention_time_in_days 设置的数据文件。可以根据需要调整此保留期限，例如，调整为 2 天：

SET GLOBAL data_retention_time_in_days = 2;

data_retention_time_in_days 默认为 1 天（24 小时），最大值因 Databend 版本而异：

版本	默认保留时间	最大保留时间
Databend 社区版 & 企业版	1 天（24 小时）	90 天
Databend Cloud (基础版)	1 天（24 小时）	1 天（24 小时）
Databend Cloud (商业版)	1 天（24 小时）	90 天

要检查 data_retention_time_in_days 的当前值：

SHOW SETTINGS LIKE 'data_retention_time_in_days';

VACUUM TABLE vs. OPTIMIZE TABLE

Databend 提供了两个命令来删除表中的历史数据文件：VACUUM TABLE 和 OPTIMIZE TABLE（带有 PURGE 选项）。虽然这两个命令都能够永久删除数据文件，但它们在处理孤立文件的方式上有所不同：OPTIMIZE TABLE 能够删除孤立的快照，以及相应的 segment 和 block。但是，可能存在没有任何关联快照的孤立 segment 和 block。在这种情况下，只有 VACUUM TABLE 才能帮助清理它们。

VACUUM TABLE 和 OPTIMIZE TABLE 都允许您指定一个时间段来确定要删除哪些历史数据文件。但是，OPTIMIZE TABLE 需要您事先从查询中获取快照 ID 或时间戳，而 VACUUM TABLE 允许您直接指定保留数据文件的小时数。VACUUM TABLE 通过 DRY RUN 选项增强了对历史数据文件的控制，该选项允许您在应用命令之前预览要删除的数据文件。这提供了安全的删除体验，并帮助您避免意外的数据丢失。

	VACUUM TABLE	OPTIMIZE TABLE
关联的快照（包括 segment 和 block）	是	是
孤立的快照（包括 segment 和 block）	是	是
仅孤立的 segment 和 block	是	否
DRY RUN	是	否