Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão max_*

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

max_analyze_depth

Tipo
UInt64
Padrão
5000

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

max_autoincrement_series

Tipo
UInt64
Padrão
1000
Histórico de versões
VersãoValor padrãoComentário
25.11000Nova configuração

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

Tipo
UInt64
Padrão
0

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

max_block_size

Tipo
NonZeroUInt64
Padrão
65409

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

Tipo
UInt64
Padrão
0

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.

O valor 0 significa sem limite.

max_compress_block_size

Tipo
UInt64
Padrão
1048576

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.

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

Recurso experimental
Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.50Nova configuração.

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

max_estimated_execution_time

Tipo
Segundos
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
24.10Separados max_execution_time e 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

Tipo
UInt64
Padrão
500000

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

Tipo
UInt64
Padrão
5

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

max_final_threads

Tipo
MaxThreads
Padrão
auto(N)

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

Tipo
UInt64
Padrão
0

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

Tipo
UInt64
Padrão
1000
Histórico de versões
VersãoValor padrãoComentário
25.51000Nova configuração

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_os_cpu_wait_time_ratio_to_throw

Tipo
Float
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.50Os valores da configuração foram alterados e o backport foi aplicado à 25.4
25.40Nova configuração

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

Tipo
NonZeroUInt64
Padrão
1000
Histórico de versões
VersãoValor padrãoComentário
25.11000Usa, por padrão, até 1000 réplicas paralelas.

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

Tipo
MaxThreads
Padrão
auto(N)
Histórico de versões
VersãoValor padrãoComentário
24.40Adiciona uma configuração separada para controlar o número de threads no parsing em paralelo de arquivos

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

Tipo
UInt64
Padrão
50000000000

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.

max_parts_to_move

Tipo
UInt64
Padrão
1000
Histórico de versões
VersãoValor padrãoComentário
24.101000Nova configuração

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

Tipo
UInt64
Padrão
1000000
Histórico de versões
VersãoValor padrãoComentário
25.111000000Nova configuração

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

Tipo
UInt64
Padrão
262144

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_recursive_cte_evaluation_depth

Tipo
UInt64
Padrão
1000
Histórico de versões
VersãoValor padrãoComentário
24.41000Profundidade máxima de avaliação de CTEs recursivas

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

max_replica_delay_for_distributed_queries

Tipo
UInt64
Padrão
300

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

Tipo
UInt64
Padrão
104857600
Histórico de versões
VersãoValor padrãoComentário
25.12104857600Nova configuração. 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.

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

Tipo
UInt64
Padrão
0

Número máximo de sessões simultâneas por usuário autenticado no servidor ClickHouse.

Exemplo:

<profiles>
    <single_session_profile>
        <max_sessions_for_user>1</max_sessions_for_user>
    </single_session_profile>
    <two_sessions_profile>
        <max_sessions_for_user>2</max_sessions_for_user>
    </two_sessions_profile>
    <unlimited_sessions_profile>
        <max_sessions_for_user>0</max_sessions_for_user>
    </unlimited_sessions_profile>
</profiles>
<users>
    <!-- User Alice can connect to a ClickHouse server no more than once at a time. -->
    <Alice>
        <profile>single_session_user</profile>
    </Alice>
    <!-- User Bob can use 2 simultaneous sessions. -->
    <Bob>
        <profile>two_sessions_profile</profile>
    </Bob>
    <!-- User Charles can use arbitrarily many of simultaneous sessions. -->
    <Charles>
        <profile>unlimited_sessions_profile</profile>
    </Charles>
</users>

Valores possíveis:

  • Inteiro positivo
  • 0 - número infinito de sessões simultâneas (padrão)

max_subquery_depth

Tipo
UInt64
Padrão
100

Se uma consulta tiver mais do que o número especificado de subconsultas aninhadas, uma exceção será lançada.

max_table_size_to_drop

Tipo
UInt64
Padrão
50000000000

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.

max_untracked_memory

Tipo
UInt64
Padrão
4194304

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

Tipo
UInt64
Padrão
1000000
Histórico de versões
VersãoValor padrãoComentário
26.41000000Nova configuração para limitar a quantidade de elementos no parsing de geometrias WKB, evitando alocações excessivas de memória em dados malformados.

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

Navigation