Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de tabela do MergeTree map_buckets_*

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

Tipo
Float
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.31Adicionar uma configuração para controlar o coeficiente usado nas estratégias `sqrt` e `linear` para calcular o número de buckets da serialização `with_buckets` de Map

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

Tipo
UInt64
Padrão
32
Histórico de versões
VersãoValor padrãoComentário
26.332Adiciona uma configuração para controlar o tamanho médio mínimo do map (número de chaves por linha) necessário para aplicar a serialização `with_buckets`

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

Tipo
MergeTreeMapBucketsStrategy
Padrão
sqrt
Histórico de versões
VersãoValor padrãoComentário
26.3sqrtAdiciona uma configuração para controlar a estratégia de seleção do número de buckets para a serialização `with_buckets` de `Map`

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].
Navigation