大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:SHOW TABLE STATUS

· 52CE 我爱测

## 描述 该语句用于展示一个表或者视图的一些信息。 ## 语法 ## 可选参数 **1. ** > FROM 子句中可以指定查询的 catalog 名称以及 database 的名称。 **2. ** > LIKE 子句中可以按照表名进行模糊查询。 ## 返回值 | 列名(Column) | 类型(DataType) | 说明(Notes) | |:---------------------|:--------------|:----

描述

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

语法

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           |         |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。