メインコンテンツへスキップ

説明

MergeTree テーブルのパーツに関する情報を含みます。 各行は 1 つのデータパーツを表します。

カラム

  • partition (String) — パーティション識別子 (テーブルのパーティションキー式から導出された文字列表現) 。
  • name (String) — データパーツの名前。パーツの命名構造を使うと、データ、取り込み、マージのパターンに関するさまざまな特性を判断できます。パーツの命名フォーマットは次のとおりです。
<partition_id>_<minimum_block_number>_<maximum_block_number>_<level>_<data_version>
  • 定義:
    • 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) — マークの数。data part 内のおおよその行数を求めるには、marks に index granularity (通常は 8192) を掛けます (この目安は adaptive granularity では機能しません) 。
  • rows (UInt64) — 行数。
  • files (UInt64) — データパート内のファイルの数。
  • bytes_on_disk (UInt64) — すべてのデータパートファイルの総サイズ (バイト単位) 。
  • data_compressed_bytes (UInt64) — データパート内の圧縮データの合計サイズです。補助ファイル (たとえば、mark を含むファイル) は含まれません。
  • data_uncompressed_bytes (UInt64) — データパート内の非圧縮データの合計サイズです。補助ファイル (たとえば、マークファイル) は含まれません。
  • primary_key_size (UInt64) — ディスク上の primary.idx/cidx ファイル内で主キー値が使用しているメモリ量 (バイト単位) 。
  • marks_bytes (UInt64) — marks ファイルのサイズ。
  • secondary_indices_compressed_bytes (UInt64) — データパート内のセカンダリ索引の圧縮データの合計サイズ。補助ファイル (たとえば、マークファイル) は含まれません。
  • secondary_indices_uncompressed_bytes (UInt64) — データパート内のセカンダリ索引における非圧縮データの合計サイズ。すべての補助ファイル (たとえば、マークファイル) は含まれません。
  • secondary_indices_marks_bytes (UInt64) — セカンダリ索引のマークファイルのサイズ。
  • modification_time (DateTime) — データパートが格納されているディレクトリが変更された時刻です。通常、これはデータパートの作成時刻に対応します。
  • remove_time (DateTime) — データパートが非アクティブになった時刻。
  • refcount (UInt32) — data part が使用されている箇所の数です。値が 2 より大きい場合、その data part はクエリまたはマージで使用されています。
  • min_date (Date) — データパートの日付キーの最小値。
  • max_date (Date) — data part内の日付キーの最大値。
  • min_time (DateTime) — データパート内の日時キーの最小値。
  • max_time (DateTime) — データパート内の日時キーの最大値。
  • partition_id (String) — パーティションの ID。
  • min_block_number (Int64) — マージ後の現在のパーツを構成するデータパーツの最小番号。
  • max_block_number (Int64) — マージ後に現在のパーツを構成するデータパーツのうち最大の番号。
  • level (UInt32) — マージツリーの深さ。0 は、現在のパーツが他のパーツのマージではなく、insert によって作成されたことを意味します。
  • data_version (UInt64) — データパートにどの mutation を適用すべきかを判定するための数値 (data_version より大きいバージョンの mutation) 。
  • primary_key_bytes_in_memory (UInt64) — 主キーの値が使用するメモリ量 (バイト単位) 。primary_key_lazy_load が有効で、かつキーが読み込まれていない場合は 0 になります。0 以外の場合、これらのバイトはパート自体に存在し、jemalloc.mergetree_arena.active_bytes に計上されます。これらが PrimaryIndexCacheBytes に計上されることは決してありません。つまり、パートごとに両者は相互排他的です。primary_key_lazy_loaduse_primary_key_cache の設定に応じて、索引はパート内 (このメトリクス) または共有の PrimaryIndexCache (もう一方) のいずれかに存在します。
  • primary_key_bytes_in_memory_allocated (UInt64) — 主キー値のために予約されているメモリ量 (バイト単位) 。primary_key_lazy_load が有効で、キーが読み込まれていない場合は 0 になります。0 以外の場合は、jemalloc.mergetree_arena.active_bytes に含まれます。PrimaryIndexCacheBytes との関係については、primary_key_bytes_in_memory の注記を参照してください。
  • index_granularity_bytes_in_memory (UInt64) — 索引粒度の値に使用されるメモリ量 (バイト単位) (primary&#95;key&#95;lazy&#95;load=1 かつ use&#95;primary&#95;key&#95;cache=1 の場合は 0 になります) 。0 以外の場合、これらのバイトは部分的に所有され、jemalloc.mergetree_arena.active_bytes 内で計上されます。
  • index_granularity_bytes_in_memory_allocated (UInt64) — 索引 granularity 値用に予約されているメモリ量 (バイト単位) (primary&#95;key&#95;lazy&#95;load=1 および use&#95;primary&#95;key&#95;cache=1 の場合は 0 になります) 。0 以外の場合は、jemalloc.mergetree_arena.active_bytes に含まれます。
  • is_frozen (UInt8) — パーティションデータのバックアップの有無を示すフラグです。1 はバックアップが存在すること、0 は存在しないことを表します。詳細については、FREEZE PARTITION を参照してください。
  • database (String) — データベース名。
  • table (String) — テーブル名。
  • engine (String) — パラメータなしのテーブルエンジン名。
  • disk_name (String) — データパートを保存するディスクの名前。
  • path (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.min (Array(DateTime)) — 日付と時刻の値からなる Array。各要素は、TTL MOVE ルールにおける最小のキー値を表します。
  • move_ttl_info.max (Array(DateTime)) — 日時の値の配列。各要素は、TTL MOVE ルールにおける最大キー値を表します。
  • default_compression_codec (String) — このデータパートの圧縮に使用される codec の名前 (カラムに明示的な codec が指定されていない場合) 。
  • recompression_ttl_info.expression (Array(String)) — TTL の式。
  • recompression_ttl_info.min (Array(DateTime)) — この part 内で計算された TTL 式の最小値。TTL が期限切れの行が少なくとも 1 行あるかどうかを把握するために使用されます。
  • recompression_ttl_info.max (Array(DateTime)) — このパート内で計算された TTL 式の最大値です。TTL が期限切れになったすべての行が含まれているかどうかを把握するために使用されます。
  • group_by_ttl_info.expression (Array(String)) — TTL の式。
  • group_by_ttl_info.min (Array(DateTime)) — この part における、計算された有効期限 (TTL) 式の最小値。少なくとも 1 行の有効期限 (TTL) 切れのデータがあるかどうかを把握するために使用されます。
  • group_by_ttl_info.max (Array(DateTime)) — このパート内で計算されたTTL式の最大値です。TTLの有効期限が切れたすべての行が含まれているかどうかを確認するために使用されます。
  • rows_where_ttl_info.expression (Array(String)) — TTL 式。
  • rows_where_ttl_info.min (Array(DateTime)) — このパート内で計算されたTTL式の最小値です。有効期限 (TTL) が切れた行が少なくとも1つ存在するかどうかを確認するために使用されます。
  • rows_where_ttl_info.max (Array(DateTime)) — このパート内で計算された TTL 式の最大値です。TTL が期限切れのすべての行が揃っているかどうかを把握するために使用されます。
  • projections (Array(String)) — この part について計算されたプロジェクション名の一覧。
  • visible (UInt8) — このパートが SELECT クエリで可視かどうかを示すフラグ。
  • creation_tid (Tuple(UInt64, UInt64, UUID)) — このオブジェクトを作成した、または作成を試みているトランザクションのID。
  • removal_tid_lock (UInt64) — removal_tid のハッシュ値。オブジェクトを削除用にロックするために使用されます。
  • removal_tid (Tuple(UInt64, UInt64, UUID)) — このオブジェクトを削除した、または削除しようとしているトランザクションのID
  • creation_csn (UInt64) — このオブジェクトを作成したトランザクションのCSN
  • removal_csn (UInt64) — このオブジェクトを削除したトランザクションのCSN
  • has_lightweight_delete (UInt8) — そのパートが論理削除マスクを保持しているかどうかを示すフラグです。
  • last_removal_attempt_time (DateTime) — サーバーが最後にこのパートの削除を試みた時刻。
  • removal_state (String) — part の削除処理の現在の状態。

SELECT * FROM system.parts LIMIT 1 FORMAT Vertical;
Row 1:
──────
partition:                             tuple()
name:                                  all_1_4_1_6
part_type:                             Wide
active:                                1
marks:                                 2
rows:                                  6
bytes_on_disk:                         310
data_compressed_bytes:                 157
data_uncompressed_bytes:               91
secondary_indices_compressed_bytes:    58
secondary_indices_uncompressed_bytes:  6
secondary_indices_marks_bytes:         48
marks_bytes:                           144
modification_time:                     2020-06-18 13:01:49
remove_time:                           1970-01-01 00:00:00
refcount:                              1
min_date:                              1970-01-01
max_date:                              1970-01-01
min_time:                              1970-01-01 00:00:00
max_time:                              1970-01-01 00:00:00
partition_id:                          all
min_block_number:                      1
max_block_number:                      4
level:                                 1
data_version:                          6
primary_key_bytes_in_memory:           8
primary_key_bytes_in_memory_allocated: 64
is_frozen:                             0
database:                              default
table:                                 months
engine:                                MergeTree
disk_name:                             default
path:                                  /var/lib/clickhouse/data/default/months/all_1_4_1_6/
hash_of_all_files:                     2d0657a16d9430824d35e327fcbd87bf
hash_of_uncompressed_files:            84950cc30ba867c77a408ae21332ba29
uncompressed_hash_of_compressed_files: 1ad78f1c6843bbfb99a2c931abe7df7d
delete_ttl_info_min:                   1970-01-01 00:00:00
delete_ttl_info_max:                   1970-01-01 00:00:00
move_ttl_info.expression:              []
move_ttl_info.min:                     []
move_ttl_info.max:                     []

関連項目

最終更新日 2026年6月10日