メインコンテンツまでスキップ
に最終更新

partitions

概要​

データベース内のすべてのテーブルのパーティション状態を表示します。

データベース​

information_schema

テーブル情報​

カラム名型説明
PARTITION_IDbigintパーティション ID
TABLE_CATALOGvarchar(64)カタログ名
TABLE_SCHEMAvarchar(64)データベース名
TABLE_NAMEvarchar(64)テーブル名
PARTITION_NAMEvarchar(64)パーティション名
SUBPARTITION_NAMEvarchar(64)常に空です
PARTITION_ORDINAL_POSITIONintパーティションの順序位置
SUBPARTITION_ORDINAL_POSITIONint常に空です
PARTITION_METHODvarchar(13)パーティション方式
SUBPARTITION_METHODvarchar(13)常に空です
PARTITION_EXPRESSIONvarchar(2048)パーティション式
SUBPARTITION_EXPRESSIONvarchar(2048)常に空です
PARTITION_DESCRIPTIONtextパーティションの説明
TABLE_ROWSbigint
AVG_ROW_LENGTHbigint
DATA_LENGTHbigint
MAX_DATA_LENGTHbigint
INDEX_LENGTHbigint
DATA_FREEbigint
CREATE_TIMEbigint
UPDATE_TIMEdatetime
CHECK_TIMEdatetime
CHECKSUMbigint
PARTITION_COMMENTtext
NODEGROUPvarchar(256)
TABLESPACE_NAMEvarchar(268)
LOCAL_DATA_SIZEtextパーティションのローカルデータサイズ。コンピュート・ストレージ分離モードでは通常 0 です。詳細は以下を参照してください
REMOTE_DATA_SIZEtextパーティションのリモートデータサイズ(クラウド)
STATEtextパーティションの状態
REPLICA_ALLOCATIONtextタブレットのレプリカの配置。コンピュート・ストレージ分離モードでは NULL です
REPLICA_NUMintレプリカ数
STORAGE_POLICYtextストレージポリシー
STORAGE_MEDIUMtextストレージメディア
COOLDOWN_TIME_MStextクールダウン時間
LAST_CONSISTENCY_CHECK_TIMEtext最後に整合性をチェックした時刻
BUCKET_NUMintパーティションのバケット数
COMMITTED_VERSIONbigint最後にコミットされたバージョン
VISIBLE_VERSIONbigint現在参照可能なバージョン
PARTITION_KEYtextパーティションキー
RANGEtextパーティションの範囲(最小値と最大値)
DISTRIBUTIONtext分散方式

コンピュート・ストレージ分離モードでのデータサイズの扱い​

動作変更(4.0.8)

バージョン 4.0.8 以降、コンピュート・ストレージ分離モードでのパーティションのデータサイズは、一貫してリモートとして報告されます。レプリカ統計でリモートとして記録されていないデータサイズも REMOTE_DATA_SIZE に計上され、対応する LOCAL_DATA_SIZE は 0 と報告されます。このため、分離構成のクラスターでは通常 LOCAL_DATA_SIZE が 0 となり、実際のパーティションのデータサイズは REMOTE_DATA_SIZE に表示されます。

4.0.8 より前は、そのデータサイズが LOCAL_DATA_SIZE に計上されていたため、ローカルとリモートの区分について、information_schema.partitions、SHOW TABLETS、information_schema.backend_tablets の表示に矛盾が生じていました。この変更はデータサイズの報告方法だけを調整するもので、データの保存場所やデータ量は変わりません。

同じ変更により、分離モードでは REPLICA_ALLOCATION が information_schema.partitions で NULL と表示されます(以前は内部プレースホルダーの \N)。レプリカの配置は分離アーキテクチャ自体が管理するため、一体型モードのレプリカ割り当ての扱いには従わなくなります。

パーティションが実際に占有する容量を計算する際は、分離モードでは REMOTE_DATA_SIZE を使用します。

SELECT
TABLE_SCHEMA,
TABLE_NAME,
PARTITION_NAME,
LOCAL_DATA_SIZE,
REMOTE_DATA_SIZE
FROM information_schema.partitions
WHERE TABLE_SCHEMA = 'your_db';