适用于：
Databricks SQL Databricks Runtime 13.3 LTS 及更高版本 仅 Unity Catalog
返回现有卷的元数据。 元数据信息包括卷名称、架构、目录、类型、注释和所有者。
语法
DESCRIBE VOLUME volume_name
参数
- volume_name：Unity Catalog 中现有卷的名称。 如果该名称不存在，则会引发异常。
返回
具有以下列的单行结果集：
-
name STRING NOT NULL：卷的名称；它标识卷对象。 -
catalog STRING NOT NULL：包含卷的目录的名称。 -
database STRING NOT NULL：包含卷的架构的名称。 -
owner STRING NOT NULL：拥有卷的主体。 -
storageLocation STRING：外部卷所在的外部位置的路径。NULL用于托管卷。 -
volumeType STRING NOT NULL：卷的类型，可能的值：EXTERNAL、MANAGED。 -
comment STRING：附加到卷的注释。
示例
- Describe an external volume
> DESCRIBE VOLUME my_external_volume
name catalog database owner storageLocation volumeType comment
------------------ --------------- -------------- ----- ---------------------------------- ---------- ---------------
my_external_volume default_catalog default_schema Alice s3://my-bucket/my-location/my-path EXTERNAL My first volume
- Describe a managed volume
> DESCRIBE VOLUME managed_volume
name catalog database owner storageLocation volumeType comment
-------------- --------------- -------------- ----- ------------------------------------ ---------- -----------------------
managed_volume default_catalog default_schema Alice s3://<metastore-root>/volumes/<uuid> MANAGED My first managed volume