Udostępnij przez

DESCRIBE VOLUME

Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 13.3 LTS i nowsze zaznaczone jako tak tylko Unity Catalog

Zwraca metadane istniejącego woluminu. Informacje o metadanych obejmują nazwę woluminu, schemat, wykaz, typ, komentarz i właściciela.

Składnia

DESCRIBE VOLUME volume_name

Parametry

  • volume_name: nazwa istniejącego woluminu w katalogu Unity. Jeśli nazwa nie istnieje, zgłoszony zostanie wyjątek.

Zwraca

Zestaw wyników zawierający jeden wiersz z następującymi kolumnami:

  • name STRING NOT NULL: nazwa woluminu; identyfikuje obiekt woluminu.
  • catalog STRING NOT NULL: nazwa wykazu zawierającego wolumin.
  • database STRING NOT NULL: nazwa schematu zawierającego wolumin.
  • owner STRING NOT NULL: podmiot, który jest właścicielem woluminu.
  • storageLocation STRING: ścieżka lokalizacji zewnętrznej, gdzie znajduje się wolumin zewnętrzny. NULL dla woluminów zarządzanych.
  • volumeType STRING NOT NULL: typ woluminu, możliwe wartości: EXTERNAL, MANAGED.
  • comment STRING: komentarz dołączony do woluminu.

Przykłady

- 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