REMOVE VOLUME FILE 命令

REMOVE 命令用于从 Lakehouse Volume 对象中删除文件或目录，删除操作会同步清除底层对象存储中的实际数据，不可恢复。支持外部 Volume、TABLE VOLUME 和 USER VOLUME 三种目标类型。该命令可在 Studio 和 Lakehouse 客户端中执行。

语法

REMOVE { VOLUME volume_name | TABLE VOLUME table_name | USER VOLUME } { FILE 'file' | SUBDIRECTORY 'dir' }

参数说明

参数	是否必填	说明
`VOLUME volume_name` VOLUME volume_name	三选一	从指定的外部 Volume 中删除文件。
`TABLE VOLUME table_name` TABLE VOLUME table_name	三选一	从指定表的 TABLE VOLUME 暂存空间中删除文件。
`USER VOLUME` USER VOLUME	三选一	从当前用户的 USER VOLUME 中删除文件。
`FILE 'file'` FILE 'file'	二选一	指定要删除的文件路径（相对于 Volume 根目录）。
`SUBDIRECTORY 'dir'` SUBDIRECTORY 'dir'	二选一	指定要删除的子目录，该目录下的所有文件将被递归删除。

示例

示例 1：删除 USER VOLUME 中的单个文件

REMOVE USER VOLUME FILE 'university_info.csv';

示例 2：删除 USER VOLUME 子目录中的文件

REMOVE USER VOLUME FILE 'test_export/part00001.csv';

示例 3：删除 USER VOLUME 中的整个子目录

REMOVE USER VOLUME SUBDIRECTORY 'test_export/';

示例 4：删除外部 Volume 中的文件

REMOVE VOLUME hz_image_volume FILE 'catsdogs.zip';

示例 5：删除外部 Volume 中的子目录

REMOVE VOLUME my_volume SUBDIRECTORY 'delta-format/uploaddelta';

示例 6：导入完成后清理 TABLE VOLUME 暂存文件

数据导入完成后，删除 TABLE VOLUME 中的暂存文件以释放存储空间：

-- 查看暂存文件 SHOW TABLE VOLUME DIRECTORY tbl_region; -- 删除已导入的文件 REMOVE TABLE VOLUME tbl_region FILE 'region.tbl';

注意事项

删除操作不可恢复，执行前请确认文件路径正确，建议先通过
```
SHOW USER VOLUME DIRECTORY
```
SHOW USER VOLUME DIRECTORY
或
```
SHOW VOLUME DIRECTORY
```
SHOW VOLUME DIRECTORY
确认文件存在。
使用
```
SUBDIRECTORY
```
SUBDIRECTORY
时，该目录下的所有文件将被递归删除，请谨慎操作。
删除外部 Volume 中的文件会同步删除底层对象存储（OSS/COS/S3）中的实际数据。
执行 REMOVE 命令需要对目标 Volume 具有写入权限。
可结合 Lakehouse 定时调度任务，自动清理已导入的暂存文件，节省存储成本。

联系我们