Freigeben über

DESCRIBE VOLUME

  • Artikel

Gilt für: Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 13.3 LTS und höher durch Häkchen mit „Ja“ markiert Nur Unity Catalog

Gibt die Metadaten eines vorhandenen Volumes zurück. Die Metadateninformationen umfassen Volumename, Schema, Katalog, Typ, Kommentar und Besitzer. Wenn wahlweise die Option EXTENDED angegeben wird, werden zusammen mit den anderen Katalogeigenschaften die Metadatenbasisinformationen zurückgegeben.

Syntax

DESCRIBE VOLUME volume_name

Parameter

  • volume_name: Der Name eines vorhandenen Volumes im Unity-Katalog. Wenn der Name nicht vorhanden ist, wird eine Ausnahme ausgelöst.

Gibt zurück

Ein Resultset mit einer einzigen Zeile und folgenden Spalten:

  • name STRING NOT NULL: Der Name des Volumes; er identifiziert das Volumeobjekt.
  • catalog STRING NOT NULL: Der Name des Katalogs, der das Volume enthält
  • database STRING NOT NULL: Der Name des Schemas, das das Volume enthält
  • owner STRING NOT NULL: Der Prinzipal, der das Volume besitzt
  • storageLocation STRING: Der Pfad des externen Speicherorts, an dem sich das externe Volume befindet NULL für verwaltete Volumes
  • volumeType STRING NOT NULL: Der Typ des Volumes; mögliche Werte: EXTERNAL, MANAGED
  • comment STRING: Ein an das Volume angefügter Kommentar

Beispiele

- 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