system.processes
ClickHouse Cloud でのクエリ実行
このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに格納されています。そのため、すべてのデータを包括的に確認するには、clusterAllReplicas 関数を使用する必要があります。詳細についてはこちらを参照してください。
このシステムテーブルは、SHOW PROCESSLIST クエリを実装するために使用されます。
列:
is_initial_query(UInt8) — クエリがユーザーから直接発行されたものか、分散クエリ実行の一環として ClickHouse サーバーによって発行されたものかを示します。user(String) — クエリを実行したユーザー。分散処理の場合、クエリはデフォルトユーザーとしてリモートサーバーに送信されることに注意してください。このフィールドに含まれるのは、このクエリが起点となって実行された別のクエリのユーザー名ではなく、このクエリ自体に対するユーザー名です。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_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 メソッドが使用された。http_user_agent(String) — HTTP クエリで送信された HTTP ヘッダーUser-Agentの値。http_referer(String) — HTTP クエリで送信される HTTP ヘッダー Referer（クエリを発行したページの絶対 URL または部分的なアドレスを含む）。forwarded_for(String) — HTTP クエリで送信された HTTP ヘッダー X-Forwarded-For。quota_key(String) — quotas 設定で指定されたクオータキー（keyedを参照）。distributed_depth(UInt64) — クエリが内部的にサーバーノード間で再送信された回数。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) — 内部的に実行される補助クエリであるかどうかを示します。
