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

SHOW VOLUMES

  • Статья

применимо:установлен флажок Databricks SQL установлен флажок Databricks Runtime 13.3 LTS и выше установлен флажок только Unity Catalog

Выводит список всех томов, доступных текущему пользователю в текущей или указанной при необходимости схеме. Кроме того, выходные данные этой инструкции можно отфильтровать по дополнительному шаблону сопоставления.

Синтаксис

SHOW VOLUMES [ { FROM | IN } schema_name ] [ [ LIKE ] regex_pattern } ]

Параметры

  • schema_name

    Указывает схему, в которой должны быть перечислены тома.

  • regex_pattern

    Литерал STRING с шаблоном регулярного выражения, который используется для фильтрации результатов инструкции.

    • За исключением символов * и |, шаблон работает как регулярное выражение.
    • Символ * соответствует 0 или более символам, а | используется для разделения нескольких регулярных выражений, каждое из которых может быть соответствующим.
    • Начальные и конечные пробелы обрезаются во входном шаблоне перед обработкой. При сопоставлении шаблона регистр не учитывается.

Возвраты

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

  • database STRING NOT NULL: схема тома
  • volumeName STRING NOT NULL: имя тома

Примеры

– List all volumes accessible by the caller
> SHOW VOLUMES
  database         volumeName
  ---------------- ----------
  default          my_external_volume
  default          another_volume
  default          foo_volume

– List all volumes under schema `machine_learning`
> SHOW VOLUMES IN machine_learning
  database         volumeName
  ---------------- ----------
  machine_learning bar_volume

– List all volumes whose name starts with 'a'
> SHOW VOLUMES LIKE 'a*'
  database         volumeName
  ---------------- ----------
  default          another_volume