system.processes

このシステムテーブルは、SHOW PROCESSLIST クエリの実装に使用されます。

• is_initial_query (UInt8) — クエリが初期クエリかどうか。設定可能な値: 1 — 初期 (最上位) クエリ、0 — 分散実行のクエリおよび内部サブクエリを含む、別のクエリによって開始された子クエリ。
• user (String) — クエリを実行したユーザー。分散処理では、クエリはdefaultユーザーとしてリモートサーバーに送信されることに注意してください。このフィールドには特定のクエリのユーザー名が含まれ、このクエリによって開始されたクエリのユーザー名は含まれません。
• query_id (String) — 定義されている場合のクエリID。
• address (IPv6) — クエリの送信元IPアドレス。分散処理でも同様です。分散クエリが元々どこから送信されたかを追跡するには、クエリ要求元サーバーのsystem.processesを確認してください。
• port (UInt16) — クエリの送信元クライアントポート。
• initial_user (String) — 同じクエリチェーン内の初期クエリを実行したユーザー名。
• initial_query_id (String) — 同じクエリチェーン内の初期クエリのID。
• initial_address (IPv6) — 同じクエリチェーン内の初期クエリの送信元IPアドレス。
• initial_port (UInt16) — 同じクエリチェーン内の初期クエリの送信元クライアントポート。
• interface (UInt8) — クエリの送信に使用されたインターフェイス。TCP = 1、HTTP = 2、GRPC = 3、MYSQL = 4、POSTGRESQL = 5、LOCAL = 6、TCP_INTERSERVER = 7。
• os_user (String) — clickhouse-clientを実行しているオペレーティングシステムのユーザー名。
• client_hostname (String) — clickhouse-clientまたは別のTCPクライアントが実行されているクライアントマシンのホスト名。
• client_name (String) — clickhouse-clientまたは別のTCPクライアントの名前。
• client_agent (LowCardinality(String)) — クライアントを呼び出したAIコーディングagent (例: claude-code、cursor) 。環境変数から検出され、agentが検出されなかった場合は空です。
• client_revision (UInt64) — clickhouse-clientまたは別のTCPクライアントのリビジョン。
• client_version_major (UInt64) — clickhouse-clientまたは別のTCPクライアントのメジャーバージョン。
• client_version_minor (UInt64) — clickhouse-clientまたは別のTCPクライアントのマイナーバージョン。
• client_version_patch (UInt64) — clickhouse-clientまたは別のTCPクライアントのバージョンのパッチ番号。
• http_method (UInt8) — クエリを開始したHTTPメソッド。設定可能な値: 0 - TCPインターフェイスからクエリが開始されました、1 - GETメソッドが使用されました、2 - POSTメソッドが使用されました、4 - PUTメソッドが使用されました、5 - DELETEメソッドが使用されました、6 - HEADメソッドが使用されました。
• http_user_agent (String) — HTTPクエリで渡されたUserAgent HTTPヘッダー。
• http_referer (String) — HTTPクエリで渡されたReferer HTTPヘッダー (クエリを実行するページの絶対アドレスまたは部分アドレスを含みます) 。
• forwarded_for (String) — HTTPクエリで渡されたX-Forwarded-For HTTPヘッダー。
• quota_key (String) — quotas設定で指定されたquota key (keyedを参照) 。
• distributed_depth (UInt64) — クエリが内部的にServer nodes間で再送信された回数。
• elapsed (Float64) — リクエスト実行開始からの経過時間 (秒) 。
• is_cancelled (UInt8) — クエリがキャンセルされたかどうか。
• is_all_data_sent (UInt8) — すべてのデータがクライアントに送信されたかどうか (つまり、サーバー上でクエリが完了したかどうか) 。
• read_rows (UInt64) — テーブルから読み取られた行数。分散処理では、リクエスト元サーバーではすべてのリモートサーバーの合計です。
• read_bytes (UInt64) — テーブルから読み取られた非圧縮バイト数。分散処理では、リクエスト元サーバーではすべてのリモートサーバーの合計です。
• total_rows_approx (UInt64) — 読み取る必要がある合計行数のおおよその値。分散処理では、リクエスト元サーバーではすべてのリモートサーバーの合計です。処理対象の新しいデータソースが判明すると、リクエスト処理中に更新されることがあります。
• written_rows (UInt64) — ストレージに書き込まれた行数。
• written_bytes (UInt64) — ストレージに書き込まれたバイト数。
• memory_usage (Int64) — クエリが使用する RAM 容量。一部の専用メモリは含まれない場合があります。
• peak_memory_usage (Int64) — 現在のメモリ使用量のピーク値。
• query (String) — クエリテキスト。INSERT の場合、挿入するデータは含まれません。
• normalized_query_hash (UInt64) — リテラル値のみが異なるクエリでは同一となる数値ハッシュ値。
• query_kind (String) — クエリの種類 (SELECT、INSERT など) 。
• thread_ids (Array(UInt64)) — このクエリの実行に関与したすべてのスレッドの識別子リスト。
• peak_threads_usage (UInt64) — クエリ実行時の同時スレッド数の最大値。
• ProfileEvents (Map(LowCardinality(String), UInt64)) — このクエリについて計算された ProfileEvents。
• Settings (Map(LowCardinality(String), LowCardinality(String))) — 変更されたユーザーレベル設定のリスト。
• current_database (String) — 現在のデータベース名。
• is_internal (UInt8) — 内部的に実行される補助クエリかどうかを示します。

別名:

• ProfileEvents.Names — mapKeys(ProfileEvents)の別名。
• ProfileEvents.Values — mapValues(ProfileEvents)の別名。
• Settings.Names — mapKeys(Settings)の別名。
• Settings.Values — mapValues(Settings)の別名。

SELECT * FROM system.processes LIMIT 10 FORMAT Vertical;

Row 1:
──────
is_initial_query:     1
user:                 default
query_id:             35a360fa-3743-441d-8e1f-228c938268da
address:              ::ffff:172.23.0.1
port:                 47588
initial_user:         default
initial_query_id:     35a360fa-3743-441d-8e1f-228c938268da
initial_address:      ::ffff:172.23.0.1
initial_port:         47588
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:
elapsed:              0.000582537
is_cancelled:         0
is_all_data_sent:     0
read_rows:            0
read_bytes:           0
total_rows_approx:    0
written_rows:         0
written_bytes:        0
memory_usage:         0
peak_memory_usage:    0
query:                SELECT * from system.processes LIMIT 10 FORMAT Vertical;
thread_ids:           [67]
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}
Settings:             {'background_pool_size':'32','load_balancing':'random','allow_suspicious_low_cardinality_types':'1','distributed_aggregation_memory_efficient':'1','skip_unavailable_shards':'1','log_queries':'1','max_bytes_before_external_group_by':'20000000000','max_bytes_before_external_sort':'20000000000','allow_introspection_functions':'1'}

1 rows in set. Elapsed: 0.002 sec.