DESCRIBE VOLUME

Berlaku untuk:centang ditandai yaDatabricks SQL centang ditandai ya Databricks Runtime 13.3 LTS dan di atas centang ditandai ya Unity Catalog saja

Mengembalikan metadata dari volume yang ada. Informasi metadata mencakup nama volume, skema, katalog, jenis, komentar, dan pemilik.

Sintaks

DESCRIBE VOLUME volume_name

Parameter

  • volume_name: Nama volume yang ada di Katalog Unity. Jika nama tidak ada, pengecualian akan ditampilkan.

Mengembalikan

Satu set hasil baris dengan kolom berikut:

  • name STRING NOT NULL: Nama volume; ini mengidentifikasi objek volume.
  • catalog STRING NOT NULL: Nama katalog yang berisi volume.
  • database STRING NOT NULL: Nama skema yang berisi volume.
  • owner STRING NOT NULL: Pemilik yang menguasai volume.
  • storageLocation STRING: Jalur lokasi eksternal tempat volume eksternal berada. NULL untuk volume terkelola.
  • volumeType STRING NOT NULL: Jenis volume, kemungkinan nilai: EXTERNAL, MANAGED.
  • comment STRING: Komentar yang dilampirkan pada volume.

Contoh

- 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