Dela via

DESCRIBE VOLUME

  • Artikel

gäller för:markerad med ja Databricks SQL markerad med ja Databricks Runtime 13.3 LTS och senare markerad med ja Unity Catalog

Returnerar metadata för en befintlig volym. Metadatainformationen innehåller volymnamn, schema, katalog, typ, kommentar och ägare. Om det valfria EXTENDED alternativet anges returnerar det grundläggande metadatainformationen tillsammans med de andra katalogegenskaperna.

Syntax

DESCRIBE VOLUME volume_name

Parametrar

  • volume_name: Namnet på en befintlig volym i Unity-katalogen. Om namnet inte finns genereras ett undantag.

Returer

Ett resultat med en rad med följande kolumner:

  • name STRING NOT NULL: Namnet på volymen; den identifierar volymobjektet.
  • catalog STRING NOT NULL: Namnet på katalogen som innehåller volymen.
  • database STRING NOT NULL: Namnet på schemat som innehåller volymen.
  • owner STRING NOT NULL: Huvudnamnet som äger volymen.
  • storageLocation STRING: Sökvägen till den externa plats där den externa volymen finns. NULL för hanterade volymer.
  • volumeType STRING NOT NULL: Volymens typ, möjliga värden: EXTERNAL, MANAGED.
  • comment STRING: En kommentar som är kopplad till volymen.

Exempel

- 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