Freigeben über

DESCRIBE VOLUME

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

Gibt die Metadaten eines vorhandenen Volumes zurück. Die Metadateninformationen umfassen Volumename, Schema, Katalog, Typ, Kommentar und Besitzer.

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.

Rückgabe

Ein Resultset mit einer einzigen Zeile und folgenden Spalten:

  • name STRING NOT NULL: Der Name des Volumes; er identifiziert das Volume-Objekt.
  • 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 das externe Volume liegt. NULL für verwaltete Volumes.
  • volumeType STRING NOT NULL: Der Typ des Volumes, mögliche Werte: EXTERNAL, MANAGED.
  • comment STRING: Ein Kommentar zu diesem Volume.

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
  • Last updated on