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