Skip to main content

説明

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

カラム

  • partition (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 設定で制御されます。
  • part_storage_type (String) — DataPartStorage のタイプ。設定可能な値: Packed - ほとんどのパーツファイルを単一のアーカイブに保存します (プロジェクションおよび txn_version.txt など一部のサービスファイルは個別に書き込まれます) 、Full - 各ファイルを個別に保存します。
  • active (UInt8) — データパーツがアクティブかどうかを示すフラグ。アクティブなデータパーツはテーブルで使用されます。非アクティブなデータパーツは削除予定です。非アクティブなデータパーツは、マージおよびミューテーション操作後に現れます。
  • marks (UInt64) — マーク数。データパーツ内の行数の概算値を取得するには、マーク数に索引粒度 (通常は8192) を乗算します (この方法は適応型粒度では使用できません) 。
  • rows (UInt64) — 行数。
  • files (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 (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_key_lazy_load=1 かつ use_primary_key_cache=1 の場合は 0) 。0 以外の場合、これらのバイトはパーツに属し、jemalloc.mergetree_arena.active_bytes に計上されます。
  • index_granularity_bytes_in_memory_allocated (UInt64) — 索引粒度値用に確保されたメモリ量 (バイト単位) (primary_key_lazy_load=1 かつ use_primary_key_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)) — 式の Array。各式は TTL MOVE ルールを定義します。
  • move_ttl_info.min (Array(DateTime)) — 日時値の Array。各要素は TTL MOVE ルールの最小キー値を示します。
  • move_ttl_info.max (Array(DateTime)) — 日時値の Array。各要素は TTL MOVE ルールの最大キー値を示します。
  • default_compression_codec (String) — カラムに明示的な codec が指定されていない場合、または CODEC(Default) を使用している場合に、このデータパートの圧縮に使用される codec の名前です。allow_experimental_adaptive_codec_selection を使用すると、このようなカラムの個々のブロックで別の codec が使用される場合があります。詳細は mergeTreeCodecBlockCounts を参照してください。
  • recompression_ttl_info.expression (Array(String)) — TTL 式。
  • recompression_ttl_info.min (Array(DateTime)) — このパート内で計算された 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)) — このパート内で計算された TTL 式の最小値。有効期限 (TTL) が切れた行が少なくとも 1 行あるかどうかの判断に使用します。
  • 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)) — このパートに対して計算された projection 名のリスト。
  • visible (UInt8) — このパートが SELECT クエリから参照可能かどうかを示すフラグ。
  • creation_tid (Tuple(UInt64, UInt64, UUID)) — このオブジェクトを作成した、または作成しようとしている transaction の ID。
  • removal_tid_lock (UInt64) — removal_tid の hash。削除時にオブジェクトを lock するために使用します。
  • removal_tid (Tuple(UInt64, UInt64, UUID)) — このオブジェクトを削除した、または削除しようとしている transaction の ID。
  • creation_csn (UInt64) — このオブジェクトを作成した transaction の CSN。
  • removal_csn (UInt64) — このオブジェクトを削除した transaction の CSN。
  • has_lightweight_delete (UInt8) — このパートに論理削除マスクがあるかどうかを示すフラグ。
  • last_removal_attempt_time (DateTime) — server がこのパートの削除を最後に試行した時刻。
  • removal_state (String) — パート削除プロセスの現在の状態。
別名:
  • bytesbytes_on_disk の別名。
  • marks_sizemarks_bytes の別名。
  • part_namename の別名。

関連項目

最終更新日 2026年8月14日