ПОКАЗАТЬ ТОМА
Область применения: Databricks SQL Databricks Runtime 13.3 LTS и более поздней версии каталога Unity
Выводит список всех томов, доступных текущему пользователю в текущей или необязательно указанной схеме. Кроме того, выходные данные этой инструкции можно отфильтровать по дополнительному шаблону сопоставления.
Синтаксис
SHOW VOLUMES [ { FROM | IN } schema_name ] [ [ LIKE ] regex_pattern } ]
Параметры
-
Указывает схему, в которой должны быть перечислены тома.
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