Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão de query_cache_*

Estas configurações estão disponíveis em system.settings e são geradas automaticamente a partir do código-fonte.

query_cache_compress_entries

Tipo
Bool
Padrão
1

Comprime as entradas no cache de consultas. Reduz o consumo de memória do cache de consultas, mas torna mais lentas as inserções nele e as leituras a partir dele.

Valores possíveis:

  • 0 - Desabilitado
  • 1 - Habilitado

query_cache_for_subqueries

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.50Nova configuração para habilitar a propagação de `use_query_cache` para todas as subconsultas. Sem ela, as subconsultas só são armazenadas em cache mediante ativação explícita em cada subconsulta com `SETTINGS use_query_cache = true`.

Se ativado, os resultados das subconsultas podem ser gravados no cache de consultas e lidos dele. Isso habilita a propagação de use_query_cache para todas as subconsultas.

Valores possíveis:

  • 0 - Desabilitado
  • 1 - Habilitado

query_cache_max_entries

Tipo
UInt64
Padrão
0

O número máximo de resultados de consulta que o usuário atual pode armazenar no cache de consultas. 0 significa ilimitado.

Valores possíveis:

  • Número inteiro maior ou igual a 0.

query_cache_max_size_in_bytes

Tipo
UInt64
Padrão
0

A quantidade máxima de memória (em bytes) que o usuário atual pode alocar no cache de consultas. 0 significa sem limite.

Valores possíveis:

  • Número inteiro positivo >= 0.

query_cache_min_query_duration

Tipo
Milliseconds
Padrão
0

Duração mínima, em milissegundos, pela qual uma consulta precisa ser executada para que seu resultado seja armazenado no cache de consultas.

Valores possíveis:

  • Inteiro >= 0.

query_cache_min_query_runs

Tipo
UInt64
Padrão
0

Número mínimo de vezes que uma consulta SELECT deve ser executada antes que seu resultado seja armazenado no cache de consultas.

Valores possíveis:

  • Número inteiro positivo >= 0.

query_cache_nondeterministic_function_handling

Tipo
QueryResultCacheNondeterministicFunctionHandling
Padrão
throw

Controla como o cache de consultas lida com consultas SELECT que usam funções não determinísticas, como rand() ou now().

Valores possíveis:

  • 'throw' - Lança uma exceção e não armazena o resultado da consulta em cache.
  • 'save' - Armazena o resultado da consulta em cache.
  • 'ignore' - Não armazena o resultado da consulta em cache e não lança exceção.

query_cache_share_between_users

Tipo
Bool
Padrão
0

Se ativada, o resultado de consultas SELECT armazenado no cache de consultas pode ser lido por outros usuários. Não é recomendável habilitar essa configuração por motivos de segurança.

Valores possíveis:

  • 0 - Desabilitado
  • 1 - Habilitado

query_cache_squash_partial_results

Tipo
Bool
Padrão
1

Compacta blocos de resultados parciais em blocos do tamanho de max_block_size. Reduz o desempenho da inserção no cache de consultas, mas melhora a capacidade de compressão das entradas de cache (consulte query_cache_compress-entries).

Valores possíveis:

  • 0 - Desabilitado
  • 1 - Habilitado

query_cache_system_table_handling

Tipo
QueryResultCacheSystemTableHandling
Padrão
throw
Histórico de versões
VersãoValor padrãoComentário
24.4throwO cache de consultas não armazena mais em cache os resultados de consultas feitas em tabelas do sistema

Controla como o cache de consultas lida com consultas SELECT em tabelas do sistema, ou seja, tabelas nos bancos de dados system.* e information_schema.*.

Valores possíveis:

  • 'throw' - Lança uma exceção e não armazena em cache o resultado da consulta.
  • 'save' - Armazena em cache o resultado da consulta.
  • 'ignore' - Não armazena em cache o resultado da consulta e não lança uma exceção.

query_cache_tag

Histórico de versões
VersãoValor padrãoComentário
24.8Nova configuração para rotular as configurações do cache de consultas.

Uma string que funciona como rótulo para entradas do cache de consultas. As mesmas consultas com tags diferentes são consideradas distintas pelo cache de consultas.

Valores possíveis:

  • Qualquer string

query_cache_ttl

Tipo
Seconds
Padrão
60

Após esse intervalo em segundos, as entradas no cache de consultas ficam obsoletas.

Valores possíveis:

  • Inteiro positivo >= 0.
Navigation