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

max_analyze_depth

Número máximo de análises executadas pelo interpretador.

max_autoincrement_series

O limite para o número de séries criadas pela função generateSerialID. Como cada série representa um nó no Keeper, recomenda-se não ter mais do que alguns milhões delas.

max_backup_bandwidth

A velocidade máxima de leitura, em bytes por segundo, de um backup específico no servidor. Zero significa sem limite.

max_block_size

No ClickHouse, os dados são processados em blocos, que são conjuntos de partes de colunas. Os ciclos internos de processamento de um único bloco são eficientes, mas há custos perceptíveis ao processar cada bloco. A configuração max_block_size indica o número máximo recomendado de linhas a incluir em um único bloco ao carregar dados de tabelas. Blocos do tamanho de max_block_size nem sempre são carregados da tabela: se o ClickHouse determinar que menos dados precisam ser recuperados, um bloco menor será processado. O tamanho do bloco não deve ser muito pequeno, para evitar custos perceptíveis ao processar cada bloco. Ele também não deve ser muito grande, para garantir que consultas com uma cláusula LIMIT sejam executadas rapidamente após o processamento do primeiro bloco. Ao definir max_block_size, o objetivo deve ser evitar consumir memória demais ao extrair um grande número de colunas em múltiplas threads e preservar pelo menos alguma localidade de cache.

max_columns_to_read

O número máximo de colunas que podem ser lidas de uma tabela em uma única consulta. Se uma consulta exigir a leitura de mais colunas do que o número especificado, uma exceção será lançada.
Essa configuração é útil para evitar consultas complexas demais.
O valor 0 significa sem limite.

max_compress_block_size

O tamanho máximo dos blocos de dados não comprimidos antes de serem comprimidos para gravação em uma tabela. Por padrão, 1.048.576 (1 MiB). Especificar um tamanho de bloco menor geralmente resulta em uma taxa de compressão ligeiramente menor; a velocidade de compressão e descompressão aumenta um pouco devido à melhor localidade de cache, e o consumo de memória é reduzido.
Esta é uma configuração para especialistas, e você não deve alterá-la se estiver apenas começando a usar o ClickHouse.
Não confunda blocos usados para compressão (um bloco de memória composto por bytes) com blocos usados no processamento de consultas (um conjunto de linhas de uma tabela).

max_consume_snapshots

Número máximo de snapshots do Paimon consumidos por leitura incremental. 0 significa sem limite.

max_estimated_execution_time

Tempo máximo estimado de execução da consulta, em segundos. É verificado em cada bloco de dados quando timeout_before_checking_execution_speed expira.

max_expanded_ast_elements

Tamanho máximo da árvore de sintaxe da consulta, em número de nós, após a expansão de aliases e do asterisco.

max_fetch_partition_retries_count

Número de tentativas ao buscar uma partição de outro host.

max_final_threads

Define o número máximo de threads paralelas para a fase de leitura de dados da consulta SELECT com o modificador FINAL. Valores possíveis:
  • Inteiro positivo.
  • 0 ou 1 — desativado. As consultas SELECT são executadas em uma única thread.

max_http_get_redirects

Número máximo de saltos de redirecionamento HTTP GET permitidos. Garante medidas adicionais de segurança para impedir que um servidor malicioso redirecione suas requisições para serviços inesperados.\n\nIsso acontece quando um servidor externo redireciona para outro endereço, mas esse endereço parece ser interno à infraestrutura da empresa e, ao enviar uma requisição HTTP para um servidor interno, você poderia acessar uma API interna pela rede interna, contornando a autenticação, ou até mesmo consultar outros serviços, como Redis ou Memcached. Quando você não tem uma infraestrutura interna (incluindo algo em execução no seu localhost) ou confia no servidor, é seguro permitir redirecionamentos. No entanto, tenha em mente que, se a URL usar HTTP em vez de HTTPS, você terá de confiar não apenas no servidor remoto, mas também no seu provedor de internet e em todas as redes intermediárias. Valor padrão no Cloud: 10.

max_limit_for_vector_search_queries

Consultas SELECT com LIMIT maior que esta configuração não podem usar índices de similaridade vetorial. Isso ajuda a evitar estouros de memória nesses índices.

max_number_of_partitions_for_independent_aggregation

Número máximo de partições em uma tabela para aplicar a otimizaçã

max_os_cpu_wait_time_ratio_to_throw

Razão máxima entre os tempos de espera da CPU do SO (métrica OSCPUWaitMicroseconds) e de atividade (métrica OSCPUVirtualTimeMicroseconds) para considerar a rejeição de consultas. A interpolação linear entre a razão mínima e a máxima é usada para calcular a probabilidade; nesse ponto, a probabilidade é 1.

max_parallel_replicas

