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 设置中指定的配额键 (请参阅 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) — 指示该查询是否为内部执行的辅助查询。

别名：

• 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.