system.processes

​

Descrição

​

Colunas

• is_initial_query (UInt8) — Indica se a consulta é inicial. Valores possíveis: 1 — uma consulta inicial (de nível superior), 0 — uma consulta filha iniciada por outra consulta, incluindo consultas para execução distribuída e subconsultas internas.
• user (String) — O usuário que fez a consulta. Lembre-se de que, no processamento distribuído, as consultas são enviadas aos servidores remotos usando o usuário default. O campo contém o nome de usuário de uma consulta específica, e não da consulta que a iniciou.
• query_id (String) — ID da consulta, se definido.
• address (IPv6) — O endereço IP de onde a consulta foi feita. O mesmo se aplica ao processamento distribuído. Para rastrear de onde uma consulta distribuída foi originalmente feita, consulte system.processes no servidor que solicitou a consulta.
• port (UInt16) — A porta do cliente usada para fazer a consulta.
• initial_user (String) — Nome do usuário que executou a consulta inicial na mesma cadeia de consultas.
• initial_query_id (String) — ID da consulta inicial na mesma cadeia de consultas.
• initial_address (IPv6) — Endereço IP de onde a consulta inicial na mesma cadeia de consultas foi iniciada.
• initial_port (UInt16) — Porta do cliente de onde a consulta inicial na mesma cadeia de consultas foi iniciada.
• interface (Enum8(‘Unknown’ = 0, ‘TCP’ = 1, ‘HTTP’ = 2, ‘gRPC’ = 3, ‘MySQL’ = 4, ‘PostgreSQL’ = 5, ‘Local’ = 6, ‘TCP_Interserver’ = 7, ‘Prometheus’ = 8, ‘Background’ = 9, ‘ArrowFlight’ = 10, ‘IcebergRESTCatalog’ = 11)) — A interface usada para enviar a consulta, conforme informado pelo cliente. Unknown se a interface informada não for reconhecida por este servidor.
• os_user (String) — Nome de usuário do sistema operacional que executa o clickhouse-client.
• client_hostname (String) — Hostname da máquina cliente em que o clickhouse-client ou outro cliente TCP é executado.
• client_name (String) — Nome do clickhouse-client ou de outro cliente TCP.
• client_agent (LowCardinality(String)) — O agente de programação com IA que invocou o cliente (por exemplo, claude-code, cursor), detectado com base em variáveis de ambiente. Vazio se nenhum agente for detectado.
• client_revision (UInt64) — Revisão do clickhouse-client ou de outro cliente TCP.
• client_version_major (UInt64) — Versão principal do clickhouse-client ou de outro cliente TCP.
• client_version_minor (UInt64) — Versão secundária do clickhouse-client ou de outro cliente TCP.
• client_version_patch (UInt64) — Componente de patch da versão do clickhouse-client ou de outro cliente TCP.
• http_method (Enum8(‘UNKNOWN’ = 0, ‘GET’ = 1, ‘POST’ = 2, ‘OPTIONS’ = 3, ‘PUT’ = 4, ‘DELETE’ = 5, ‘HEAD’ = 6)) — Método HTTP que iniciou a consulta. UNKNOWN se a consulta não chegou por HTTP ou se o método informado não for reconhecido por este servidor.
• http_user_agent (String) — Cabeçalho HTTP UserAgent enviado na consulta HTTP.
• http_referer (String) — Cabeçalho HTTP Referer enviado na consulta HTTP (contém um endereço absoluto ou parcial da página que fez a consulta).
• forwarded_for (String) — Cabeçalho HTTP X-Forwarded-For enviado na consulta HTTP.
• quota_key (String) — A chave de quota especificada na configuração de quotas (consulte keyed).
• distributed_depth (UInt64) — Número de vezes que a consulta foi retransmitida internamente entre nós de servidor.
• elapsed (Float64) — O tempo, em segundos, desde o início da execução da solicitação.
• is_cancelled (UInt8) — Indica se a consulta foi cancelada.
• is_all_data_sent (UInt8) — Indica se todos os dados foram enviados ao cliente (ou seja, se a consulta foi concluída no servidor).
• read_rows (UInt64) — O número de linhas lidas da tabela. No processamento distribuído, no servidor solicitante, corresponde ao total de todos os servidores remotos.
• read_bytes (UInt64) — O número de bytes não comprimidos lidos da tabela. No processamento distribuído, no servidor solicitante, corresponde ao total de todos os servidores remotos.
• total_rows_approx (UInt64) — A estimativa do número total de linhas que devem ser lidas. No processamento distribuído, no servidor solicitante, corresponde ao total de todos os servidores remotos. Pode ser atualizada durante o processamento da solicitação, à medida que novas fontes a serem processadas se tornam conhecidas.
• written_rows (UInt64) — O número de linhas gravadas no armazenamento.
• written_bytes (UInt64) — O número de bytes gravados no armazenamento.
• memory_usage (Int64) — Quantidade de RAM usada pela consulta. Pode não incluir alguns tipos de memória dedicada.
• peak_memory_usage (Int64) — O pico atual de uso de memória.
• query (String) — O texto da consulta. Para INSERT, não inclui os dados a serem inseridos.
• normalized_query_hash (UInt64) — Um valor de hash numérico, idêntico para consultas que diferem apenas pelos valores dos literais.
• query_kind (String) — O tipo da consulta: SELECT, INSERT etc.
• thread_ids (Array(UInt64)) — A lista de identificadores de todas as threads que participaram desta consulta.
• peak_threads_usage (UInt64) — Número máximo de threads simultâneas executando a consulta.
• ProfileEvents (Map(LowCardinality(String), UInt64)) — ProfileEvents calculados para esta consulta.
• Settings (Map(LowCardinality(String), LowCardinality(String))) — A lista de configurações modificadas no nível do usuário.
• current_database (String) — O nome do banco de dados atual.
• is_internal (UInt8) — Indica se é uma consulta auxiliar executada internamente.

• ProfileEvents.Names — Alias de mapKeys(ProfileEvents).
• ProfileEvents.Values — Alias de mapValues(ProfileEvents).
• Settings.Names — Alias de mapKeys(Settings).
• Settings.Values — Alias de mapValues(Settings).

​

Exemplos

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:            TCP
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:          UNKNOWN
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.