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

max_avg_part_size_for_too_many_parts

A verificação de ‘partes em excesso’, de acordo com ‘parts_to_delay_insert’ e ‘parts_to_throw_insert’, ficará ativa somente se o tamanho médio da parte (na partição em questão) não for maior que o limiar especificado. Se ele for maior que o limiar especificado, os INSERTs não serão nem atrasados nem rejeitados. Isso permite ter centenas de terabytes em uma única tabela em um único servidor se as partes forem mescladas com sucesso em partes maiores. Isso não afeta os limiares de partes inativas nem o total de partes.

max_buckets_in_map

O número máximo de buckets para a serialização de Map. Funciona com a serialização with_buckets de Map. O número efetivo de buckets é determinado por map_buckets_strategy. O valor máximo permitido é 256.

max_cleanup_delay_period

Período máximo para limpar logs antigos da fila, hashes de blocos e partes.

max_compress_block_size

O tamanho máximo dos blocos de dados não comprimidos antes da compressão para gravação em uma tabela. Você também pode especificar essa configuração nas configurações globais (consulte a configuração max_compress_block_size). O valor especificado quando a tabela é criada substitui o valor global dessa configuração.

max_concurrent_queries

Número máximo de consultas executadas simultaneamente relacionadas à tabela MergeTree. As consultas ainda estarão sujeitas a outras configurações de max_concurrent_queries. Valores possíveis:
  • Inteiro positivo.
  • 0 — Sem limite.
Valor padrão: 0 (sem limite). Exemplo

max_digestion_size_per_segment

Configuração obsoleta, não faz nada.

max_file_name_length

O comprimento máximo do nome do arquivo para mantê-lo como está, sem aplicar hash. Só tem efeito se a configuração replace_long_file_name_to_hash estiver habilitada. O valor desta configuração não inclui o comprimento da extensão do arquivo. Portanto, recomenda-se defini-la abaixo do comprimento máximo do nome do arquivo (geralmente 255 bytes), com alguma folga para evitar erros no filesystem.

max_partitions_to_read

Limita o número máximo de partições que podem ser acessadas em uma consulta. O valor da configuração especificado quando a tabela é criada pode ser substituído por uma configuração no nível da consulta. Valores possíveis:
  • Qualquer número inteiro positivo.
Você também pode especificar uma configuração de complexidade da consulta max_partitions_to_read no nível de consulta / sessão / perfil.

max_projections

Número máximo de projeções de MergeTree.

max_table_size_bytes_compressed

Se o número total de bytes comprimidos (o tamanho em disco) de todas as partes de dados ativas e inativas da tabela exceder esse valor, um INSERT será interrompido com a exceção Table size limit exceeded. As partes inativas também são contabilizadas porque o objetivo dessa configuração é limitar o uso de disco. Observe que as partes inativas são removidas em segundo plano (consulte a configuração old_parts_lifetime), portanto, o tamanho observado pode diminuir ao longo do tempo. O limite é verificado no início do INSERT e quando novas partes de dados são confirmadas no conjunto de trabalho, incluindo os resultados de merges em segundo plano e mutações. Inserts realizados por visões materializadas também são verificados. O limite não é verificado durante fetches replicados, o que permite uma condição de corrida quando inserts paralelos em várias réplicas ultrapassam o limite. A confirmação de partes de dados vazias é sempre permitida, portanto, os dados podem ser removidos de uma tabela que excede o limite, por exemplo, com TRUNCATE ou ALTER TABLE ... DROP PARTITION. Valores possíveis:
  • Qualquer inteiro positivo.
  • 0 — ilimitado.
É útil para serviços multilocatários, temporários e de demonstração.

max_table_size_bytes_uncompressed

O mesmo que max_table_size_bytes_compressed, mas o limite se aplica ao número total de bytes não comprimidos em todas as partes de dados ativas e inativas da tabela. Valores possíveis:
  • Qualquer inteiro positivo.
  • 0 — ilimitado.
É útil para serviços multilocatários, temporários e de demonstração.

max_table_size_rows

Se o número total de linhas nas partes de dados ativas da tabela exceder este valor, um INSERT será interrompido com a exceção Table size limit exceeded. O limite é verificado no início do INSERT e quando novas partes de dados são incorporadas ao conjunto de trabalho, incluindo os resultados de merges e mutações em segundo plano (portanto, uma mutação que aumente o tamanho da tabela além do limite será repetida sem ser concluída). Os inserts realizados por visões materializadas também são verificados. O limite não é verificado durante fetch replicado, o que permite uma condição de corrida quando inserts paralelos em várias réplicas ultrapassam o limite. A incorporação de partes de dados vazias é sempre permitida, portanto é possível remover dados de uma tabela que excede o limite, por exemplo, com TRUNCATE ou ALTER TABLE ... DROP PARTITION. Valores possíveis:
  • Qualquer inteiro positivo.
  • 0 — ilimitado.
É útil para serviços multilocatários, temporários e de demonstração.

max_uncompressed_bytes_in_patches

O tamanho máximo não comprimido dos dados em todas as partes de patch, em bytes. Se a quantidade de dados em todas as partes de patch exceder esse valor, as atualizações leves serão rejeitadas. 0 - ilimitado.
Última modificação em 26 de setembro de 2026