system.query_views_log

ClickHouse Cloudでのクエリ

このシステムテーブルのデータは、ClickHouse Cloudの各ノードにローカルに保存されています。したがって、すべてのデータの完全なビューを取得するには、clusterAllReplicas 関数が必要です。詳細については、こちらをご覧ください。

クエリを実行する際に実行された依存ビューに関する情報を含みます。例えば、ビューのタイプや実行時間など。

ログを開始するには:

query_views_log セクションでパラメータを設定します。
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 (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) — スタックトレース。クエリが成功裏に完了した場合は空の文字列。

例

クエリ:

結果:

関連情報

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