DESCRIBE VOLUME
适用于: Databricks SQL Databricks Runtime 13.3 LTS 及更高版本 仅 Unity Catalog
返回现有卷的元数据。 元数据信息包括卷名称、架构、目录、类型、注释和所有者。
如果指定了可选的 EXTENDED
选项,则它将返回基本元数据信息以及其他目录属性。
语法
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