> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> 用于实现 `SHOW PROCESSLIST` 查询的系统表。
# system.processes
**在 ClickHouse Cloud 中查询**
此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 `clusterAllReplicas` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
## 描述
该系统表用于实现 `SHOW PROCESSLIST` 查询。
## 列
* `is_initial_query` ([UInt8](/zh/reference/data-types)) — 该查询是否直接来自用户，还是由 ClickHouse server 在分布式查询执行过程中发起。
* `user` ([String](/zh/reference/data-types)) — 发出该查询的用户。请注意，在分布式处理场景中，查询会以默认用户的身份发送到远程服务器。该字段包含的是某个特定查询的用户名，而不是由该查询发起的其他查询的用户名。
* `query_id` ([String](/zh/reference/data-types)) — 查询 ID (如已定义) 。
* `address` ([IPv6](/zh/reference/data-types)) — 发起该查询的 IP 地址。对于分布式处理，情况也相同。要追踪分布式查询最初是从哪里发起的，请查看查询发起方服务器上的 system.processes。
* `port` ([UInt16](/zh/reference/data-types)) — 发起该查询的客户端所使用的端口。
* `initial_user` ([String](/zh/reference/data-types)) — 执行初始查询的用户名 (用于分布式查询执行) 。
* `initial_query_id` ([String](/zh/reference/data-types)) — 初始查询的 ID (用于分布式查询执行) 。
* `initial_address` ([IPv6](/zh/reference/data-types)) — 发起父查询时使用的 IP 地址。
* `initial_port` ([UInt16](/zh/reference/data-types)) — 发起父查询时使用的客户端端口。
* `interface` ([UInt8](/zh/reference/data-types)) — 发送该查询所使用的接口。TCP = 1，HTTP = 2，GRPC = 3，MYSQL = 4，POSTGRESQL = 5，LOCAL = 6，TCP\_INTERSERVER = 7。
* `os_user` ([String](/zh/reference/data-types)) — 运行 clickhouse-client 的操作系统用户名。
* `client_hostname` ([String](/zh/reference/data-types)) — 运行 clickhouse-client 或其他 TCP 客户端的客户机的主机名。
* `client_name` ([String](/zh/reference/data-types)) — clickhouse-client 或其他 TCP 客户端名称。
* `client_revision` ([UInt64](/zh/reference/data-types)) — clickhouse-client 或其他 TCP 客户端的修订号。
* `client_version_major` ([UInt64](/zh/reference/data-types)) — clickhouse-client 或其他 TCP 客户端的主版本号。
* `client_version_minor` ([UInt64](/zh/reference/data-types)) — clickhouse-client 或其他 TCP 客户端的次版本。
* `client_version_patch` ([UInt64](/zh/reference/data-types)) — `clickhouse-client` 或其他 TCP 客户端的补丁版本号。
* `http_method` ([UInt8](/zh/reference/data-types)) — 发起该查询的 HTTP 方法。可能的值：0 — 该查询通过 TCP 接口发起。1 — 使用了 GET 方法。2 — 使用了 POST 方法。
* `http_user_agent` ([String](/zh/reference/data-types)) — 在 HTTP 查询中传递的 UserAgent HTTP 请求头。
* `http_referer` ([String](/zh/reference/data-types)) — 在 HTTP 查询中传递的 HTTP 请求头 Referer (包含发起该查询的页面的完整地址或部分地址) 。
* `forwarded_for` ([String](/zh/reference/data-types)) — 在 HTTP 查询中传递的 X-Forwarded-For HTTP 请求头。
* `quota_key` ([String](/zh/reference/data-types)) — 在 quotas 设置中指定的配额键 (参见 keyed) 。
* `distributed_depth` ([UInt64](/zh/reference/data-types)) — 查询在服务器节点之间内部被重新传输的次数。
* `elapsed` ([Float64](/zh/reference/data-types)) — 自请求开始执行以来经过的秒数。
* `is_cancelled` ([UInt8](/zh/reference/data-types)) — 查询是否已被取消。
* `is_all_data_sent` ([UInt8](/zh/reference/data-types)) — 是否已将所有数据发送给客户端 (也就是说，查询已在服务器上完成) 。
* `read_rows` ([UInt64](/zh/reference/data-types)) — 从表中读取的行数。对于分布式处理，在请求方服务器上，该值表示所有远程服务器读取行数的总和。
* `read_bytes` ([UInt64](/zh/reference/data-types)) — 从表中读取的未压缩字节数。对于分布式处理，在发起请求的服务器上，该值表示所有远程服务器的总计。
* `total_rows_approx` ([UInt64](/zh/reference/data-types)) — 应读取的总行数的近似值。对于分布式处理，在请求方服务器上，该值表示所有远程服务器的总和。在处理请求期间，当发现需要处理的新数据源时，该值可能会更新。
* `written_rows` ([UInt64](/zh/reference/data-types)) — 写入存储中的行数。
* `written_bytes` ([UInt64](/zh/reference/data-types)) — 写入存储的数据字节数。
* `memory_usage` ([Int64](/zh/reference/data-types)) — 查询使用的 RAM 用量。它可能不包括某些类型的专用内存
* `peak_memory_usage` ([Int64](/zh/reference/data-types)) — 当前内存使用量的峰值。
* `query` ([String](/zh/reference/data-types)) — 查询文本。对于 INSERT，它不包含插入的数据。
* `normalized_query_hash` ([UInt64](/zh/reference/data-types)) — 一个数值哈希值；对于仅字面量值不同的查询，该值相同。
* `query_kind` ([String](/zh/reference/data-types)) — 查询类型 - SELECT、INSERT 等。
* `thread_ids` ([Array(UInt64)](/zh/reference/data-types)) — 参与该查询的所有线程的标识符列表。
* `peak_threads_usage` ([UInt64](/zh/reference/data-types)) — 执行该查询时同时运行的线程数上限。
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/zh/reference/data-types)) — 为此查询计算得到的 ProfileEvents。
* `Settings` ([Map(LowCardinality(String), LowCardinality(String))](/zh/reference/data-types)) — 修改过的用户级设置列表。
* `current_database` ([String](/zh/reference/data-types)) — 当前 database 的名称。
* `is_internal` ([UInt8](/zh/reference/data-types)) — 表示该查询是否为内部执行的辅助查询。
```sql theme={null}
SELECT * FROM system.processes LIMIT 10 FORMAT Vertical;
```
```response theme={null}
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.
```