information_schema.PARTITIONS

更新时间：2026-07-15 20:42:46

说明

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

功能描述

视图 information_schema.PARTITIONS 用于展示 Partition 信息。

字段说明

字段名称	类型	是否可以为 NULL	描述
TABLE_CATALOG	text	NO	固定值（def）。
TABLE_SCHEMA	varchar(128)	NO	数据库名。
TABLE_NAME	varchar(256)	NO	表名。
PARTITION_NAME	varchar(64)	NO	分区名。
SUBPARTITION_NAME	varchar(64)	NO	子分区名。
PARTITION_ORDINAL_POSITION	bigint(20) unsigned	NO	当前分区在所有分区中的位置。
SUBPARTITION_ORDINAL_POSITION	bigint(20) unsigned	NO	当前子分区在所有子分区中的位置。
PARTITION_METHOD	varchar(13)	NO	分区类型。
SUBPARTITION_METHOD	varchar(13)	NO	子分区类型。
PARTITION_EXPRESSION	text	NO	分区函数表达式。
SUBPARTITION_EXPRESSION	text	NO	子分区函数表达式。
PARTITION_DESCRIPTION	text	NO	适用于 range 和 list 分区的描述。
SUBPARTITION_DESCRIPTION	text	NO	适用于 range 和 list 子分区的描述。
TABLE_ROWS	bigint(20) unsigned	NO	分区的行数。
AVG_ROW_LENGTH	bigint(21) unsigned	NO	存储在分区或子分区中行的平均长度。
DATA_LENGTH	bigint(0) unsigned	NO	存储在分区或子分区中的总字节数，即表分区或子分区占据的存储空间，按宏块大小计算，单位为 Byte。说明对于 V4.3.x 版本，该字段从 V4.3.5 版本开始不再展示为 `NULL`。
MAX_DATA_LENGTH	bigint(0) unsigned	NO	目前暂不支持该字段，当前该字段默认为 0。
INDEX_LENGTH	bigint(0) unsigned	NO	索引总长度，即表分区或子分区的索引占据的存储空间，按宏块大小计算，单位为 Byte。说明对于 V4.3.x 版本，该字段从 V4.3.5 版本开始不再展示为 `NULL`。
DATA_FREE	bigint(0) unsigned	NO	目前暂不支持该字段，当前该字段默认为 0。
CREATE_TIME	timestamp(6)	NO	分区的创建时间。
UPDATE_TIME	datetime	NO	目前暂不支持该字段，当前该字段默认为 NULL。
CHECK_TIME	datetime	YES	目前暂不支持该字段，当前该字段默认为 NULL。
CHECKSUM	bigint(0)	NO	目前暂不支持该字段，当前该字段默认为 NULL。
PARTITION_COMMENT	text	NO	分区注释。
NODEGROUP	varchar(256)	NO	分区所属的 nodegroup。
TABLESPACE_NAME	varchar(268)	NO	分区所属的 tablespace 名称。

查询示例

查询表 t1 中的 Partition 信息。

obclient> select * from information_schema.partitions where table_name = 't1' limit 1\G

查询结果如下：

   *************************** 1. row ***************************
                   TABLE_CATALOG: def
                    TABLE_SCHEMA: test
                      TABLE_NAME: t1
                  PARTITION_NAME: p0
               SUBPARTITION_NAME: NULL
      PARTITION_ORDINAL_POSITION: 1
   SUBPARTITION_ORDINAL_POSITION: NULL
                PARTITION_METHOD: HASH
             SUBPARTITION_METHOD: NULL
            PARTITION_EXPRESSION: a
         SUBPARTITION_EXPRESSION: NULL
           PARTITION_DESCRIPTION: NULL
        SUBPARTITION_DESCRIPTION: NULL
                      TABLE_ROWS: 3000
                  AVG_ROW_LENGTH: 37
                     DATA_LENGTH: 0
                 MAX_DATA_LENGTH: NULL
                    INDEX_LENGTH: 0
                       DATA_FREE: NULL
                     CREATE_TIME: 2024-12-17 10:56:36.834215
                     UPDATE_TIME: NULL
                      CHECK_TIME: NULL
                        CHECKSUM: NULL
               PARTITION_COMMENT:
                       NODEGROUP: default
                 TABLESPACE_NAME: NULL
   1 row in set (0.020 sec)