system.parts
MergeTree テーブルのパーツに関する情報を格納します。
各行は 1 つのデータパーツを表します。
カラム:
-
partition(String) – パーティション名。パーティションとは何かについては、ALTER クエリの説明を参照してください。形式:
- 月ごとの自動パーティションの場合は
YYYYMM。 - 手動パーティションの場合は
any_string。
- 月ごとの自動パーティションの場合は
-
name(String) – データパーツの名前。パーツ名の構造から、データ、取り込み、およびマージパターンに関する多くの側面を把握できます。パーツ名の形式は次のとおりです。
-
定義:
partition_id- パーティションキーを識別しますminimum_block_number- パーツ内の最小ブロック番号を識別します。ClickHouse は常に連続したブロックをマージしますmaximum_block_number- パーツ内の最大ブロック番号を識別しますlevel- パーツに対するマージが 1 回行われるたびに 1 ずつ増加します。レベル 0 は、まだマージされていない新しいパーツであることを示します。ClickHouse のすべてのパーツは常に不変（イミュータブル）であることを理解しておくことが重要ですdata_version- オプションの値で、パーツに対してミューテーションが実行されると増加します（繰り返しになりますが、パーツは不変であるため、ミューテーションされたデータは常に新しいパーツにのみ書き込まれます）
-
uuid(UUID) - データパーツのUUID。 -
part_type(String) — データパーツの格納形式。指定可能な値:
-
Wide— 各列がファイルシステム内の別々のファイルに保存されます。 -
Compact— すべての列がファイルシステム内の1つのファイルに保存されます。データの保存形式は、MergeTree テーブルの
min_bytes_for_wide_partおよびmin_rows_for_wide_partの設定によって制御されます。
-
-
active(UInt8) – データパーツがアクティブかどうかを示すフラグ。データパーツがアクティブな場合、そのパーツはテーブルで利用される。そうでない場合は削除される。非アクティブなデータパーツはマージ処理後も残る。 -
marks(UInt64) – マーク数。データパート内のおおよその行数を求めるには、marksにインデックス粒度（通常は 8192）を掛けます（この目安はアダプティブ粒度を使用している場合には当てはまりません）。 -
rows(UInt64) – 行数。 -
bytes_on_disk(UInt64) – すべてのデータパーツファイルのサイズ合計（バイト単位）。 -
data_compressed_bytes(UInt64) – データパート内の圧縮済みデータの合計サイズ。すべての補助ファイル（たとえばマークファイル）は含まれません。 -
data_uncompressed_bytes(UInt64) – データパート内の非圧縮データの合計サイズ。すべての補助ファイル（たとえばマークファイル）は含まれません。 -
primary_key_size(UInt64) – ディスク上の primary.idx/cidx ファイルにおいて、プライマリキー値によって消費されているメモリ量（バイト数）。 -
marks_bytes(UInt64) – マークを含むファイルのサイズ。 -
secondary_indices_compressed_bytes(UInt64) – データパーツ内のセカンダリインデックスに対する圧縮データの合計サイズ。マークファイルなどの補助ファイルは含まれません。 -
secondary_indices_uncompressed_bytes(UInt64) – データパーツ内のセカンダリインデックスに対する非圧縮データの合計サイズです。すべての補助ファイル（たとえばマークのファイルなど）は含まれません。 -
secondary_indices_marks_bytes(UInt64) – セカンダリインデックスのマークを含むファイルのサイズ。 -
modification_time(DateTime) – データパーツのディレクトリが更新された時刻。通常はデータパーツの作成時刻に対応します。 -
remove_time(DateTime) – データパーツが非アクティブになった時刻。 -
refcount(UInt32) – データパーツが使用されている箇所の数。値が 2 を超える場合、そのデータパーツがクエリまたはマージで使用されていることを示します。 -
min_date(Date) – データパートにおける日付キーの最小値。 -
max_date(Date) – データパーツ内における日付キーの最大値です。 -
min_time(DateTime) – データパート内の日付と時刻キーの最小値。 -
max_time(DateTime) – データパーツ内の日付時刻キーの最大値。 -
partition_id(String) – パーティション ID。 -
min_block_number(UInt64) – マージ後に形成される現在のパートを構成するデータブロック番号の最小値。 -
max_block_number(UInt64) – マージ後の現在のパーツを構成するデータブロック番号の最大値。 -
level(UInt32) – マージツリーの深さ。0 の場合、現在のパートは他のパートのマージではなく、挿入によって作成されたことを意味します。 -
data_version(UInt64) – データパーツに対してどのミューテーションを適用すべきかを判定するために使用される数値（data_versionより大きいバージョンを持つミューテーションが適用される）。 -
primary_key_bytes_in_memory(UInt64) – プライマリキーの値によって使用されているメモリ量（バイト単位）。primary_key_lazy_load=1かつuse_primary_key_cache=1の場合は0になります。 -
primary_key_bytes_in_memory_allocated(UInt64) – プライマリキー値のために確保されているメモリ容量（バイト単位）。primary_key_lazy_load=1かつuse_primary_key_cache=1の場合は0になります。 -
is_frozen(UInt8) – パーティションデータのバックアップが存在するかを示すフラグ。1 の場合はバックアップが存在し、0 の場合はバックアップが存在しません。詳細は FREEZE PARTITION を参照してください。 -
database(String) – データベースの名前。 -
table(String) – テーブルの名前。 -
engine(String) – パラメータなしのテーブルエンジン名。 -
path(String) – データパーツのファイルが格納されているフォルダへの絶対パス。 -
disk_name(String) – データパーツが保存されているディスクの名前。 -
hash_of_all_files(String) – 圧縮ファイルの sipHash128 値。 -
hash_of_uncompressed_files(String) – 非圧縮ファイル（マークファイル、インデックスファイルなど）に対する sipHash128 のハッシュ値。 -
uncompressed_hash_of_compressed_files(String) – 圧縮ファイル内のデータを、非圧縮データとして扱った場合の sipHash128。 -
delete_ttl_info_min(DateTime) — TTL DELETE ルール における日付時刻キーの最小値。 -
delete_ttl_info_max(DateTime) — TTL DELETE ルール における日付と時刻キーの最大値です。 -
move_ttl_info.expression(Array(String)) — ルールを定義する式の配列です。各式は TTL MOVE ルール を定義します。
move_ttl_info.expression 配列は主に後方互換性のために残されています。現在では、TTL MOVE ルールを確認する最も簡単な方法は、move_ttl_info.min および move_ttl_info.max フィールドを使用することです。
-
move_ttl_info.min(Array(DateTime)) — 日付と時刻の値の配列。各要素は、TTL MOVE ルールの最小キー値を表します。 -
move_ttl_info.max(Array(DateTime)) — 日付と時刻の値の配列。各要素は、TTL MOVE ルールの最大キー値を表します。 -
bytes(UInt64) –bytes_on_diskのエイリアス。 -
marks_size(UInt64) –marks_bytesのエイリアス。
例
関連項目
