Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Configuración de tabla de MergeTree para map_buckets_*

Estas opciones de configuración están disponibles en system.merge_tree_settings y se generan automáticamente a partir del código fuente de ClickHouse.

map_buckets_coefficient

Tipo
Float
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
26.31Añade una configuración para controlar el coeficiente utilizado en la estrategia `sqrt` y `linear` para calcular el número de buckets de la serialización Map 'with_buckets'

El coeficiente utilizado en map_buckets_strategy sqrt y linear para calcular el número de buckets a partir del tamaño medio del Map. Para la estrategia sqrt: round(map_buckets_coefficient * sqrt(avg_map_size)). Para la estrategia linear: round(map_buckets_coefficient * avg_map_size). Se ignora cuando map_buckets_strategy es constant.

map_buckets_min_avg_size

Tipo
UInt64
Predeterminado
32
Historial de versiones
VersiónValor predeterminadoComentario
26.332Se añade una configuración para controlar el tamaño medio mínimo de Map (número de claves por fila) necesario para aplicar la serialización `with_buckets`

El tamaño medio mínimo de Map (número de claves por fila) necesario para aplicar la serialización with_buckets. Si el tamaño medio de Map es inferior a este valor, se usa un solo bucket independientemente del resto de la configuración de buckets. Un valor de 0 desactiva el umbral y siempre aplica la estrategia de uso de buckets. Esta configuración es útil para evitar la sobrecarga de la serialización en buckets en valores Map pequeños, donde el beneficio es insignificante.

map_buckets_strategy

Tipo
MergeTreeMapBucketsStrategy
Predeterminado
sqrt
Historial de versiones
VersiónValor predeterminadoComentario
26.3sqrtSe añadió una configuración para controlar la estrategia de selección del número de buckets para la serialización `with_buckets` de Map

Controla la estrategia para seleccionar el número de buckets en la serialización with_buckets de Map en función del tamaño promedio del Map.

Posibles valores:

  • constant — Usa siempre max_buckets_in_map como número de buckets, independientemente del tamaño promedio del Map.
  • sqrt — Usa round(map_buckets_coefficient * sqrt(avg_map_size)) como número de buckets, limitado al intervalo [1, max_buckets_in_map].
  • linear — Usa round(map_buckets_coefficient * avg_map_size) como número de buckets, limitado al intervalo [1, max_buckets_in_map].
Navigation