Перейти к содержимому
Последнее обновление

SHOW TABLE STATUS

Описание​

Этот оператор используется для отображения сведений о таблице или представлении.

Синтаксис​

SHOW TABLE STATUS [ FROM [ <catalog_name>.]<db_name> ] [ LIKE <like_condition> ]

Необязательные параметры​

1. FROM [ <catalog_name>.]<db_name>

В предложении FROM можно указать имя Catalog и имя базы данных, к которым выполняется запрос.

2. LIKE <like_condition>

Предложение LIKE позволяет выполнять запросы с поиском по шаблону имени таблицы.

Возвращаемое значение​

СтолбецТип данныхОписание
NameStringИмя таблицы
EngineStringДвижок хранения таблицы
VersionStringВерсия
Row_formatStringФормат строки. Для движка MyISAM возможны значения Dynamic, Fixed или Compressed. Строки Dynamic имеют переменную длину, например при наличии полей типов Varchar или Blob. Строки Fixed имеют фиксированную длину, например при наличии полей типов Char и Integer.
RowsStringКоличество строк в таблице. Для нетранзакционных таблиц это значение точное, а для транзакционных движков оно обычно является оценочным.
Avg_row_lengthIntegerСреднее количество байтов на строку
Data_lengthIntegerОбъём данных во всей таблице (в байтах)
Max_data_lengthIntegerМаксимальный объём данных, который может вместить таблица
Index_lengthIntegerОбъём дискового пространства, занимаемого индексом
Data_freeIntegerДля движка MyISAM указывает объём выделенного, но неиспользуемого пространства, включая пространство удалённых строк.
Auto_incrementIntegerСледующее значение Auto_increment
Create_timeDatetimeВремя создания таблицы
Update_timeDatetimeВремя последнего обновления таблицы
Check_timeDatetimeВремя последней проверки таблицы с помощью check table или утилиты myisamchk
CollationStringКодировка таблицы по умолчанию; в настоящее время поддерживается только utf-8
ChecksumStringКонтрольная сумма, вычисленная для всего содержимого таблицы, если её вычисление включено
Create_optionsStringВсе остальные параметры, заданные при создании таблицы
CommentStringКомментарий к таблице

Требования к правам доступа​

Пользователь, выполняющий эту команду SQL, должен иметь как минимум следующие права доступа:

Право доступаОбъектОписание
ADMIN_PRIVТаблица, представлениеВ настоящее время для выполнения этой операции поддерживаются только права ADMIN

Примечания по использованию​

  • Этот оператор в основном используется для совместимости с синтаксисом MySQL. В настоящее время отображается лишь небольшая часть сведений, например Comment.

Примеры​

  • Просмотр сведений обо всех таблицах в текущей базе данных

    SHOW TABLE STATUS
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    | Name       | Engine | Version | Row_format | Rows | Avg_row_length | Data_length | Max_data_length | Index_length | Data_free | Auto_increment | Create_time         | Update_time         | Check_time | Collation | Checksum | Create_options | Comment |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    | test_table | Doris  |    NULL | NULL       |    0 |              0 |           0 |            NULL |         NULL |      NULL |           NULL | 2025-01-22 11:45:36 | 2025-01-22 11:45:36 | NULL       | utf-8     |     NULL | NULL           |         |
    | test_view  | View   |    NULL | NULL       |    0 |              0 |           0 |            NULL |         NULL |      NULL |           NULL | 2025-01-22 11:46:32 | NULL                | NULL       | utf-8     |     NULL | NULL           |         |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+

  • Просмотр сведений о таблицах в указанной базе данных, имена которых содержат example

    SHOW TABLE STATUS FROM db LIKE "%test%"
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    | Name       | Engine | Version | Row_format | Rows | Avg_row_length | Data_length | Max_data_length | Index_length | Data_free | Auto_increment | Create_time         | Update_time         | Check_time | Collation | Checksum | Create_options | Comment |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    | test_table | Doris  |    NULL | NULL       |    0 |              0 |           0 |            NULL |         NULL |      NULL |           NULL | 2025-01-22 11:45:36 | 2025-01-22 11:45:36 | NULL       | utf-8     |     NULL | NULL           |         |
    | test_view  | View   |    NULL | NULL       |    0 |              0 |           0 |            NULL |         NULL |      NULL |           NULL | 2025-01-22 11:46:32 | NULL                | NULL       | utf-8     |     NULL | NULL           |         |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
Report issue