Поделиться через

DESCRIBE VOLUME

  • Статья

Область применения:флажок Databricks SQL флажок Databricks Runtime 13.3 LTS и более поздней флажок версии каталога Unity

Возвращает метаданные существующего тома. Сведения о метаданных включают имя тома, схему, каталог, тип, комментарий и владельца. Если указан необязательный параметр EXTENDED, возвращаются основные сведения метаданных вместе с другими свойствами каталога.

Синтаксис

DESCRIBE VOLUME volume_name

Параметры

  • volume_name: имя существующего тома в каталоге Unity. Если указанное имя не существует, создается исключение.

Возвраты

Результирующий набор одной строки со следующими столбцами:

  • name STRING NOT NULL: имя тома; он определяет объект тома.
  • catalog STRING NOT NULL: имя каталога, содержащего том.
  • database STRING NOT NULL: имя схемы, содержащей том.
  • owner STRING NOT NULL: субъект, принадлежащий тому.
  • storageLocation STRING: путь к внешнему расположению, в котором находится внешний том. NULL для управляемых томов.
  • volumeType STRING NOT NULL: тип тома, возможные значения: EXTERNAL, MANAGED.
  • comment STRING: комментарий, присоединенный к тому.

Примеры

- 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