> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# configurações de sessão max_*
> Configurações de sessão do ClickHouse no grupo gerado max_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Tipo
{type}
Padrão
{default_value}
{changeable_without_restart &&
Pode ser alterado sem reiniciar
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
export const ExperimentalBadge = () => {
return ;
};
Essas configurações estão disponíveis em [system.settings](/docs/pt-BR/reference/system-tables/settings) e são geradas automaticamente a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## 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`](/docs/pt-BR/reference/settings/session-settings/other#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](/docs/pt-BR/reference/statements/select/from#final-modifier).
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](/docs/pt-BR/reference/settings/session-settings/parallel-replicas#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](/docs/pt-BR/reference/settings/server-settings/settings#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](/docs/pt-BR/reference/engines/table-engines/mergetree-family/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:
```xml theme={null}
1
2
0
single_session_user
two_sessions_profile
unlimited_sessions_profile
```
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](/docs/pt-BR/reference/settings/server-settings/settings#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).