SHOW TABLES
Описание
Эта инструкция используется для отображения всех таблиц и представлений в текущей базе данных.
Синтаксис
SHOW [ FULL ] TABLES [ FROM [ <catalog_name>.]<db_name> ][ LIKE <like_condition> ]
Необязательные параметры
1. FULL
Если добавить этот параметр в инструкцию, результат будет содержать три дополнительных столбца: Table_type (тип таблицы), Storage_format (формат хранения) и Inverted_index_storage_format (формат хранения инвертированного индекса).
2. FROM [ <catalog_name>.]<db_name>
В предложении FROM можно указать имя Catalog и имя базы данных, к которой выполняется запрос.
2. LIKE <like_condition>
В предложении LIKE можно выполнять запросы по шаблону имени таблицы.
Возвращаемое значение
| Имя столбца (Column) | Тип (DataType) | Примечания (Notes) |
|---|---|---|
| Tables_in_<db_name> | String | Все таблицы и представления в базе данных, указанной в <db_name>. |
| Table_type | String | Тип таблицы или представления. |
| Storage_format | String | Формат хранения таблицы или представления. |
| Inverted_index_storage_format | String | Формат хранения инвертированного индекса таблицы или представления. |
Требования к правам доступа
Пользователь, выполняющий эту команду SQL, должен иметь как минимум следующие права:
| Привилегия (Privilege) | Объект (Object) | Примечания (Notes) |
|---|---|---|
| SELECT_PRIV | Таблица (Table), представление (View) | Отображаются только те таблицы и представления, для которых есть права на выполнение запросов. |
Примечания по использованию
- Если в инструкции не указано предложение FROM, перед её выполнением необходимо выбрать соответствующую базу данных.
Примеры
-
Просмотр всех таблиц в базе данных
SHOW TABLES;+---------------------------------+
| Tables_in_demo |
+---------------------------------+
| ads_client_biz_aggr_di_20220419 |
| cmy1 |
| cmy2 |
| intern_theme |
| left_table |
+---------------------------------+ -
Запрос по шаблону имени таблицы
SHOW TABLES LIKE '%cm%'+----------------+
| Tables_in_demo |
+----------------+
| cmy1 |
| cmy2 |
+----------------+ -
Использование FULL для запроса таблиц и представлений в базе данных
SHOW FULL TABLES+----------------+------------+----------------+-------------------------------+
| Tables_in_demo | Table_type | Storage_format | Inverted_index_storage_format |
+----------------+------------+----------------+-------------------------------+
| test_table | BASE TABLE | V2 | V1 |
| test_view | VIEW | NONE | NONE |
+----------------+------------+----------------+-------------------------------+