DESC VOLUME
查看 Volume 的详细信息，包括创建者、创建时间、存储路径、连接名称及目录配置等。
语法
DESC VOLUME [schema_name.]<volume_name>;
DESCRIBE VOLUME
DESCRIBE VOLUME
与
DESC VOLUME
DESC VOLUME
等价。
参数说明
| 参数 | 说明 |
|---|
schema_name
schema_name | 所属 schema 名称，省略时使用当前 schema |
volume_name
volume_name | 要查看的 Volume 名称 |
使用示例
- 查看 External Volume 详情：
DESC VOLUME my_oss_vol;
输出示例：
+------------------------+--------------------------------+
| info_name | info_value |
+------------------------+--------------------------------+
| name | my_oss_vol |
| creator | qiliang |
| created_time | 2026-05-20 00:23:49.074 |
| last_modified_time | 2026-05-20 00:23:49.074 |
| external | true |
| url | oss://mcp-data-hangzhou/test/ |
| connection_name | quick_start.oss_conn |
| recursive | true |
| directory_enabled | true |
| directory_auto_refresh | true |
+------------------------+--------------------------------+
- 查看 Named Volume 详情：
DESC VOLUME my_named_vol;
- 查看指定 schema 下的 Volume：
DESC VOLUME my_schema.my_oss_vol;
输出字段说明
| 字段 | 说明 |
|---|
name
name | Volume 名称 |
creator
creator | 创建者用户名 |
created_time
created_time | 创建时间 |
last_modified_time
last_modified_time | 最后修改时间 |
external
external | 是否为外部存储（true
true 表示挂载外部存储，false
false 表示内部存储） |
url
url | 对象存储路径（仅 External Volume 有值） |
connection_name
connection_name | 关联的 Storage Connection 名称（仅 External Volume 有值） |
recursive
recursive | 是否递归扫描子目录 |
directory_enabled
directory_enabled | 是否启用目录功能 |
directory_auto_refresh
directory_auto_refresh | 是否自动刷新文件元数据 |
权限要求
| 权限 | 说明 |
|---|
READ METADATA
READ METADATA | 查看 Volume 对象元信息 |
相关文档
