SHOW TABLES

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

ПРИМЕЧАНИЕ

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

Синтаксис

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

Параметры

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

Примеры

Пример 1: Просмотр таблиц в базе данных example_db из default_catalog после подключения к кластеру 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 из external catalog hudi_catalog.

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

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

Ссылки

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