共用方式為

DESCRIBE VOLUME

  • 發行項

適用於：核取記號為「是」Databricks SQL 核取記號為「是」 Databricks Runtime 13.3 LTS 和更新版本 核取記號為「是」 僅限 Unity Catalog

傳回現有磁碟區的元數據。 元數據資訊包括磁碟區名稱、架構、目錄、類型、批注和擁有者。 如果指定了選擇性 EXTENDED 選項，它會傳回基本元數據資訊以及其他目錄屬性。

語法

DESCRIBE VOLUME volume_name

參數

  • volume_name：Unity 目錄中現有磁碟區的名稱。 如果名稱不存在，則會擲回例外狀況。

傳回

具有下列資料列的單一資料列結果集：

  • 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