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.

map_buckets_coefficient

O coeficiente usado nas estratégias sqrt e linear de map_buckets_strategy para calcular o número de buckets com base no tamanho médio do map. Para a estratégia sqrt: round(map_buckets_coefficient * sqrt(avg_map_size)). Para a estratégia linear: round(map_buckets_coefficient * avg_map_size). Ignorado quando map_buckets_strategy é constant.

map_buckets_min_avg_size

O tamanho médio mínimo do map (número de chaves por linha) necessário para aplicar a serialização with_buckets. Se o tamanho médio do map for menor que esse valor, será usado um único bucket, independentemente de outras configurações de bucket. Um valor de 0 desabilita o limite e sempre aplica a estratégia de uso de buckets. Essa configuração é útil para evitar a sobrecarga da serialização em buckets em maps pequenos, nos quais o benefício é insignificante.

map_buckets_strategy

Controla a estratégia de seleção do número de buckets na serialização with_buckets de Map com base no tamanho médio do map. Valores possíveis:
  • constant — Sempre usa max_buckets_in_map como número de buckets, independentemente do tamanho médio do map.
  • sqrt — Usa round(map_buckets_coefficient * sqrt(avg_map_size)) como número de buckets, limitado ao intervalo [1, max_buckets_in_map].
  • linear — Usa round(map_buckets_coefficient * avg_map_size) como número de buckets, limitado ao intervalo [1, max_buckets_in_map].
Última modificação em 23 de julho de 2026