information_schema.TABLES

更新时间：2026-05-29 19:13:33

说明

该视图从 V1.4 版本开始引入。

功能描述

视图 information_schema.TABLES 展示表的信息。

字段说明

字段名称	类型	是否可以为 NULL	描述
TABLE_CATALOG	varchar(512)	NO	表目录。
TABLE_SCHEMA	varchar(64)	NO	数据库名称。
TABLE_NAME	varchar(64)	NO	表名。
TABLE_TYPE	varchar(64)	NO	表类型。
ENGINE	varchar(64)	NO	使用的存储引擎类型。
VERSION	bigint(0) unsigned	NO	版本。
ROW_FORMAT	varchar(10)	NO	行格式。
TABLE_ROWS	bigint(21) unsigned	NO	表的行数。
AVG_ROW_LENGTH	bigint(21) unsigned	NO	平均行长度。
DATA_LENGTH	bigint(21) unsigned	NO	数据长度，即表占据的存储空间，按宏块大小计算，单位为 Byte。说明 p>对于 V4.3.x 版本，该字段从 V4.3.5 版本开始生效。
MAX_DATA_LENGTH	bigint(0) unsigned	NO	最大数据长度。
INDEX_LENGTH	bigint(0) unsigned	NO	索引长度，即非主键索引占据的存储空间，按宏块大小计算，单位为 Byte。说明 p>对于 V4.3.x 版本，该字段从 V4.3.5 版本开始生效。
DATA_FREE	bigint(0) unsigned	NO	剩余空间大小。
AUTO_INCREMENT	bigint(0) unsigned	NO	当前的自增值。
CREATE_TIME	datetime	NO	表的创建时间。
UPDATE_TIME	datetime	NO	表的最近更新时间。
CHECK_TIME	datetime	NO	表的最近检查时间。
TABLE_COLLATION	varchar(32)	NO	表的字符集比对方法。
CHECKSUM	bigint(0) unsigned	NO	校验和。
CREATE_OPTIONS	varchar(255)	NO	创建选项。
TABLE_COMMENT	text	NO	表的备注。
AUTO_SPLIT	varchar(16)	NO	表示表是否开启了自动分区。取值如下： `FALSE`（默认值）：表示表关闭了自动分区。 `TRUE`：表示表开启了自动分区。说明该字段从 V4.3.4 版本开始引入。
AUTO_SPLIT_TABLET_SIZE	bigint(20) unsigned	NO	表示自动分区分裂阈值。当字段 `AUTO_SPLIT` 取值为 `FALSE` 时，`AUTO_SPLIT_TABLET_SIZE` 取值为 0。说明该字段从 V4.3.4 版本开始引入。
ORGANIZATION	varchar(12)	NO	表示表组织模式。取值如下： `HEAP`：表示为堆组织表模式。 `INDEX`：表示为索引组织表模式。说明对于 OceanBase 数据库 V4.3.5 版本，该字段从 V4.3.5 BP1 版本开始支持引入。

查询示例

查询表 t1 的详细信息。

SELECT * FROM information_schema.tables WHERE table_name = 't1'\G

查询结果如下：

*************************** 1. row ***************************
         TABLE_CATALOG: def
          TABLE_SCHEMA: db_test
            TABLE_NAME: t1
            TABLE_TYPE: BASE TABLE
                ENGINE: InnoDB
               VERSION: NULL
            ROW_FORMAT: DYNAMIC
            TABLE_ROWS: 0
        AVG_ROW_LENGTH: 0
           DATA_LENGTH: 0
       MAX_DATA_LENGTH: NULL
          INDEX_LENGTH: 0
             DATA_FREE: NULL
        AUTO_INCREMENT: NULL
           CREATE_TIME: 2025-02-24 10:32:10
           UPDATE_TIME: 2025-02-24 10:32:10
            CHECK_TIME: NULL
       TABLE_COLLATION: utf8mb4_general_ci
              CHECKSUM: NULL
        CREATE_OPTIONS: NULL
         TABLE_COMMENT:
            AUTO_SPLIT: FALSE
AUTO_SPLIT_TABLET_SIZE: 0
          ORGANIZATION: HEAP
1 row in set