system.parts

MergeTree テーブルのパーツに関する情報を含みます。

各行は1つのデータパーツを記述します。

カラム:

partition (String) – パーティション名。パーティションとは何かを学ぶには、ALTER クエリの説明を参照してください。

フォーマット:
- 自動的な月ごとのパーティショニングでは YYYYMM。
- 手動でパーティショニングする場合は any_string。
name (String) – データパーツの名前。パートの命名構造は、データ、取り込み、マージパターンの多くの側面を特定するために使用できます。パートの命名フォーマットは次の通りです:

定義:
- partition_id - パーティションキーを識別します。
- minimum_block_number - パート内の最小ブロック番号を識別します。ClickHouseは常に連続したブロックをマージします。
- maximum_block_number - パート内の最大ブロック番号を識別します。
- level - パートの追加マージごとに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) – マージツリーの深さ。ゼロは、現在のパートが他のパートをマージするのではなく、挿入によって作成されたことを意味します。
data_version (UInt64) – データパーツに適用する必要のある変異を決定するために使用される数（data_version よりもバージョンが高い変異）。
primary_key_bytes_in_memory (UInt64) – 主キー値によって使用されるメモリの量（バイト単位）。
primary_key_bytes_in_memory_allocated (UInt64) – 主キー値のために予約されたメモリの量（バイト単位）。
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 のエイリアス。

例

関連項目