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:卷的类型,可能的值:EXTERNALMANAGED
  • 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