SHOW TABLES

  • Статья

Область применения: флажок Databricks SQL флажок Databricks Runtime

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

Синтаксис

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

Параметры

  • schema_name

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

  • regex_pattern

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

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

Примеры

-- List all tables in default schema
> SHOW TABLES;
 database tableName isTemporary
 -------- --------- -----------
  default       sam       false
  default      sam1       false
  default       suj       false

-- List all tables from usersc schema
> SHOW TABLES FROM usersc;
 database tableName isTemporary
 -------- --------- -----------
   usersc     user1       false
   usersc     user2       false

-- List all tables in usersc schema
> SHOW TABLES IN usersc;
 database tableName isTemporary
 -------- --------- -----------
   usersc     user1       false
   usersc     user2       false

-- List all tables from default schema matching the pattern `sam*`
> SHOW TABLES FROM default LIKE 'sam*';
 database tableName isTemporary
 -------- --------- -----------
  default       sam       false
  default      sam1       false

-- List all tables matching the pattern `sam*|suj`
> SHOW TABLES LIKE 'sam*|suj';
 database tableName isTemporary
 -------- --------- -----------
  default       sam       false
  default      sam1       false
  default       suj       false