Skip to main content
Estas opciones de configuración están disponibles en system.settings y se generan automáticamente a partir del código fuente.

merge_tree_coarse_index_granularity

Al buscar datos, ClickHouse comprueba las marcas de datos en el archivo de índice. Si ClickHouse detecta que las claves requeridas están dentro de un rango, divide ese rango en merge_tree_coarse_index_granularity subrangos y busca allí las claves requeridas de forma recursiva. Valores posibles:
  • Cualquier entero par positivo.

merge_tree_compact_parts_min_granules_to_multibuffer_read

Solo tiene efecto en ClickHouse Cloud. Número de gránulos en la stripe de una parte compacta de tablas MergeTree necesario para usar el lector multibúfer, que admite lectura en paralelo y prefetch. En caso de lectura desde remote fs, el uso del lector multibúfer incrementa el número de solicitudes de lectura. Una parte se lee con un solo búfer cuando contiene menos gránulos que este umbral y menos gránulos que el número de columnas que se están leyendo, porque en ese caso el lector de un solo búfer emite menos solicitudes de lectura que el lector multibúfer.

merge_tree_determine_task_size_by_prewhere_columns

Indica si se debe usar solo el tamaño de las columnas prewhere para determinar el tamaño de la tarea de lectura.

merge_tree_generic_exclusion_search_max_steps

Cuando un filtro no puede evaluarse como un único rango continuo de la clave primaria, por ejemplo, cuando usa columnas clave distintas de la primera, ClickHouse ejecuta un algoritmo iterativo de búsqueda de exclusión genérica sobre las marcas del índice. El mismo algoritmo se usa para el análisis del índice de texto. Esta configuración limita el número de pasos (comprobaciones del índice) que el algoritmo emplea en cada parte de datos. El presupuesto se consume primero en los rangos de marcas restantes más grandes. Cuando se agota, los rangos que no se analizaron por completo se aceptan en su conjunto, por lo que la consulta sigue siendo correcta, pero puede leer más gránulos de los que seleccionaría una búsqueda sin límite. Un presupuesto menor acelera el análisis del índice a costa de leer más datos. El límite es aproximado, en lugar de ser un tope estricto del coste del análisis: la búsqueda puede superarlo en aproximadamente una ronda de división y, cuando la parte ya está dividida en muchos rangos (por ejemplo, por la caché de condiciones de consulta), cada uno de ellos se comprueba al menos una vez independientemente del límite. El número de pasos que realizó la búsqueda en cada parte de datos se informa en los mensajes de registro de nivel trace de la consulta, y los eventos de perfil IndexGenericExclusionSearchStepLimitReached y TextIndexGenericExclusionSearchStepLimitReached cuentan cuántas veces se agotó el presupuesto. El valor 0 (predeterminado) significa pasos ilimitados. Valores posibles:
  • 0 para pasos ilimitados, o cualquier entero positivo.

merge_tree_max_bytes_to_use_cache

Si ClickHouse debe leer más de merge_tree_max_bytes_to_use_cache bytes en una consulta, no utiliza la caché de bloques sin comprimir. La caché de bloques sin comprimir almacena los datos extraídos para las consultas. ClickHouse utiliza esta caché para acelerar las respuestas a consultas pequeñas repetidas. Esta configuración evita que las consultas que leen grandes cantidades de datos degraden la caché. La configuración del servidor uncompressed_cache_size define el tamaño de la caché de bloques sin comprimir. Valores posibles:
  • Cualquier entero positivo.

merge_tree_max_rows_to_use_cache

Si ClickHouse tiene que leer más de merge_tree_max_rows_to_use_cache filas en una consulta, no utiliza la caché de bloques sin comprimir. La caché de bloques sin comprimir almacena los datos extraídos para las consultas. ClickHouse utiliza esta caché para acelerar las respuestas a consultas pequeñas repetidas. Esta configuración evita que consultas que leen grandes cantidades de datos desplacen el contenido de la caché. La configuración del servidor uncompressed_cache_size define el tamaño de la caché de bloques sin comprimir. Valores posibles:
  • Cualquier entero positivo.

