更新时间：2026-07-03 GMT+08:00
查看表统计信息
功能描述
查看表的统计信息。默认返回所有列的列名和列数据类型，使用 EXTENDED 或 FORMATTED 可查看详细的表元数据信息。
DESCRIBE 与 DESC 简写等效。
语法格式
{ DESCRIBE | DESC } [ EXTENDED | FORMATTED ] [ db_name. ] table_name
参数说明
| 参数 | 是否必选 | 描述 |
|---|---|---|
| DESCRIBE / DESC | 是 | 查看表统计信息的关键字，两者等效。DESC 是 DESCRIBE 的简写形式。 |
| EXTENDED | 否 | 显示表的所有元数据信息，包括表的详细统计信息和配置信息，通常在调试时使用。 |
| FORMATTED | 否 | 以格式化的表格形式显示所有元数据信息，与 EXTENDED 类似但输出更易读。 |
| db_name | 否 | 数据库名称。若未指定，则默认使用当前数据库。命名规则：由字母、数字和下划线（_）组成，不能是纯数字，且不能以下划线开头。 |
| table_name | 是 | 表名称。命名规则：由字母、数字和下划线（_）组成，不能是纯数字，且不能以下划线开头。匹配规则为：^(?!_)(?![0-9]+$)[A-Za-z0-9_$]*$。如果包含特殊字符需要使用反引号（``）包围起来。 |
注意事项
- 若所查看的表不存在，将会出错。
- 默认情况下仅返回列名和数据类型；使用 EXTENDED 或 FORMATTED 可查看包含分区信息、存储格式、表属性等在内的完整元数据。
示例1：基本 DESCRIBE 查看表信息
查看 student 表所有列的列名与列数据类型。
DESCRIBE student;
返回结果示例：
+---------+----------+-------+ |col_name |data_type |comment| +---------+----------+-------+ |id |int |NULL | |name |string |NULL | |age |int |NULL | |score |double |NULL | +---------+----------+-------+
示例2：使用 DESC 简写
使用 DESC 简写形式查看 student 表的列信息，与 DESCRIBE 等效。
DESC student;
示例3：使用 EXTENDED 查看详细信息
查看 student 表的详细元数据信息，包括分区、存储格式、表属性等。
DESCRIBE EXTENDED student;
返回结果将包含：
- 基本列信息（列名、数据类型、注释）
- 表的详细元数据（数据库、所有者、创建时间、存储格式、表属性等）
示例4：查看指定数据库的表
查看 school_db 数据库下 student 表的列信息。
DESCRIBE school_db.student;
父主题： 查看表
