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

system.part_log

ClickHouse Cloud でのクエリ実行

このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに格納されています。そのため、すべてのデータを包括的に確認するには、clusterAllReplicas 関数を使用する必要があります。詳細についてはこちらを参照してください。

part_log サーバー設定が指定されている場合にのみ、system.part_log テーブルが作成されます。

このテーブルには、MergeTree ファミリーのテーブル内の データパーツ に対して発生した、追加やマージなどのイベントに関する情報が含まれます。

system.part_log テーブルには次の列が含まれます。

  • hostname (LowCardinality(String)) — クエリを実行しているサーバーのホスト名。
  • query_id (String) — このデータパートを作成した INSERT クエリの識別子。
  • event_type (Enum8) — データパーツに対して発生したイベントの種類。次のいずれかの値を取ります。
    • NewPart — 新しいデータパーツの挿入処理。
    • MergePartsStart — データパーツのマージ開始。
    • MergeParts — データパーツのマージ完了。
    • DownloadPart — データパーツのダウンロード処理。
    • RemovePartDETACH PARTITION を使用したデータパーツの削除またはデタッチ。
    • MutatePartStart — データパーツのミューテーション開始。
    • MutatePart — データパーツのミューテーション完了。
    • MovePart — データパーツをあるディスクから別のディスクへ移動する処理。
  • merge_reason (Enum8) — 型 MERGE_PARTS のイベントが発生した理由。次のいずれかの値を取ります:`
    • NotAMerge — 現在のイベントタイプが MERGE_PARTS 以外の場合。
    • RegularMerge — 通常のマージ。
    • TTLDeleteMerge — 有効期限切れデータの削除。
    • TTLRecompressMerge — データパーツの再圧縮。
  • merge_algorithm (Enum8) — タイプが MERGE_PARTS のイベントに対して使用されるマージアルゴリズム。取り得る値は次のいずれかです:
    • 未決定
    • 水平
    • 垂直
  • event_date (Date) — イベントの日付。
  • event_time (DateTime) — イベントの発生時刻。
  • event_time_microseconds (DateTime64) — マイクロ秒精度のイベントの時刻。
  • duration_ms (UInt64) — 継続時間。
  • database (String) — データパーツが属するデータベースの名前。
  • table (String) — データパーツが含まれているテーブルの名前。
  • table_uuid (UUID) — データパートが属するテーブルのUUID。
  • part_name (String) — データパーツ名。
  • partition_id (String) — データパートが挿入されたパーティションの ID。パーティション分割が tuple() によって行われている場合、この列は all の値を取ります。
  • partition (String) - パーティションの名前。
  • part_type (String) - パーツのタイプ。取り得る値は Wide と Compact です。
  • disk_name (String) - データパーツが配置されているディスク名。
  • path_on_disk (String) — データパーツファイルが格納されているフォルダへの絶対パス。
  • rows (UInt64) — データパートに含まれる行数です。
  • size_in_bytes (UInt64) — データパートのサイズ(バイト単位)。
  • merged_from (Array(String)) — 現在のパーツが(マージ後に)作成される際に元となったパーツ名の配列。
  • bytes_uncompressed (UInt64) — 非圧縮データのバイト数。
  • read_rows (UInt64) — マージ中に読み込まれた行数。
  • read_bytes (UInt64) — マージ中に読み取られたバイト数。
  • peak_memory_usage (Int64) — このスレッドのコンテキストにおいて、割り当てられたメモリ量と解放されたメモリ量の差の最大値。
  • error (UInt16) — 発生したエラーのエラーコード。
  • exception (String) — 発生したエラーの内容を示すテキストメッセージ。
  • ProfileEvents (Map(String, UInt64)) — 各種メトリクスを計測する ProfileEvents。それぞれの説明はテーブル system.events に記載されています。

system.part_log テーブルは、MergeTree テーブルにデータを初めて挿入した後に作成されます。

SELECT * FROM system.part_log LIMIT 1 FORMAT Vertical;
Row 1:
──────
hostname:                clickhouse.eu-central1.internal
query_id:
event_type:              MergeParts
merge_reason:            RegularMerge
merge_algorithm:         Vertical
event_date:              2025-07-19
event_time:              2025-07-19 23:54:19
event_time_microseconds: 2025-07-19 23:54:19.710761
duration_ms:             2158
database:                default
table:                   github_events
table_uuid:              1ad33424-f5f5-402b-ac03-ec82282634ab
part_name:               all_1_7_1
partition_id:            all
partition:               tuple()
part_type:               Wide
disk_name:               default
path_on_disk:            ./data/store/1ad/1ad33424-f5f5-402b-ac03-ec82282634ab/all_1_7_1/
rows:                    3285726 -- 329万
size_in_bytes:           438968542 -- 4億3897万
merged_from:             ['all_1_1_0','all_2_2_0','all_3_3_0','all_4_4_0','all_5_5_0','all_6_6_0','all_7_7_0']
bytes_uncompressed:      1373137767 -- 13億7000万
read_rows:               3285726 -- 329万
read_bytes:              1429206946 -- 14億3000万
peak_memory_usage:       303611887 -- 3億361万
error:                   0
exception:
ProfileEvents:           {'FileOpen':703,'ReadBufferFromFileDescriptorRead':3824,'ReadBufferFromFileDescriptorReadBytes':439601681,'WriteBufferFromFileDescriptorWrite':592,'WriteBufferFromFileDescriptorWriteBytes':438988500,'ReadCompressedBytes':439601681,'CompressedReadBufferBlocks':6314,'CompressedReadBufferBytes':1539835748,'OpenedFileCacheHits':50,'OpenedFileCacheMisses':484,'OpenedFileCacheMicroseconds':222,'IOBufferAllocs':1914,'IOBufferAllocBytes':319810140,'ArenaAllocChunks':8,'ArenaAllocBytes':131072,'MarkCacheMisses':7,'CreatedReadBufferOrdinary':534,'DiskReadElapsedMicroseconds':139058,'DiskWriteElapsedMicroseconds':51639,'AnalyzePatchRangesMicroseconds':28,'ExternalProcessingFilesTotal':1,'RowsReadByMainReader':170857759,'WaitMarksLoadMicroseconds':988,'LoadedMarksFiles':7,'LoadedMarksCount':14,'LoadedMarksMemoryBytes':728,'Merge':2,'MergeSourceParts':14,'MergedRows':3285733,'MergedColumns':4,'GatheredColumns':51,'MergedUncompressedBytes':1429207058,'MergeTotalMilliseconds':2158,'MergeExecuteMilliseconds':2155,'MergeHorizontalStageTotalMilliseconds':145,'MergeHorizontalStageExecuteMilliseconds':145,'MergeVerticalStageTotalMilliseconds':2008,'MergeVerticalStageExecuteMilliseconds':2006,'MergeProjectionStageTotalMilliseconds':5,'MergeProjectionStageExecuteMilliseconds':4,'MergingSortedMilliseconds':7,'GatheringColumnMilliseconds':56,'ContextLock':2091,'PartsLockHoldMicroseconds':77,'PartsLockWaitMicroseconds':1,'RealTimeMicroseconds':2157475,'CannotWriteToWriteBufferDiscard':36,'LogTrace':6,'LogDebug':59,'LoggerElapsedNanoseconds':514040,'ConcurrencyControlSlotsGranted':53,'ConcurrencyControlSlotsAcquired':53}