VACUUM DROP TABLE

Introduced or updated: v1.2.368

企业版功能

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

VACUUM DROP TABLE 命令通过永久删除已删除表的数据文件来帮助节省存储空间，释放存储空间，并使您能够高效地管理该过程。它提供了可选参数，以针对特定数据库、预览和限制要清理的数据文件数量。要列出数据库中已删除的表，请使用 SHOW DROP TABLES。

另请参阅：VACUUM TABLE

语法

VACUUM DROP TABLE
    [ FROM <database_name> ]
    [ DRY RUN [SUMMARY] ]
    [ LIMIT <file_count> ]

• FROM <database_name>: 此参数将已删除表的搜索限制在特定数据库。如果未指定，该命令将扫描所有数据库，包括已删除的数据库。

  示例:

  -- 从 "default" 数据库中删除已删除的表
  // highlight-next-line
  VACUUM DROP TABLE FROM default;
  
  -- 从所有数据库中删除已删除的表
  // highlight-next-line
  VACUUM DROP TABLE;

• DRY RUN [SUMMARY]: 当指定此参数时，数据文件不会被删除；相反，它会返回一个结果，显示如果未指定此参数，哪些数据文件将被删除。请参阅 输出 部分中的示例。

• LIMIT <file_count>: 此参数可以与 DRY RUN 参数一起使用，也可以不使用。当与 DRY RUN 一起使用时，它限制了 DRY RUN 结果中显示的数据文件数量。当不使用 DRY RUN 时，它限制了要清理的数据文件数量。

输出

当指定 DRY RUN 或 DRY RUN SUMMARY 参数时，VACUUM DROP TABLE 命令会返回一个结果：

• DRY RUN: 返回每个已删除表的最多 1,000 个候选文件及其大小的列表（以字节为单位）。
• DRY RUN SUMMARY: 返回每个已删除表要删除的文件总数及其总大小。

示例:

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

┌──────────────────────────────────────────────────────────────────┐
│  table │                     file                    │ file_size │
├────────┼─────────────────────────────────────────────┼───────────┤
│ b      │ 313ebd4da5cc493f9a7d491da8253ce2_v2.parquet │       210 │
│ b      │ 737f2215b8ac4a268d5b7f2218273358_v2.parquet │       210 │
│ b      │ 737f2215b8ac4a268d5b7f2218273358_v4.parquet │       340 │
│ b      │ 313ebd4da5cc493f9a7d491da8253ce2_v4.parquet │       340 │
│ b      │ last_snapshot_location_hint                 │        72 │
│ b      │ 7e01fa5c2e0a495298942671447dc8cb_v4.mpk     │       515 │
│ b      │ 2bc90e5be55c44258a736d27e5f7ac9e_v4.mpk     │       459 │
│ b      │ 85e73803aabc4eb48774db3d932312dd_v4.mpk     │       534 │
│ b      │ f0e507d0b825428dbfe57c8d8b620a15_v4.mpk     │       533 │
│ c      │ cee790e76f6e4e92bc9dab3b9e873dcf_v2.parquet │       210 │
│ c      │ 4bcb2cef3b6344cb951908ebee5ceb36_v2.parquet │       210 │
│ c      │ cee790e76f6e4e92bc9dab3b9e873dcf_v4.parquet │       340 │
│ c      │ 4bcb2cef3b6344cb951908ebee5ceb36_v4.parquet │       340 │
│ c      │ last_snapshot_location_hint                 │        71 │
│ c      │ 414fc6a8dc6746afbc576cf8fddfcdf3_v4.mpk     │       516 │
│ c      │ 8d0d115c438244c295e3bfd50d556e39_v4.mpk     │       458 │
│ c      │ 28e4f551cc634d3d8d7e648c3baa5f5c_v4.mpk     │       534 │
│ c      │ 007b57e08eda419fbb451a3a3ed71de8_v4.mpk     │       533 │
└──────────────────────────────────────────────────────────────────┘
// highlight-next-line
VACUUM DROP TABLE DRY RUN SUMMARY;

┌───────────────────────────────────┐
│  table │ total_files │ total_size │
├────────┼─────────────┼────────────┤
│ b      │           9 │       3213 │
│ c      │           9 │       3212 │
└───────────────────────────────────┘

调整数据保留时间

VACUUM DROP 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';