> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> クエリを実行するスレッドに関する情報を格納するシステムテーブルです。 たとえば、スレッド名、スレッドの開始時刻、クエリ処理時間などが含まれます。
# system.query_thread_log
**ClickHouse Cloud でのクエリ**
このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに保持されています。したがって、すべてのデータを完全に把握するには、`clusterAllReplicas` 関数を使用する必要があります。詳細については、[こちら](/ja/reference/system-tables/overview#system-tables-in-clickhouse-cloud)を参照してください。
## 説明
クエリを実行するスレッドに関する情報 (たとえば、スレッド名、スレッドの開始時刻、クエリ処理時間) が含まれます。
ログ記録を開始するには:
1. [query\_thread\_log](/ja/reference/settings/server-settings/settings#query_thread_log) セクションでパラメータを設定します。
2. [log\_query\_threads](/ja/reference/settings/session-settings#log_query_threads) を 1 に設定します。
データのフラッシュ間隔は、[query\_thread\_log](/ja/reference/settings/server-settings/settings#query_thread_log) サーバー設定セクションの `flush_interval_milliseconds` パラメータで設定します。フラッシュを強制するには、[SYSTEM FLUSH LOGS](/ja/reference/statements/system#flush-logs) クエリを使用します。
ClickHouse はテーブルからデータを自動では削除しません。詳細については、[はじめに](/ja/reference/system-tables/overview#system-tables-introduction) を参照してください。
[log\_queries\_probability](/ja/reference/settings/session-settings#log_queries_probability)) 設定を使用すると、`query_thread_log` テーブルに記録されるクエリ数を減らせます。
## カラム
* `hostname` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — クエリを実行するサーバーのホスト名。
* `event_date` ([Date](/ja/reference/data-types/date)) — スレッドがクエリの実行を完了した日付。
* `event_time` ([DateTime](/ja/reference/data-types/datetime)) — スレッドによるクエリの実行が完了した日時。
* `event_time_microseconds` ([DateTime64(6)](/ja/reference/data-types/datetime64)) — スレッドによるクエリの実行がマイクロ秒精度で完了した日時。
* `query_start_time` ([DateTime](/ja/reference/data-types/datetime)) — クエリ実行の開始時刻。
* `query_start_time_microseconds` ([DateTime64(6)](/ja/reference/data-types/datetime64)) — マイクロ秒精度でのクエリ実行の開始時刻。
* `query_duration_ms` ([UInt64](/ja/reference/data-types/int-uint)) — クエリ実行時間。
* `read_rows` ([UInt64](/ja/reference/data-types/int-uint)) — 読み込まれた行数。
* `read_bytes` ([UInt64](/ja/reference/data-types/int-uint)) — 読み込まれたバイト数。
* `written_rows` ([UInt64](/ja/reference/data-types/int-uint)) — INSERT クエリでは、書き込まれた行数です。その他のクエリでは、カラムの値は 0 です。
* `written_bytes` ([UInt64](/ja/reference/data-types/int-uint)) — INSERT クエリでは書き込まれたバイト数を表します。その他のクエリでは、カラムの値は 0 です。
* `memory_usage` ([Int64](/ja/reference/data-types/int-uint)) — このスレッドで割り当てられたメモリ量と解放されたメモリ量の差。
* `peak_memory_usage` ([Int64](/ja/reference/data-types/int-uint)) — このスレッドのコンテキストにおける、割り当て済みメモリ量と解放済みメモリ量の差の最大値。
* `thread_name` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — スレッド名。
* `thread_id` ([UInt64](/ja/reference/data-types/int-uint)) — 内部スレッド ID。
* `master_thread_id` ([UInt64](/ja/reference/data-types/int-uint)) — 初期スレッドのOS上での初期ID。
* `current_database` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — 現在のデータベース名。
* `query` ([String](/ja/reference/data-types/string)) — クエリ文字列。
* `normalized_query_hash` ([UInt64](/ja/reference/data-types/int-uint)) — 正規化されたクエリのハッシュ。定数などは取り除かれています。
* `is_initial_query` ([UInt8](/ja/reference/data-types/int-uint)) — クエリタイプ。設定可能な値: 1 — クエリはクライアントによって開始された、0 — 分散クエリ実行のために、別のクエリによって開始された。
* `connection_address` ([IPv6](/ja/reference/data-types/ipv6)) — 接続元のクライアント IP アドレス。proxy 経由で接続している場合、これは proxy のアドレスになります。
* `connection_port` ([UInt16](/ja/reference/data-types/int-uint)) — 接続元のクライアントのポートです。プロキシ経由で接続している場合は、プロキシのポートになります。
* `user` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — 現在のクエリを実行したユーザー名。
* `query_id` ([String](/ja/reference/data-types/string)) — クエリの ID。
* `address` ([IPv6](/ja/reference/data-types/ipv6)) — クエリの実行元として使用された IP アドレス。プロキシ経由で接続しており、`auth_use_forwarded_address` が設定されている場合、これはプロキシではなくクライアントのアドレスになります。
* `port` ([UInt16](/ja/reference/data-types/int-uint)) — クエリの実行時に使用されたクライアントのポート。プロキシ経由で接続しており、`auth_use_forwarded_address` が設定されている場合、これはプロキシではなくクライアント側のポートになります。
* `initial_user` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — 最初のクエリを実行したユーザー名 (分散クエリ実行時) 。
* `initial_query_id` ([String](/ja/reference/data-types/string)) — 初期クエリの ID (分散クエリ実行時) 。
* `initial_address` ([IPv6](/ja/reference/data-types/ipv6)) — 親クエリの送信元IPアドレス。
* `initial_port` ([UInt16](/ja/reference/data-types/int-uint)) — 親クエリの実行に使用されたクライアントポート。
* `initial_query_start_time` ([DateTime](/ja/reference/data-types/datetime)) — 初期クエリの実行開始時刻。
* `initial_query_start_time_microseconds` ([DateTime64(6)](/ja/reference/data-types/datetime64)) — 最初のクエリの実行開始時刻
* `authenticated_user` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — セッション内で認証されたユーザー名。
* `interface` ([UInt8](/ja/reference/data-types/int-uint)) — クエリの開始元となったインターフェイス。設定可能な値: 1 — TCP、2 — HTTP。
* `is_secure` ([UInt8](/ja/reference/data-types/int-uint)) — 接続がセキュアかどうかを示すフラグ。
* `os_user` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — `clickhouse-client` を実行する OS ユーザー名。
* `client_hostname` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — `clickhouse-client` または別の TCP クライアントを実行しているクライアントマシンのホスト名。
* `client_name` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — `clickhouse-client` またはその他の TCP クライアントの名前。
* `client_agent` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — 環境変数から検出された、クライアントを呼び出した AI コーディング agent (例: `claude-code` や `cursor`) 。agent が検出されなかった場合は空です。
* `client_revision` ([UInt32](/ja/reference/data-types/int-uint)) — clickhouse-client または他の TCP クライアントのリビジョン。
* `client_version_major` ([UInt32](/ja/reference/data-types/int-uint)) — clickhouse-client またはその他の TCP クライアントのメジャーバージョン。
* `client_version_minor` ([UInt32](/ja/reference/data-types/int-uint)) — clickhouse-client またはその他の TCP クライアントのマイナーバージョン。
* `client_version_patch` ([UInt32](/ja/reference/data-types/int-uint)) — clickhouse-client または別の TCP クライアントのバージョンにおけるパッチ部分です。
* `script_query_number` ([UInt32](/ja/reference/data-types/int-uint)) — 複数クエリからなるスクリプトにおける連番のクエリ番号。
* `script_line_number` ([UInt32](/ja/reference/data-types/int-uint)) — 複数クエリを含むスクリプト内で、現在のクエリが開始される行番号。
* `http_method` ([UInt8](/ja/reference/data-types/int-uint)) — クエリの開始に使用された HTTP メソッド。設定可能な値: 0 — クエリは TCP インターフェイス経由で実行された、1 — GET メソッドが使用された。, 2 — POST メソッドが使用された。
* `http_user_agent` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — HTTPリクエストで渡されるUser-Agentヘッダー。
* `http_referer` ([String](/ja/reference/data-types/string)) — HTTPクエリで送信される HTTP ヘッダー `Referer` (クエリを実行したページの絶対アドレスまたは部分的なアドレスを含みます) 。
* `forwarded_for` ([String](/ja/reference/data-types/string)) — HTTPクエリに含まれるHTTPヘッダー `X-Forwarded-For`。
* `quota_key` ([String](/ja/reference/data-types/string)) — quotas 設定で指定する「quota key」。
* `distributed_depth` ([UInt64](/ja/reference/data-types/int-uint)) — サーバー間でクエリが転送された回数。
* `revision` ([UInt32](/ja/reference/data-types/int-uint)) — ClickHouse のリビジョン番号。
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/ja/reference/data-types/map)) — このスレッドのさまざまなメトリクスを計測する `ProfileEvents` です。各イベントの説明は `system.events` テーブルにあります。
**別名:**
* `ProfileEvents.Names` — `mapKeys(ProfileEvents)` の別名です。
* `ProfileEvents.Values` — `mapValues(ProfileEvents)` の別名です。
## 例
```sql theme={null}
SELECT * FROM system.query_thread_log LIMIT 1 \G
```
```text theme={null}
Row 1:
──────
hostname: clickhouse.eu-central1.internal
event_date: 2020-09-11
event_time: 2020-09-11 10:08:17
event_time_microseconds: 2020-09-11 10:08:17.134042
query_start_time: 2020-09-11 10:08:17
query_start_time_microseconds: 2020-09-11 10:08:17.063150
query_duration_ms: 70
read_rows: 0
read_bytes: 0
written_rows: 1
written_bytes: 12
memory_usage: 4300844
peak_memory_usage: 4300844
thread_name: TCPHandler
thread_id: 638133
master_thread_id: 638133
query: INSERT INTO test1 VALUES
is_initial_query: 1
user: default
query_id: 50a320fd-85a8-49b8-8761-98a86bcbacef
address: ::ffff:127.0.0.1
port: 33452
initial_user: default
initial_query_id: 50a320fd-85a8-49b8-8761-98a86bcbacef
initial_address: ::ffff:127.0.0.1
initial_port: 33452
interface: 1
os_user: bharatnc
client_hostname: tower
client_name: ClickHouse
client_revision: 54437
client_version_major: 20
client_version_minor: 7
client_version_patch: 2
http_method: 0
http_user_agent:
quota_key:
revision: 54440
ProfileEvents: {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}
```
## 関連項目
* [system.query\_log](/ja/reference/system-tables/query_log) — クエリの実行に関する一般的な情報を含む `query_log` システムテーブルの説明。
* [system.query\_views\_log](/ja/reference/system-tables/query_views_log) — このテーブルには、クエリの実行中に実行された各ビューに関する情報が含まれます。