Skip to main content
Consultas no ClickHouse CloudOs dados nesta tabela de sistema são mantidos localmente em cada nó do ClickHouse Cloud. Portanto, para obter uma visão completa de todos os dados, é necessário usar a função clusterAllReplicas. Consulte aqui para mais detalhes.

​
Descrição

Contém informações sobre threads que executam consultas, por exemplo, nome da thread, horário de início da thread e duração do processamento da consulta. Para iniciar o logging:
  1. Configure os parâmetros na seção query_thread_log.
  2. Defina log_query_threads como 1.
O período de flush dos dados é definido no parâmetro flush_interval_milliseconds da seção de configurações do servidor query_thread_log. Para forçar o flush, use a consulta SYSTEM FLUSH LOGS. O ClickHouse não exclui dados da tabela automaticamente. Consulte Introdução para mais detalhes. Você pode usar a configuração log_queries_probability) para reduzir o número de consultas registradas na tabela query_thread_log.

​
Colunas

  • hostname (LowCardinality(String)) — Nome do host do servidor que executa a consulta.
  • event_date (Date) — A data em que a thread concluiu a execução da consulta.
  • event_time (DateTime) — A data e a hora em que a thread concluiu a execução da consulta.
  • event_time_microseconds (DateTime64(6)) — A data e a hora em que a thread finalizou a execução da consulta, com precisão de microssegundos.
  • query_start_time (DateTime) — Horário de início da execução da consulta.
  • query_start_time_microseconds (DateTime64(6)) — Horário de início da execução da consulta, com precisão de microssegundos.
  • query_duration_ms (UInt64) — Duração da consulta.
  • read_rows (UInt64) — Número de linhas lidas.
  • read_bytes (UInt64) — Número de bytes lidos.
  • written_rows (UInt64) — Para consultas INSERT, o número de linhas gravadas. Para outras consultas, o valor da coluna é 0.
  • written_bytes (UInt64) — Para consultas INSERT, o número de bytes gravados. Para as demais consultas, o valor da coluna é 0.
  • memory_usage (Int64) — A diferença entre a quantidade de memória alocada e a liberada no contexto desta thread.
  • peak_memory_usage (Int64) — A diferença máxima entre a quantidade de memória alocada e a liberada no contexto desta thread.
  • thread_name (LowCardinality(String)) — Nome da thread.
  • thread_id (UInt64) — ID interno da thread.
  • master_thread_id (UInt64) — ID da thread inicial no SO.
  • current_database (LowCardinality(String)) — Nome do banco de dados atual.
  • query (String) — Texto da consulta.
  • normalized_query_hash (UInt64) — O hash da consulta normalizada, com as constantes removidas etc.
  • is_initial_query (UInt8) — Tipo de consulta. Valores possíveis: 1 — A consulta foi iniciada pelo cliente, 0 — A consulta foi iniciada por outra consulta para execução distribuída de consultas.
  • connection_address (IPv6) — O endereço IP do cliente a partir do qual a conexão foi estabelecida. Quando a conexão é feita por meio de um proxy, este será o endereço do proxy.
  • connection_port (UInt16) — A porta do cliente a partir da qual a conexão foi feita. Quando a conexão é feita por meio de um proxy, esta será a porta do proxy.
  • user (LowCardinality(String)) — Nome do usuário que iniciou a consulta atual.
  • query_id (String) — ID da consulta.
  • address (IPv6) — endereço IP usado para fazer a consulta. Quando a conexão é feita por meio de um proxy e auth_use_forwarded_address está definido, este será o endereço do cliente em vez do endereço do proxy.
  • port (UInt16) — A porta do cliente usada para fazer a consulta. Quando a conexão é feita por meio de um proxy e auth_use_forwarded_address está definido, esta será a porta do cliente em vez da porta do proxy.
  • initial_user (LowCardinality(String)) — Nome do usuário que executou a consulta inicial (para execução distribuída de consultas).
  • initial_query_id (String) — ID da consulta inicial (para execução distribuída de consultas).
  • initial_address (IPv6) — endereço IP a partir do qual a consulta principal foi iniciada.
  • initial_port (UInt16) — A porta do cliente usada para fazer a consulta pai.
  • initial_query_start_time (DateTime) — Horário de início da execução da consulta inicial.
  • initial_query_start_time_microseconds (DateTime64(6)) — Horário de início da execução da consulta inicial
  • authenticated_user (LowCardinality(String)) — Nome do usuário autenticado na sessão.
  • interface (UInt8) — Interface pela qual a consulta foi iniciada. Valores possíveis: 1 — TCP, 2 — HTTP.
  • is_secure (UInt8) — O sinalizador que indica se a conexão era segura.
  • os_user (LowCardinality(String)) — nome de usuário do sistema operacional que está executando o clickhouse-client.
  • client_hostname (LowCardinality(String)) — Hostname da máquina cliente na qual o clickhouse-client ou outro cliente TCP é executado.
  • client_name (LowCardinality(String)) — O nome do clickhouse-client ou de outro cliente TCP.
  • client_agent (LowCardinality(String)) — O agente de IA para programação que invocou o cliente (por exemplo, claude-code ou cursor), detectado por variáveis de ambiente. Fica vazio se nenhum agente for detectado.
  • client_revision (UInt32) — Revisão do clickhouse-client ou de outro cliente TCP.
  • client_version_major (UInt32) — Versão major do clickhouse-client ou de outro cliente TCP.
  • client_version_minor (UInt32) — Versão secundária do clickhouse-client ou de outro cliente TCP.
  • client_version_patch (UInt32) — Componente de patch da versão do clickhouse-client ou de outro cliente TCP.
  • script_query_number (UInt32) — Um número sequencial da consulta em um script com várias consultas.
  • script_line_number (UInt32) — O número da linha em um script com várias consultas em que a consulta atual começa.
  • http_method (UInt8) — Método HTTP que iniciou a consulta. Valores possíveis: 0 — a consulta foi iniciada pela interface TCP, 1 — foi usado o método GET., 2 — foi usado o método POST.
  • http_user_agent (LowCardinality(String)) — O cabeçalho UserAgent enviado na requisição HTTP.
  • http_referer (String) — cabeçalho HTTP Referer enviado na consulta HTTP (contém um endereço absoluto ou parcial da página que faz 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.
  • distributed_depth (UInt64) — Quantas vezes uma consulta foi encaminhada entre os servidores.
  • revision (UInt32) — número de revisão do ClickHouse.
  • ProfileEvents (Map(LowCardinality(String), UInt64)) — ProfileEvents que medem diferentes métricas para esta thread. A descrição deles pode ser encontrada na tabela system.events.
Aliases:
  • ProfileEvents.Names — Alias para mapKeys(ProfileEvents).
  • ProfileEvents.Values — Alias para mapValues(ProfileEvents).

​
Exemplo

​
Veja também

  • system.query_log — Descrição da tabela do sistema query_log, que contém informações gerais sobre a execução de consultas.
  • system.query_views_log — Esta tabela contém informações sobre cada view executada durante uma consulta.
Última modificação em 3 de julho de 2026