> ## 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.

> Tabela do sistema que 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.

# system.query_thread_log

<Info>
  **Consultas no ClickHouse Cloud**

  Os 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](/pt-BR/reference/system-tables/overview#system-tables-in-clickhouse-cloud) para mais detalhes.
</Info>

<div id="description">
  ## Descrição
</div>

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](/pt-BR/reference/settings/server-settings/settings#query_thread_log).
2. Defina [log\_query\_threads](/pt-BR/reference/settings/session-settings#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](/pt-BR/reference/settings/server-settings/settings#query_thread_log). Para forçar o flush, use a consulta [SYSTEM FLUSH LOGS](/pt-BR/reference/statements/system#flush-logs).

O ClickHouse não exclui dados da tabela automaticamente. Consulte [Introdução](/pt-BR/reference/system-tables/overview#system-tables-introduction) para mais detalhes.

Você pode usar a configuração [log\_queries\_probability](/pt-BR/reference/settings/session-settings#log_queries_probability)) para reduzir o número de consultas registradas na tabela `query_thread_log`.

<div id="columns">
  ## Colunas
</div>

* `hostname` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — Nome do host do servidor que executa a consulta.
* `event_date` ([Date](/pt-BR/reference/data-types/date)) — A data em que a thread concluiu a execução da consulta.
* `event_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — A data e a hora em que a thread concluiu a execução da consulta.
* `event_time_microseconds` ([DateTime64(6)](/pt-BR/reference/data-types/datetime64)) — A data e a hora em que a thread finalizou a execução da consulta, com precisão de microssegundos.
* `query_start_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — Horário de início da execução da consulta.
* `query_start_time_microseconds` ([DateTime64(6)](/pt-BR/reference/data-types/datetime64)) — Horário de início da execução da consulta, com precisão de microssegundos.
* `query_duration_ms` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Duração da consulta.
* `read_rows` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Número de linhas lidas.
* `read_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Número de bytes lidos.
* `written_rows` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Para consultas INSERT, o número de linhas gravadas. Para outras consultas, o valor da coluna é 0.
* `written_bytes` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Para consultas INSERT, o número de bytes gravados. Para as demais consultas, o valor da coluna é 0.
* `memory_usage` ([Int64](/pt-BR/reference/data-types/int-uint)) — A diferença entre a quantidade de memória alocada e a liberada no contexto desta thread.
* `peak_memory_usage` ([Int64](/pt-BR/reference/data-types/int-uint)) — A diferença máxima entre a quantidade de memória alocada e a liberada no contexto desta thread.
* `thread_name` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — Nome da thread.
* `thread_id` ([UInt64](/pt-BR/reference/data-types/int-uint)) — ID interno da thread.
* `master_thread_id` ([UInt64](/pt-BR/reference/data-types/int-uint)) — ID da thread inicial no SO.
* `current_database` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — Nome do banco de dados atual.
* `query` ([String](/pt-BR/reference/data-types/string)) — Texto da consulta.
* `normalized_query_hash` ([UInt64](/pt-BR/reference/data-types/int-uint)) — O hash da consulta normalizada, com as constantes removidas etc.
* `is_initial_query` ([UInt8](/pt-BR/reference/data-types/int-uint)) — 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](/pt-BR/reference/data-types/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](/pt-BR/reference/data-types/int-uint)) — 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)](/pt-BR/reference/data-types/lowcardinality)) — Nome do usuário que iniciou a consulta atual.
* `query_id` ([String](/pt-BR/reference/data-types/string)) — ID da consulta.
* `address` ([IPv6](/pt-BR/reference/data-types/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](/pt-BR/reference/data-types/int-uint)) — 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)](/pt-BR/reference/data-types/lowcardinality)) — Nome do usuário que executou a consulta inicial (para execução distribuída de consultas).
* `initial_query_id` ([String](/pt-BR/reference/data-types/string)) — ID da consulta inicial (para execução distribuída de consultas).
* `initial_address` ([IPv6](/pt-BR/reference/data-types/ipv6)) — endereço IP a partir do qual a consulta principal foi iniciada.
* `initial_port` ([UInt16](/pt-BR/reference/data-types/int-uint)) — A porta do cliente usada para fazer a consulta pai.
* `initial_query_start_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — Horário de início da execução da consulta inicial.
* `initial_query_start_time_microseconds` ([DateTime64(6)](/pt-BR/reference/data-types/datetime64)) — Horário de início da execução da consulta inicial
* `authenticated_user` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — Nome do usuário autenticado na sessão.
* `interface` ([UInt8](/pt-BR/reference/data-types/int-uint)) — Interface pela qual a consulta foi iniciada. Valores possíveis: 1 — TCP, 2 — HTTP.
* `is_secure` ([UInt8](/pt-BR/reference/data-types/int-uint)) — O sinalizador que indica se a conexão era segura.
* `os_user` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — nome de usuário do sistema operacional que está executando o clickhouse-client.
* `client_hostname` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — Hostname da máquina cliente na qual o `clickhouse-client` ou outro cliente TCP é executado.
* `client_name` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — O nome do clickhouse-client ou de outro cliente TCP.
* `client_revision` ([UInt32](/pt-BR/reference/data-types/int-uint)) — Revisão do clickhouse-client ou de outro cliente TCP.
* `client_version_major` ([UInt32](/pt-BR/reference/data-types/int-uint)) — Versão major do clickhouse-client ou de outro cliente TCP.
* `client_version_minor` ([UInt32](/pt-BR/reference/data-types/int-uint)) — Versão secundária do clickhouse-client ou de outro cliente TCP.
* `client_version_patch` ([UInt32](/pt-BR/reference/data-types/int-uint)) — Componente de patch da versão do clickhouse-client ou de outro cliente TCP.
* `script_query_number` ([UInt32](/pt-BR/reference/data-types/int-uint)) — Um número sequencial da consulta em um script com várias consultas.
* `script_line_number` ([UInt32](/pt-BR/reference/data-types/int-uint)) — O número da linha em um script com várias consultas em que a consulta atual começa.
* `http_method` ([UInt8](/pt-BR/reference/data-types/int-uint)) — 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)](/pt-BR/reference/data-types/lowcardinality)) — O cabeçalho UserAgent enviado na requisição HTTP.
* `http_referer` ([String](/pt-BR/reference/data-types/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](/pt-BR/reference/data-types/string)) — cabeçalho HTTP `X-Forwarded-For` enviado na consulta HTTP.
* `quota_key` ([String](/pt-BR/reference/data-types/string)) — A 'chave de quota' especificada na configuração de quotas.
* `distributed_depth` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Quantas vezes uma consulta foi encaminhada entre os servidores.
* `revision` ([UInt32](/pt-BR/reference/data-types/int-uint)) — número de revisão do ClickHouse.
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/pt-BR/reference/data-types/map)) — `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)`.

<div id="example">
  ## Exemplo
</div>

```sql theme={null}
 SELECT * FROM system.query_thread_log LIMIT 1 \G
```

```text theme={null}
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}
```

<div id="see-also">
  ## Veja também
</div>

* [system.query\_log](/pt-BR/reference/system-tables/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](/pt-BR/reference/system-tables/query_views_log) — Esta tabela contém informações sobre cada view executada durante uma consulta.
