SHOW TABLE STATUS

引入或更新于：v1.2.131

显示数据库中表的状态。状态信息包括表的各种物理大小和时间戳，详见示例。

语法

SHOW TABLE STATUS
    [ {FROM | IN} <database_name> ]
    [ LIKE 'pattern' | WHERE expr ]

参数	描述
FROM / IN	指定数据库。如果省略，命令将从当前数据库返回结果。
LIKE	使用区分大小写的模式匹配过滤结果中的表名。
WHERE	使用 WHERE 子句中的表达式过滤结果。

示例

以下示例显示当前数据库中表的状态，提供名称、引擎、行数和其他相关信息等详细信息：

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|comment|cluster_by|
-------+------+-------+----------+----+--------------+-----------+---------------+------------+---------+--------------+-----------------------------+-----------+----------+---------+--------+-------+----------+
books  |FUSE  |      0|          |   2|              |        160|               |         713|         |              |2023-09-25 06:40:47.237 +0000|           |          |         |        |       |          |
mytable|FUSE  |      0|          |   5|              |         40|               |        1665|         |              |2023-08-28 07:53:05.455 +0000|           |          |         |        |       |((a + 1)) |
ontime |FUSE  |      0|          | 199|              |     147981|               |       22961|         |              |2023-09-19 07:04:06.414 +0000|           |          |         |        |       |          |

以下示例显示当前数据库中名称以 'my' 开头的表的状态：

SHOW TABLE STATUS LIKE 'my%';

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|comment|cluster_by|
-------+------+-------+----------+----+--------------+-----------+---------------+------------+---------+--------------+-----------------------------+-----------+----------+---------+--------+-------+----------+
mytable|FUSE  |      0|          |   5|              |         40|               |        1665|         |              |2023-08-28 07:53:05.455 +0000|           |          |         |        |       |((a + 1)) |

以下示例显示当前数据库中行数大于 100 的表的状态：

备注

使用 SHOW TABLE STATUS 查询时，请注意，某些列名（如 "rows"）可能会被解释为 SQL 关键字，可能导致错误。为避免此问题，始终将列名用反引号括起来，如本示例所示。这确保了在 SQL 查询中列名被视为标识符而不是关键字。

SHOW TABLE STATUS WHERE `rows` > 100;

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|comment|cluster_by|
------+------+-------+----------+----+--------------+-----------+---------------+------------+---------+--------------+-----------------------------+-----------+----------+---------+--------+-------+----------+
ontime|FUSE  |      0|          | 199|              |     147981|               |       22961|         |              |2023-09-19 07:04:06.414 +0000|           |          |         |        |       |          |