メインコンテンツへスキップ
ClickHouse Cloud でのクエリこのシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに保持されています。したがって、すべてのデータを完全に把握するには、clusterAllReplicas 関数を使用する必要があります。詳細については、こちらを参照してください。

説明

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

カラム

  • is_initial_query (UInt8) — このクエリがユーザーから直接送信されたものか、または distributed query execution の一環として ClickHouse server によって発行されたものかを示します。
  • user (String) — クエリを実行したユーザー。distributed processing では、クエリは default user でリモートサーバーに送信される点に注意してください。このフィールドには、このクエリが起点となって実行されたクエリではなく、そのクエリ自体の username が含まれます。
  • query_id (String) — 定義されている場合の Query ID。
  • address (IPv6) — クエリの送信元 IP アドレス。distributed processing でも同様です。分散クエリが最初にどこから送信されたかを追跡するには、クエリ要求元サーバーの system.processes を参照してください。
  • port (UInt16) — クエリの送信元 client のポート。
  • initial_user (String) — 初期クエリを実行したユーザー名 (distributed query execution の場合) 。
  • initial_query_id (String) — 初期クエリの ID (distributed query execution の場合) 。
  • initial_address (IPv6) — 親クエリの送信元 IP アドレス。
  • initial_port (UInt16) — 親クエリの送信に使用された client のポート。
  • interface (UInt8) — クエリの送信に使用されたインターフェイス。TCP = 1, HTTP = 2, GRPC = 3, MYSQL = 4, POSTGRESQL = 5, LOCAL = 6, TCP_INTERSERVER = 7。
  • os_user (String) — clickhouse-client を実行しているオペレーティングシステムの username。
  • client_hostname (String) — clickhouse-client または別の TCP client を実行している client マシンの hostname。
  • client_name (String) — clickhouse-client または別の TCP client の名前。
  • client_agent (LowCardinality(String)) — client を呼び出した AI コーディング agent (例: claude-codecursor) 。環境変数から検出されます。agent が検出されなかった場合は空です。
  • client_revision (UInt64) — clickhouse-client または別の TCP client のリビジョン。
  • client_version_major (UInt64) — clickhouse-client または別の TCP client のメジャーバージョン。
  • client_version_minor (UInt64) — clickhouse-client または別の TCP client のマイナーバージョン。
  • client_version_patch (UInt64) — clickhouse-client または別の TCP client のバージョンのパッチ部分。
  • http_method (UInt8) — クエリを開始した HTTP メソッド。設定可能な値: 0 — クエリは TCP インターフェイスから開始されました。1 — GET メソッドが使用されました。2 — POST メソッドが使用されました。
  • http_user_agent (String) — HTTP クエリで渡された UserAgent HTTP header。
  • http_referer (String) — HTTP クエリで渡された Referer HTTP header (クエリを実行したページの絶対または部分アドレスを含みます) 。
  • forwarded_for (String) — HTTP クエリで渡された X-Forwarded-For HTTP header。
  • quota_key (String) — quotas 設定で指定された quota key (keyed を参照) 。
  • distributed_depth (UInt64) — クエリが内部的に server ノード間で再送信された回数。
  • 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) — 数値の hash value。たとえば、リテラルの値だけが異なるクエリでは同一になります。
  • 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) — 内部的に実行された補助クエリかどうかを示します。
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.
最終更新日 2026年6月25日