merge_tree_min_bytes_for_concurrent_read

Si el número de bytes que se va a leer de un archivo de una tabla con motor MergeTree supera merge_tree_min_bytes_for_concurrent_read, ClickHouse intenta leer ese archivo de forma concurrente en varios hilos. Valor posible:
  • Entero positivo.

merge_tree_min_bytes_for_concurrent_read_for_remote_filesystem

La cantidad mínima de bytes que deben leerse de un archivo para que el motor MergeTree pueda paralelizar la lectura al leer desde un sistema de archivos remoto. No recomendamos usar esta configuración. Valores posibles:
  • Entero positivo.

merge_tree_min_bytes_for_seek

Si la distancia entre dos bloques de datos que deben leerse de un archivo es menor que merge_tree_min_bytes_for_seek bytes, ClickHouse lee secuencialmente un rango del archivo que contiene ambos bloques, lo que evita un seek adicional. Valores posibles:
  • Cualquier entero positivo.

merge_tree_min_bytes_per_task_for_remote_reading

Alias: filesystem_prefetch_min_bytes_for_single_read_task Número mínimo de bytes que se deben leer por tarea.

merge_tree_min_read_task_size

Límite inferior estricto del tamaño de la tarea (incluso cuando el número de gránulos es bajo y el número de hilos disponibles es alto, no asignaremos tareas más pequeñas

merge_tree_min_rows_for_concurrent_read

Si el número de filas que se deben leer de un archivo de una tabla MergeTree supera merge_tree_min_rows_for_concurrent_read, ClickHouse intenta realizar la lectura concurrente de este archivo en varios hilos. Valores posibles:
  • Entero positivo.

merge_tree_min_rows_for_concurrent_read_for_remote_filesystem

El número mínimo de filas que se deben leer de un archivo para que el motor MergeTree pueda paralelizar la lectura al leer desde un sistema de archivos remoto. No recomendamos usar esta configuración. Valores posibles:
  • Entero positivo.

merge_tree_min_rows_for_seek

Si la distancia entre dos bloques de datos que se van a leer en un archivo es inferior a merge_tree_min_rows_for_seek filas, ClickHouse no reposiciona la lectura dentro del archivo, sino que lee los datos de forma secuencial. Valores posibles:
  • Cualquier entero positivo.

merge_tree_read_split_ranges_into_intersecting_and_non_intersecting_injection_probability

Para probar PartsSplitter: divide los rangos de lectura en rangos que se intersecan y rangos que no se intersecan cada vez que se lee desde MergeTree con la probabilidad especificada.

merge_tree_storage_snapshot_sleep_ms

Introduce un retraso artificial (en milisegundos) al crear una instantánea de almacenamiento para tablas MergeTree. Se usa solo con fines de prueba y depuración. Valores posibles:
  • 0 - Sin retraso (predeterminado)
  • N - Retraso en milisegundos

merge_tree_use_const_size_tasks_for_remote_reading

Si se deben usar tareas de tamaño constante para leer desde una tabla remota.

merge_tree_use_deserialization_prefixes_cache

Activa el almacenamiento en caché de los metadatos de las columnas procedentes de los prefijos de archivo durante la lectura desde discos remotos en MergeTree.

merge_tree_use_prefixes_deserialization_thread_pool

Habilita el uso del pool de hilos para la lectura paralela de prefijos en las partes wide de MergeTree. El tamaño de ese pool de hilos se controla mediante la configuración del servidor max_prefixes_deserialization_thread_pool_size.

merge_tree_use_v1_object_and_dynamic_serialization

Cuando está habilitada, MergeTree usará la versión de serialización V1 de los tipos JSON y Dynamic en lugar de V2. Cambiar esta configuración solo surte efecto tras reiniciar el servidor.
Última modificación el 24 de julio de 2026