説明
このビューはV1.4バージョンから導入されました。
機能の概要
ビュー information_schema.PARTITIONS は、パーティション情報を表示するために使用されます。
フィールドの説明
| フィールド名 | タイプ | 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以降のバージョンから |
| MAX_DATA_LENGTH | bigint(0) unsigned | NO | 現在このフィールドはサポートされておらず、現在デフォルト値は0です。 |
| INDEX_LENGTH | bigint(0) unsigned | NO | インデックスの総長、すなわちテーブルのパーティションまたはサブパーティションのインデックスが占有するストレージ容量。マクロブロックサイズで計算し、単位はByteです。
説明V4.3.x系では、このフィールドはV4.3.5以降のバージョンから |
| 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 内のパーティション情報を照会します。
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)