SHOW TABLES

SHOW TABLES отображает все таблицы в базе данных Selena или в базе данных внешнего источника данных, например, Hive, Iceberg, Hudi или Delta Lake.

ПРИМЕЧАНИЕ

Для просмотра таблиц во внешнем источнике данных необходимо иметь привилегию USAGE на внешний catalog, соответствующий этому источнику данных.

Синтаксис

SHOW TABLES [FROM <catalog_name>.<db_name>]

Параметры

Параметр	Обязательный	Описание
catalog_name	Нет	Имя внутреннего catalog или внешнего catalog. Если вы не указываете этот параметр или устанавливаете значение default_catalog, возвращаются таблицы в базах данных Selena. Если вы устанавливаете этот параметр в имя внешнего catalog, возвращаются таблицы в базах данных внешнего источника данных. Вы можете выполнить SHOW CATALOGS для просмотра внутренних и внешних catalogs.
db_name	Нет	Имя базы данных. Если не указано, по умолчанию используется текущая база данных.

Примеры

Пример 1: Просмотр таблиц в базе данных example_db из default_catalog после подключения к cluster Selena. Следующие два выражения эквивалентны.

show tables from example_db;
+----------------------------+
| Tables_in_example_db       |
+----------------------------+
| depts                      |
| depts_par                  |
| emps                       |
| emps2                      |
+----------------------------+

show tables from default_catalog.example_db;
+----------------------------+
| Tables_in_example_db       |
+----------------------------+
| depts                      |
| depts_par                  |
| emps                       |
| emps2                      |
+----------------------------+

Пример 2: Просмотр таблиц в текущей базе данных example_db после подключения к этой базе данных.

show tables;
+----------------------------+
| Tables_in_example_db       |
+----------------------------+
| depts                      |
| depts_par                  |
| emps                       |
| emps2                      |
+----------------------------+

Пример 3: Просмотр таблиц в базе данных hudi_db внешнего catalog hudi_catalog.

show tables from hudi_catalog.hudi_db;
+----------------------------+
| Tables_in_hudi_db          |
+----------------------------+
| hudi_sync_mor              |
| hudi_table1                |
+----------------------------+

В качестве альтернативы вы можете выполнить SET CATALOG для переключения на внешний catalog hudi_catalog, а затем выполнить SHOW TABLES FROM hudi_db;.

Ссылки

• SHOW CATALOGS: Просматривает все catalogs в cluster Selena.
• SHOW DATABASES: Просматривает все базы данных во внутреннем catalog или внешнем catalog.
• SET CATALOG: Переключается между catalogs.