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

system.query_views_log

ClickHouse Cloud でのクエリ実行

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

説明​

クエリ実行時に実行された依存ビューに関する情報を保持します。たとえば、ビューの種類や実行時間などです。

ログを有効化するには:

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

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

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

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

カラム​

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

別名:

  • ProfileEvents.Names — mapKeys(ProfileEvents) のエイリアス。
  • ProfileEvents.Values — mapValues(ProfileEvents) のエイリアス。

例​

クエリ：

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:

関連情報​