Skip to main content
Estas configurações definem o servidor ClickHouse e são geradas automaticamente a partir do código-fonte do ClickHouse.

​
max_active_parts_loading_thread_pool_size

O número de threads para carregar o conjunto ativo de partes de dados (as ativas) na inicialização.

​
max_authentication_methods_per_user

O número máximo de métodos de autenticação com que um usuário pode ser criado ou alterado. Alterar essa configuração não afeta os usuários existentes. As consultas create/alter relacionadas à autenticação falharão se excederem o limite especificado nesta configuração. As consultas create/alter não relacionadas à autenticação serão bem-sucedidas.
Um valor de 0 significa ilimitado.

​
max_backup_bandwidth_for_server

A velocidade máxima de leitura, em bytes por segundo, de todos os backups no servidor. Zero significa sem limite.

​
max_build_vector_similarity_index_thread_pool_size

O número máximo de threads a serem usadas na criação de índices vetoriais de similaridade.
Um valor de 0 significa usar todos os núcleos.

​
max_connections

Número máximo de conexões do servidor.

​
max_entries_for_hash_table_stats

Quantas entradas as estatísticas da tabela hash coletadas durante a agregação podem ter

​
max_fetch_partition_thread_pool_size

O número de threads usadas por ALTER TABLE FETCH PARTITION.

​
max_held_snapshots

Número máximo de snapshots leves que podem ser mantidos ao mesmo tempo. Zero significa ilimitado. Se o número de snapshots atingir esse limite, uma exceção será lançada ao tentar criar um novo snapshot.

​
max_http_index_page_size

Tamanho máximo da resposta de uma página de índice HTTP usada para listar diretórios via HTTP. Se a resposta exceder esse limite, a consulta falhará com um erro. Padrão: 10485760 (10 MiB).

​
max_keep_alive_requests

Número máximo de solicitações por uma única conexão keep-alive até que ela seja fechada pelo servidor ClickHouse. Exemplo

​
max_materialized_views_count_for_table

Um limite para o número de visões materializadas vinculadas a uma tabela.
Apenas visões diretamente dependentes são consideradas aqui, e a criação de uma visão sobre outra não é levada em conta.

​
max_merges_bandwidth_for_server

A velocidade máxima de leitura de todas as operações de merge no servidor, em bytes por segundo. Zero significa sem limite.

​
max_mutations_bandwidth_for_server

A velocidade máxima de leitura de todas as mutações no servidor, em bytes por segundo. Zero significa sem limite.

​
max_open_files

O número máximo de arquivos abertos.
Recomendamos usar esta opção no macOS, pois a função getrlimit() retorna um valor incorreto.

​
max_os_cpu_wait_time_ratio_to_drop_connection

Razão máxima entre os tempos de espera da CPU do SO (métrica OSCPUWaitMicroseconds) e de atividade (métrica OSCPUVirtualTimeMicroseconds) para considerar encerrar conexões. A interpolação linear entre a razão mínima e a máxima é usada para calcular a probabilidade; nesse limite, a probabilidade é 1. Consulte Controlando o comportamento em sobrecarga de CPU do servidor para mais detalhes.

​
max_outdated_parts_loading_thread_pool_size

O número de threads para carregar, na inicialização, o conjunto inativo de partes de dados (as desatualizadas).

​
max_part_num_to_warn

Se o número de partes ativas exceder o valor especificado, o servidor ClickHouse adicionará mensagens de aviso à tabela system.warnings. Exemplo

​
max_partition_size_to_drop

Restrição para a remoção de partições. Se o tamanho de uma tabela MergeTree exceder max_partition_size_to_drop (em bytes), você não poderá remover uma partição usando a instrução DROP PARTITION. Esta configuração não exige a reinicialização do servidor ClickHouse para entrar em vigor. Outra forma de desabilitar a restrição é criar o arquivo <clickhouse-path>/flags/force_drop_table.
O valor 0 significa que você pode remover partições sem nenhuma restrição.Essa limitação não restringe DROP TABLE nem TRUNCATE TABLE; consulte max_table_size_to_drop
Exemplo

​
max_parts_cleaning_thread_pool_size

O número de threads para a remoção concorrente de partes de dados inativas.

​
max_per_cpu_untracked_memory

Limite máximo, em bytes, da memória não rastreada que todas as threads em execução em uma CPU podem manter simultaneamente antes de ela ser enviada ao memory tracker. Enquanto max_untracked_memory limita uma única thread, esta configuração limita o total por CPU, para que várias threads não multipliquem sua cota por thread em um grande overcommit em todo o servidor. Portanto, a memória total não rastreada fica limitada aproximadamente a number_of_cpus * max_per_cpu_untracked_memory. Um valor de 0 desabilita o limite por CPU (aplica-se apenas o max_untracked_memory por thread). Apenas no Linux.

​
max_session_timeout

Tempo limite máximo da sessão, em segundos. Exemplo:

​
max_temporary_data_on_disk_size

A quantidade máxima de armazenamento que pode ser usada para agregação externa, junções ou ordenação. Consultas que excederem esse limite falharão com uma exceção.
Um valor de 0 significa sem limite.
Veja também:

​
max_unexpected_parts_loading_thread_pool_size

O número de threads usadas para carregar, na inicialização, o conjunto inativo de partes de dados (as inesperadas).

​
max_waiting_queries

Limite do número total de consultas em espera simultaneamente. A execução de uma consulta em espera fica bloqueada enquanto as tabelas necessárias são carregadas de forma assíncrona (consulte async_load_databases.
As consultas em espera não são contabilizadas na verificação dos limites controlados pelas seguintes configurações:Esse ajuste é feito para evitar que esses limites sejam atingidos logo após a inicialização do servidor.
Um valor de 0 (padrão) significa sem limite.Essa configuração pode ser alterada em tempo de execução e entrará em vigor imediatamente. As consultas que já estiverem em execução permanecerão inalteradas.

​
max_zookeeper_pooled_connections

Número máximo de sessões do ZooKeeper inicializadas de forma preguiçosa por cluster do ZooKeeper no pool compartilhado. Um valor de 0 desativa as conexões em pool e continua usando uma única sessão.
Última modificação em 23 de julho de 2026