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

system.query_thread_log

Querying in ClickHouse Cloud

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

クエリを実行するスレッドに関する情報を含みます。例えば、スレッド名、スレッドの開始時刻、クエリ処理の期間などです。

ログ記録を開始するには:

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

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

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

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

カラム:

  • hostname (LowCardinality(String)) — クエリを実行するサーバのホスト名。
  • event_date (Date) — スレッドがクエリの実行を終了した日付。
  • event_time (DateTime) — スレッドがクエリの実行を終了した日付と時刻。
  • event_time_microseconds (DateTime) — スレッドがクエリの実行を終了した日付と時刻(マイクロ秒精度)。
  • query_start_time (DateTime) — クエリ実行の開始時刻。
  • query_start_time_microseconds (DateTime64) — クエリ実行の開始時刻(マイクロ秒精度)。
  • query_duration_ms (UInt64) — クエリ実行の期間。
  • read_rows (UInt64) — 読み取った行数。
  • read_bytes (UInt64) — 読み取ったバイト数。
  • written_rows (UInt64) — INSERT クエリの場合、書き込まれた行数。その他のクエリの場合、このカラムの値は 0 です。
  • written_bytes (UInt64) — INSERT クエリの場合、書き込まれたバイト数。その他のクエリの場合、このカラムの値は 0 です。
  • memory_usage (Int64) — このスレッドのコンテキストにおける、割り当てられたメモリと解放されたメモリの差。
  • peak_memory_usage (Int64) — このスレッドのコンテキストにおける、割り当てられたメモリと解放されたメモリの最大差。
  • thread_name (String) — スレッドの名前。
  • thread_id (UInt64) — OS スレッド ID。
  • master_thread_id (UInt64) — 初期スレッドの OS 初期 ID。
  • query (String) — クエリ文字列。
  • is_initial_query (UInt8) — クエリのタイプ。可能な値:
    • 1 — クエリはクライアントによって開始されました。
    • 0 — クエリは別のクエリによって分散クエリ実行のために開始されました。
  • user (String) — 現在のクエリを開始したユーザーの名前。
  • query_id (String) — クエリの ID。
  • address (IPv6) — クエリを実行するために使用された IP アドレス。
  • port (UInt16) — クエリを実行するために使用されたクライアントポート。
  • initial_user (String) — 初期クエリを実行したユーザーの名前(分散クエリ実行用)。
  • initial_query_id (String) — 初期クエリの ID(分散クエリ実行用)。
  • initial_address (IPv6) — 親クエリが起動された IP アドレス。
  • initial_port (UInt16) — 親クエリを実行するために使用されたクライアントポート。
  • interface (UInt8) — クエリが開始されたインターフェイス。可能な値:
    • 1 — TCP。
    • 2 — HTTP。
  • os_user (String) — clickhouse-client を実行している OS のユーザー名。
  • client_hostname (String) — clickhouse-client または別の TCP クライアントが実行されているクライアントマシンのホスト名。
  • client_name (String) — clickhouse-client または別の TCP クライアントの名前。
  • client_revision (UInt32) — clickhouse-client または別の TCP クライアントのリビジョン。
  • client_version_major (UInt32) — clickhouse-client または別の TCP クライアントのメジャーバージョン。
  • client_version_minor (UInt32) — clickhouse-client または別の TCP クライアントのマイナーバージョン。
  • client_version_patch (UInt32) — clickhouse-client または別の TCP クライアントのパッチコンポーネント。
  • http_method (UInt8) — クエリを開始した HTTP メソッド。可能な値:
    • 0 — クエリは TCP インターフェイスから起動されました。
    • 1 — GET メソッドが使用されました。
    • 2 — POST メソッドが使用されました。
  • http_user_agent (String) — HTTP リクエストで渡された UserAgent ヘッダー。
  • quota_key (String) — quotas 設定に指定された「クォータキー」(keyed を参照)。
  • revision (UInt32) — ClickHouse のリビジョン。
  • ProfileEvents (Map(String, UInt64)) — このスレッドの異なるメトリクスを測定する ProfileEvents。この説明は system.events テーブルで見つけることができます。

関連項目

  • system.query_log — クエリ実行に関する共通情報を含む query_log システムテーブルの説明。
  • system.query_views_log — このテーブルには、クエリ中に実行された各ビューに関する情報が含まれています。