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_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

 SELECT * FROM system.query_thread_log LIMIT 1 \G
Row 1:
──────
hostname:                      clickhouse.eu-central1.internal
event_date:                    2020-09-11
event_time:                    2020-09-11 10:08:17
event_time_microseconds:       2020-09-11 10:08:17.134042
query_start_time:              2020-09-11 10:08:17
query_start_time_microseconds: 2020-09-11 10:08:17.063150
query_duration_ms:             70
read_rows:                     0
read_bytes:                    0
written_rows:                  1
written_bytes:                 12
memory_usage:                  4300844
peak_memory_usage:             4300844
thread_name:                   TCPHandler
thread_id:                     638133
master_thread_id:              638133
query:                         INSERT INTO test1 VALUES
is_initial_query:              1
user:                          default
query_id:                      50a320fd-85a8-49b8-8761-98a86bcbacef
address:                       ::ffff:127.0.0.1
port:                          33452
initial_user:                  default
initial_query_id:              50a320fd-85a8-49b8-8761-98a86bcbacef
initial_address:               ::ffff:127.0.0.1
initial_port:                  33452
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:
revision:                      54440
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}

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 10 de junho de 2026