OPISYWANIE WOLUMINU

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowszy zaznacz pole wyboru oznaczone jako tak tylko wykaz aparatu Unity

Zwraca metadane istniejącego woluminu. Informacje o metadanych obejmują nazwę woluminu, schemat, wykaz, typ, komentarz i właściciela. Jeśli jest określona opcja opcjonalna EXTENDED , zwraca podstawowe informacje o metadanych wraz z innymi właściwościami wykazu.

Składnia

DESCRIBE VOLUME volume_name

Parametry

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

Zwraca

Zestaw wyników z jednym wierszem 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, w której 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