メインコンテンツまでスキップ
メインコンテンツまでスキップ

system.query_views_log

Querying in 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 を参照してください。

log_queries_probability 設定を使用して、query_views_log テーブルに登録されるクエリの数を減少させることができます。

カラム:

  • 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) — ビューのタイプ。値:
  • 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) — スタックトレース。クエリが成功裏に完了した場合は空の文字列。

クエリ:

結果:

関連情報

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