跳到主要内容

SHOW TABLE STATUS

Introduced or updated: 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| | | | | | |
开始使用 Databend Cloud
低成本
快速分析
多种数据源
弹性扩展
注册