跳转到主要内容
在 ClickHouse Cloud 中查询此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此,如需查看所有数据的完整情况,需要使用 clusterAllReplicas 函数。更多详情请参见此处

描述

该系统表用于实现 SHOW PROCESSLIST 查询。

  • is_initial_query (UInt8) — 此查询是否直接来自用户,或由 ClickHouse server 在分布式查询执行过程中发起。
  • 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-codecursor) ,从环境变量中检测得到。如果未检测到 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 方法。
  • http_user_agent (String) — HTTP 查询中传递的 HTTP 请求头 UserAgent。
  • http_referer (String) — HTTP 查询中传递的 HTTP 请求头 Referer (包含发起查询页面的完整地址或部分地址) 。
  • forwarded_for (String) — HTTP 查询中传递的 HTTP 请求头 X-Forwarded-For。
  • quota_key (String) — 在 quotas 设置中指定的配额键 (参见 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) — 数值型哈希值;例如,对于仅字面量值不同的查询,该值是相同的。
  • 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月29日