Set up docs MCP説明
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 ずつ増加します。レベルが 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_loadとuse_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) — パート削除プロセスの現在の状態。
別名:
bytes—bytes_on_diskの別名。marks_size—marks_bytesの別名。part_name—nameの別名。
例
SELECT * FROM system.parts LIMIT 1 FORMAT Vertical;Row 1:
──────
partition: tuple()
name: all_1_4_1_6
part_type: Wide
part_storage_type: Full
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: []