Pular para o conteúdo principal
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 2 de julho de 2026