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

system.parts

説明

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) — data part の保存形式。設定可能な値: Wide — 各カラムは個別のファイルに保存されます。Compact — すべてのカラムが 1 つのファイルに保存されます。データの保存形式は、MergeTree テーブルの min_bytes_for_wide_part および min_rows_for_wide_part の設定によって制御されます。

  • active (UInt8) — データパーツがアクティブかどうかを示すフラグです。データパーツがアクティブな場合、そのパーツはテーブルで使用されています。そうでない場合は、まもなく削除されます。非アクティブなデータパーツは、マージおよびミューテーション操作の後に現れます。

  • marks (UInt64) — マークの数。data part 内のおおよその行数を求めるには、marks に索引の粒度 (通常は 8192) を掛けます (この方法は adaptive granularity では機能しません) 。

  • 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 になります。

  • primary_key_bytes_in_memory_allocated (UInt64) — 主キーの値用に確保されているメモリ量 (バイト単位) 。primary_key_lazy_load が有効で、キーが読み込まれていない場合は 0 です。

  • index_granularity_bytes_in_memory (UInt64) — 索引粒度の値が使用するメモリ量 (バイト単位) (primary_key_lazy_load=1 かつ use_primary_key_cache=1 の場合は 0 になります) 。

  • index_granularity_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) — パラメータを含まないテーブルエンジン名。

  • 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)) — 日付と時刻の値の配列。各要素は、TTL MOVE ルールにおける最小のキー値を表します。

  • move_ttl_info.max (Array(DateTime)) — 日付と時刻の値の配列。各要素は、TTL MOVE ルールにおける最大キー値を表します。

  • default_compression_codec (String) — このデータパートの圧縮に使用されるコーデック名です (カラムに明示的なコーデックが指定されていない場合) 。

  • recompression_ttl_info.expression (Array(String)) — 有効期限 (TTL) の式。

  • recompression_ttl_info.min (Array(DateTime)) — このパート内で計算された TTL 式の最小値。少なくとも1行で有効期限 (TTL) が切れているかどうかを判断するために使用されます。

  • 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)) — このパートについて計算されたプロジェクション名の一覧。

  • 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 の削除プロセスの現在の状態。

別名:

  • bytesbytes_on_disk のエイリアス。
  • marks_sizemarks_bytes のエイリアス。
  • part_namename のエイリアス。

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:                     []

関連項目