ClickHouse/docs/ja/operations/system-tables/part_log.md

slug
/ja/operations/system-tables/part_log

part_log

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

このテーブルは、データを追加したりマージするなど、MergeTreeファミリーのテーブルでデータパーツに発生したイベントに関する情報を含んでいます。

system.part_logテーブルには次のカラムが含まれています：

• hostname (LowCardinality(String)) — クエリを実行しているサーバーのホスト名。
• query_id (String) — このデータパーツを作成したINSERTクエリの識別子。
• event_type (Enum8) — データパーツに発生したイベントのタイプ。次のいずれかの値を持つことができます：
  • NewPart — 新しいデータパーツの挿入。
  • MergePartsStart — データパーツのマージが開始された。
  • MergeParts — データパーツのマージが完了した。
  • DownloadPart — データパーツのダウンロード。
  • RemovePart — DETACH PARTITIONを使用したデータパーツの削除またはデタッチ。
  • MutatePartStart — データパーツの変異が開始された。
  • MutatePart — データパーツの変異が完了した。
  • MovePart — データパーツをあるディスクから別のディスクに移動する。
• merge_reason (Enum8) — MERGE_PARTSタイプのイベントの理由。次のいずれかの値を持つことができます：
  • NotAMerge — 現在のイベントはMERGE_PARTS以外のタイプです。
  • RegularMerge — 通常のマージ。
  • TTLDeleteMerge — 有効期限切れデータのクリーンアップ。
  • TTLRecompressMerge — データパーツの再圧縮。
• merge_algorithm (Enum8) — MERGE_PARTSタイプのイベントのマージアルゴリズム。次のいずれかの値を持つことができます：
  • Undecided
  • Horizontal
  • Vertical
• event_date (Date) — イベントの日付。
• event_time (DateTime) — イベントの時刻。
• event_time_microseconds (DateTime64) — マイクロ秒単位の精度でのイベントの時刻。
• duration_ms (UInt64) — 所要時間。
• database (String) — データパーツが存在するデータベースの名前。
• table (String) — データパーツが存在するテーブルの名前。
• part_name (String) — データパーツの名前。
• partition_id (String) — データパーツが挿入されたパーティションのID。パーティショニングがtuple()の場合、このカラムはallの値を取ります。
• 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) — 発生したエラーのテキストメッセージ。

system.part_logテーブルは、最初のデータがMergeTreeテーブルに挿入された後に作成されます。

例

SELECT * FROM system.part_log LIMIT 1 FORMAT Vertical;

Row 1:
──────
hostname:                      clickhouse.eu-central1.internal
query_id:                      983ad9c7-28d5-4ae1-844e-603116b7de31
event_type:                    NewPart
merge_reason:                  NotAMerge
merge_algorithm:               Undecided
event_date:                    2021-02-02
event_time:                    2021-02-02 11:14:28
event_time_microseconds:       2021-02-02 11:14:28.861919
duration_ms:                   35
database:                      default
table:                         log_mt_2
part_name:                     all_1_1_0
partition_id:                  all
path_on_disk:                  db/data/default/log_mt_2/all_1_1_0/
rows:                          115418
size_in_bytes:                 1074311
merged_from:                   []
bytes_uncompressed:            0
read_rows:                     0
read_bytes:                    0
peak_memory_usage:             0
error:                         0
exception: