SHOW TABLE STATUS

描述

该语句用于展示一个表或者视图的一些信息。

语法

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

可选参数

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

FROM 子句中可以指定查询的 catalog 名称以及 database 的名称。

2. LIKE <like_condition>

LIKE 子句中可以按照表名进行模糊查询。

返回值

列名（Column）	类型（DataType）	说明（Notes）
Name	字符串	表名称
Engine	字符串	表的存储引擎
Version	字符串	版本
Row_format	字符串	行格式。对于MyISAM引擎，这可能是Dynamic，Fixed或Compressed。动态行的行长度可变，例如Varchar或Blob类型字段。固定行是指行长度不变，例如Char和Integer类型字段。
Rows	字符串	表中的行数。对于非事务性表，这个值是精确的，对于事务性引擎，这个值通常是估算的。
Avg_row_length	整型	平均每行包括的字节数
Data_length	整型	整个表的数据量(单位：字节)
Max_data_length	整型	表可以容纳的最大数据量
Index_length	整型	索引占用磁盘的空间大小
Data_free	整型	对于MyISAM引擎，标识已分配，但现在未使用的空间，并且包含了已被删除行的空间。
Auto_increment	整型	下一个Auto_increment的值
Create_time	Datetime	表的创建时间
Update_time	Datetime	表的最近更新时间
Check_time	Datetime	使用 check table 或myisamchk工具检查表的最近时间
Collation	字符串	表的默认字符集，目前只支持 utf-8
Checksum	字符串	如果启用，则对整个表的内容计算时的校验和
Create_options	字符串	指表创建时的其他所有选项
Comment	字符串	表注释

权限控制

执行此 SQL 命令的用户必须至少具有以下权限：

权限（Privilege）	对象（Object）	说明（Notes）
ADMIN_PRIV	表（Table）, 视图（View）	目前仅支持 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           |         |
  +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+