DESCRIBE VOLUME

  • 项目

适用于：勾选“是”Databricks SQL勾选“是”Databricks Runtime 13.2 及更高版本勾选“是”仅 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