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

slug
/ja/operations/system-tables/query_views_log

query_views_log

クエリを実行した際に実行された依存ビューに関する情報を含みます。例えば、ビューの種類や実行時間を示します。

ログを開始するには次の手順に従います：

1. query_views_log セクションでパラメータを設定します。
2. log_query_views を1に設定します。

データのフラッシュ間隔は、サーバー設定セクションの query_views_log の flush_interval_milliseconds パラメータで設定します。強制的にフラッシュするには、SYSTEM FLUSH LOGS クエリを使用します。

ClickHouseはテーブルからデータを自動的に削除しません。詳細は概要を参照してください。

query_views_log テーブルに登録されるクエリの数を減らすには、log_queries_probability 設定を使用できます。

カラム:

• hostname (LowCardinality(String)) — クエリを実行しているサーバーのホスト名。
• event_date (Date) — ビューの最後のイベントが発生した日付。
• event_time (DateTime) — ビューが実行を終了した日時。
• event_time_microseconds (DateTime) — マイクロ秒精度でビューが実行を終了した日時。
• view_duration_ms (UInt64) — ビューの実行時間 (各ステージの合計) をミリ秒単位で。
• initial_query_id (String) — 初期クエリのID (分散クエリ実行のため)。
• view_name (String) — ビューの名前。
• view_uuid (UUID) — ビューのUUID。
• view_type (Enum8) — ビューの種類。値:
  • 'Default' = 1 — デフォルトビュー。このログには表示されません。
  • 'Materialized' = 2 — マテリアライズドビュー。
  • 'Live' = 3 — ライブビュー。
• view_query (String) — ビューが実行したクエリ。
• view_target (String) — ビューのターゲットテーブルの名前。
• read_rows (UInt64) — 読み取った行数。
• read_bytes (UInt64) — 読み取ったバイト数。
• written_rows (UInt64) — 書き込まれた行数。
• written_bytes (UInt64) — 書き込まれたバイト数。
• peak_memory_usage (Int64) — このビューのコンテキスト内で割り当てられたメモリと解放されたメモリの最大差。
• ProfileEvents (Map(String, UInt64)) — 異なるメトリクスを測定するProfileEvents。詳細は system.events テーブルで見つかります。
• status (Enum8) — ビューのステータス。値:
  • 'QueryStart' = 1 — ビュー実行の成功した開始。表示されません。
  • 'QueryFinish' = 2 — ビュー実行の成功した終了。
  • 'ExceptionBeforeStart' = 3 — ビュー実行開始前の例外。
  • 'ExceptionWhileProcessing' = 4 — ビュー実行中の例外。
• exception_code (Int32) — 例外コード。
• exception (String) — 例外メッセージ。
• stack_trace (String) — スタックトレース。クエリが正常に完了した場合は空。

例

クエリ:

SELECT * FROM system.query_views_log LIMIT 1 \G;

結果:

Row 1:
──────
hostname:                clickhouse.eu-central1.internal
event_date:              2021-06-22
event_time:              2021-06-22 13:23:07
event_time_microseconds: 2021-06-22 13:23:07.738221
view_duration_ms:        0
initial_query_id:        c3a1ac02-9cad-479b-af54-9e9c0a7afd70
view_name:               default.matview_inner
view_uuid:               00000000-0000-0000-0000-000000000000
view_type:               Materialized
view_query:              SELECT * FROM default.table_b
view_target:             default.`.inner.matview_inner`
read_rows:               4
read_bytes:              64
written_rows:            2
written_bytes:           32
peak_memory_usage:       4196188
ProfileEvents:           {'FileOpen':2,'WriteBufferFromFileDescriptorWrite':2,'WriteBufferFromFileDescriptorWriteBytes':187,'IOBufferAllocs':3,'IOBufferAllocBytes':3145773,'FunctionExecute':3,'DiskWriteElapsedMicroseconds':13,'InsertedRows':2,'InsertedBytes':16,'SelectedRows':4,'SelectedBytes':48,'ContextLock':16,'RWLockAcquiredReadLocks':1,'RealTimeMicroseconds':698,'SoftPageFaults':4,'OSReadChars':463}
status:                  QueryFinish
exception_code:          0
exception:
stack_trace:

参照

• system.query_log — クエリ実行に関する一般情報を含む query_log システムテーブルの説明。
• system.query_thread_log — 各クエリ実行スレッドに関する情報を含むこのテーブル。