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 as VIEWs dependentes executadas durante uma consulta, por exemplo, o tipo de VIEW ou o tempo de execução. Para começar o logging:
  1. Configure os parâmetros na seção query_views_log.
  2. Defina log_query_views como 1.
O período de flush dos dados é definido pelo parâmetro flush_interval_milliseconds na seção de configurações do servidor query_views_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_views_log. É seguro truncar ou remover essa tabela a qualquer momento.

Colunas

  • hostname (LowCardinality(String)) — Hostname do servidor que executa a consulta.
  • clickhouse_version (LowCardinality(String)) — Versão do servidor ClickHouse que produziu a linha.
  • system_processor (LowCardinality(String)) — Arquitetura de CPU do servidor ClickHouse que produziu a linha.
  • event_date (Date) — A data em que ocorreu o último evento da VIEW.
  • event_time (DateTime) — A data e a hora em que a VIEW terminou a execução.
  • event_time_microseconds (DateTime64(6)) — A data e a hora em que a VIEW terminou a execução, com precisão de microssegundos.
  • view_duration_ms (UInt64) — Duração da execução da VIEW (soma de seus estágios), em milissegundos.
  • initial_query_id (String) — ID da consulta inicial na mesma cadeia de consultas.
  • view_name (String) — Nome da VIEW.
  • view_uuid (UUID) — UUID da VIEW.
  • view_type (Enum8(‘Default’ = 1, ‘Materialized’ = 2, ‘Live’ = 3, ‘Window’ = 4)) — Tipo da VIEW. Valores: ‘Default’ = 1 — VIEWs padrão. Não deve aparecer neste log, ‘Materialized’ = 2 — VIEWs materializadas, ‘Live’ = 3 — visualizações em tempo real.
  • view_query (String) — A consulta executada pela VIEW.
  • view_target (String) — O nome da tabela de destino da VIEW.
  • read_rows (UInt64) — Número de linhas lidas.
  • read_bytes (UInt64) — Número de bytes lidos.
  • written_rows (UInt64) — Número de linhas gravadas.
  • written_bytes (UInt64) — Número de bytes gravados.
  • peak_memory_usage (Int64) — A diferença máxima entre a quantidade de memória alocada e liberada no contexto desta VIEW.
  • ProfileEvents (Map(LowCardinality(String), UInt64)) — ProfileEvents que medem diferentes métricas. Sua descrição pode ser encontrada na tabela system.events.
  • status (Enum8(‘QueryStart’ = 1, ‘QueryFinish’ = 2, ‘ExceptionBeforeStart’ = 3, ‘ExceptionWhileProcessing’ = 4)) — Status da VIEW. Valores: ‘QueryStart’ = 1 — Início bem-sucedido da execução da VIEW. Não deve aparecer, ‘QueryFinish’ = 2 — Término bem-sucedido da execução da VIEW, ‘ExceptionBeforeStart’ = 3 — Exceção antes do início da execução da VIEW., ‘ExceptionWhileProcessing’ = 4 — Exceção durante a execução da VIEW.
  • exception_code (Int32) — Código da exceção.
  • exception (String) — Mensagem da exceção.
  • stack_trace (String) — Stack trace. Uma string vazia, se a consulta tiver sido concluída com sucesso.
Aliases:
  • ProfileEvents.Names — Alias para mapKeys(ProfileEvents).
  • ProfileEvents.Values — Alias para mapValues(ProfileEvents).

Exemplo

Query
Response

Veja também

  • system.query_log — Descrição da tabela de sistema query_log, que contém informações gerais sobre a execução de consultas.
  • system.query_thread_log — Esta tabela contém informações sobre cada thread de execução de consulta.
Última modificação em 26 de setembro de 2026