CREATE VOLUME

创建一个 Named Volume，使用 Lakehouse 内部存储空间。Named Volume 属于内部 Volume，需要用户显式创建并自行管理生命周期，适用于跨团队共享资源等场景。与 User Volume 和 Table Volume（系统自动创建）不同，Named Volume 由用户主动创建。

语法

CREATE VOLUME [IF NOT EXISTS] [schema_name.]<volume_name> DIRECTORY = ( enable = { true | false }, auto_refresh = { true | false } ) RECURSIVE = { true | false };

参数说明

参数	说明
`IF NOT EXISTS` IF NOT EXISTS	若 Volume 已存在则跳过，不报错
`schema_name` schema_name	所属 schema 名称，省略时使用当前 schema
`volume_name` volume_name	Volume 名称，在同一 schema 下唯一
`DIRECTORY.enable` DIRECTORY.enable	是否启用目录功能，建议设为 `true` true
`DIRECTORY.auto_refresh` DIRECTORY.auto_refresh	是否自动刷新文件元数据
`RECURSIVE` RECURSIVE	是否递归扫描子目录

使用示例

创建 Named Volume，使用内部存储：

CREATE VOLUME my_named_vol DIRECTORY = (enable = true, auto_refresh = true) RECURSIVE = true;

在指定 schema 下创建 Named Volume：

CREATE VOLUME IF NOT EXISTS my_schema.shared_vol DIRECTORY = (enable = true, auto_refresh = true) RECURSIVE = true;

注意事项

Named Volume 的存储费用按 Lakehouse 存储标准收取
Named Volume 不支持
```
ALTER VOLUME ... REFRESH
```
ALTER VOLUME ... REFRESH
操作（仅 External Volume 支持）
删除 Named Volume 不会删除内部存储中的实际文件，如需删除文件请先使用
```
REMOVE
```
REMOVE
命令

权限要求

权限	说明
`CREATE VOLUME` CREATE VOLUME	在当前 schema 下创建 Volume

CREATE VOLUME

语法

参数说明

使用示例

注意事项

权限要求

相关文档