O número máximo de réplicas para cada shard ao executar uma consulta. Valores possíveis:
  • Inteiro positivo.
Informações adicionais Esta opção pode produzir resultados diferentes, dependendo das configurações usadas.

Processamento em paralelo usando a chave SAMPLE

Uma consulta pode ser processada mais rapidamente se for executada em vários servidores em paralelo. Mas o desempenho da consulta pode piorar nos seguintes casos:
  • A posição da chave de amostragem na chave de particionamento não permite leituras por intervalo eficientes.
  • Adicionar uma chave de amostragem à tabela torna menos eficiente a filtragem por outras colunas.
  • A chave de amostragem é uma expressão com cálculo custoso.
  • A distribuição de latência do cluster tem uma cauda longa, de modo que consultar mais servidores aumenta a latência geral da consulta.

Processamento em paralelo com parallel_replicas_custom_key

Essa configuração é útil para qualquer tabela replicada.

max_parsing_threads

O número máximo de threads para fazer o parsing de dados em formatos de entrada com suporte a parsing em paralelo. Por padrão, ele é determinado automaticamente.

max_partition_size_to_drop

Restrição para remover partições em tempo de consulta. O valor 0 significa que é possível remover partições sem nenhuma restrição. Valor padrão no Cloud: 1 TB.
Essa configuração de consulta substitui a configuração equivalente no servidor; consulte max_partition_size_to_drop

max_parts_to_move

Limita o número de partes que podem ser movidas em uma única consulta. Zero significa sem limite.

max_projection_rows_to_use_projection_index

Se o número de linhas a serem lidas do índice de projeção for menor ou igual a esse limite, o ClickHouse tentará usar o índice de projeção durante a execução da consulta.

max_query_size

O número máximo de bytes de uma string de consulta analisada pelo parser SQL. Os dados na cláusula VALUES de consultas INSERT são processados por um parser de fluxo separado (que consome O(1) de RAM) e não são afetados por essa restrição.
max_query_size não pode ser definido em uma consulta SQL (por exemplo, SELECT now() SETTINGS max_query_size=10000) porque o ClickHouse precisa alocar um buffer para analisar a consulta, e o tamanho desse buffer é determinado pela configuração max_query_size, que deve ser definida antes da execução da consulta.

max_recursive_cte_evaluation_depth

Profundidade máxima de avaliação de CTEs recursivas

max_replica_delay_for_distributed_queries

Desabilita réplicas defasadas para consultas distribuídas. Consulte Replication. Define o tempo em segundos. Se a defasagem de uma réplica for maior ou igual ao valor definido, essa réplica não será usada. Valores possíveis:
  • Inteiro positivo.
  • 0 — A defasagem das réplicas não é verificada.
Para impedir o uso de qualquer réplica com defasagem diferente de zero, defina este parâmetro como 1. Usado ao executar SELECT em uma tabela distribuída que aponta para tabelas replicadas.

max_reverse_dictionary_lookup_cache_size_bytes

Tamanho máximo, em bytes, do cache por consulta para lookup reverso em Dicionário usado pela função dictGetKeys. O cache armazena tuplas de chave serializadas por valor de atributo para evitar percorrer novamente o dicionário na mesma consulta. Quando o limite é atingido, as entradas são removidas usando LRU. Defina como 0 para desativar o cache.

max_sessions_for_user

Número máximo de sessões simultâneas por usuário autenticado no servidor ClickHouse. Exemplo:
Valores possíveis:
  • Inteiro positivo
  • 0 - número infinito de sessões simultâneas (padrão)

max_subquery_depth

Se uma consulta tiver mais do que o número especificado de subconsultas aninhadas, uma exceção será lançada.
Isso permite fazer uma verificação de segurança para evitar que os usuários do seu cluster escrevam consultas excessivamente complexas.

max_table_size_to_drop

Restrição à exclusão de tabelas durante a execução da consulta. O valor 0 significa que é possível excluir todas as tabelas sem nenhuma restrição. Valor padrão no Cloud: 1 TB.
Esta configuração de consulta substitui a configuração equivalente do servidor; consulte max_table_size_to_drop

max_untracked_memory

Pequenas alocações e desalocações são agrupadas em uma variável local da thread e rastreadas ou perfiladas apenas quando a quantidade (em valor absoluto) se torna maior que o valor especificado. Se o valor for maior que ‘memory_profiler_step’, ele será efetivamente reduzido para ‘memory_profiler_step’.

max_wkb_geometry_elements

Número máximo de pontos, anéis ou polígonos permitidos em um único elemento de geometria WKB durante o parsing por readWKB e funções relacionadas. Isso protege contra alocações excessivas de memória causadas por dados WKB malformados. Defina como 0 para usar o limite fixo no código (100 milhões).
Última modificação em 24 de julho de 2026