Estas configuraciones están disponibles en system.settings y se generan automáticamente a partir del código fuente.
use_async_executor_for_materialized_views
Usa una ejecución asíncrona y, potencialmente, multihilo para la consulta de la vista materializada; puede acelerar el procesamiento de las vistas durante INSERT, pero también consumir más memoria.
use_cache_for_count_from_files
Habilita el almacenamiento en caché del número de filas al realizar conteos a partir de archivos en las funciones de tabla file/s3/url/hdfs/azureBlobStorage.
Está habilitado de forma predeterminada.
Usa la zona horaria del client para interpretar los valores de cadena DateTime, en lugar de usar la zona horaria del server.
Usa el formato compacto para almacenar bloques de INSERT en segundo plano (distributed_foreground_insert) en tablas con motor Distributed.
Valores posibles:
- 0 — Usa el formato de directorio
user[:password]@host:port#default_database.
- 1 — Usa el formato de directorio
[shard{shard_index}[_replica{replica_index}]].
- con
use_compact_format_in_distributed_parts_names=0, los cambios en la definición del clúster no se aplicarán al INSERT en segundo plano.
- con
use_compact_format_in_distributed_parts_names=1, cambiar el orden de los nodos en la definición del clúster cambiará shard_index/replica_index, así que tenlo en cuenta.
Respeta el control de concurrencia del servidor (consulta los ajustes globales del servidor concurrent_threads_soft_limit_num y concurrent_threads_soft_limit_ratio_to_cores). Si se desactiva, permite usar un mayor número de hilos incluso si el servidor está sobrecargado (no se recomienda para el uso normal y se necesita principalmente para pruebas).
use_constant_folding_in_index_analysis
Sustituye constantes a nivel de partición en el predicado de filtro al analizar, para cada parte, la clave primaria y los skip indexes.
Cuando la clave de partición aparece en el filtro junto con columnas de la clave primaria o de skip indexes, esto permite que el análisis de índices incorpore el valor de la partición por separado dentro de cada parte. Resulta especialmente útil para filtros disyuntivos cuyas ramas se dirigen a distintas particiones. Por ejemplo, con PARTITION BY a y ORDER BY b:
Para la parte de la partición a = 1, la condición se simplifica a b >= 1, mientras que para las particiones a = 2 y a = 3 se simplifica a b > 10, por lo que cada parte se analiza con el predicado que realmente se le aplica.
Valores posibles:
- 0 — Deshabilitado.
- 1 — Habilitado.
use_hash_table_stats_for_join_reordering
Habilita el uso de las estadísticas recopiladas de la tabla hash para estimar la cardinalidad durante la reordenación de joins
Habilita la lógica de hedged requests para consultas remotas. Permite establecer varias conexiones con distintas réplicas para una consulta.
Se habilita una nueva conexión si la(s) conexión(es) existente(s) con la(s) réplica(s) no se han establecido dentro de hedged_connection_timeout
o si no se han recibido datos dentro de receive_data_timeout. La consulta usa la primera conexión que envía un paquete de progreso no vacío (o un paquete de datos, si allow_changing_replica_until_first_data_packet);
las demás conexiones se cancelan. Se admiten consultas con max_parallel_replicas > 1.
Habilitado de forma predeterminada.
Valor predeterminado de Cloud: 0.
Cuando está habilitada, ClickHouse detectará el particionamiento de estilo Hive en la ruta (/name=value/) en los motores de tabla tipo archivo File/S3/URL/HDFS/AzureBlobStorage y permitirá usar las columnas de partición como columnas virtuales en la consulta. Estas columnas virtuales tendrán los mismos nombres que en la ruta particionada, pero comenzarán por _.
use_join_disjunctions_push_down
Habilita el pushdown de las partes de las condiciones de JOIN conectadas por OR a los lados de entrada correspondientes (“pushdown parcial”).
Esto permite que los motores de almacenamiento filtren antes, lo que puede reducir los datos leídos.
La optimización preserva la semántica y se aplica solo cuando cada rama OR de nivel superior aporta al menos un
predicado determinista para el lado de destino.
Cuando está habilitada, permite usar la función toTime legacy, que convierte una fecha con hora en una fecha fija determinada, conservando la hora.
De lo contrario, se usa la nueva función toTime, que convierte distintos tipos de datos al tipo Time.
La función legacy anterior también está disponible incondicionalmente como toTimeWithFixedDate.
use_lightweight_primary_key_index_analysis
Optimiza el análisis del índice de clave primaria para tablas MergeTree con claves primarias largas.
Cuando está habilitada, la duración del análisis del índice depende principalmente de la complejidad del filtro de la consulta (las columnas clave que realmente utiliza), y no de la longitud de la clave primaria; por tanto, ampliar la clave de ordenación apenas añade sobrecarga al análisis del índice en consultas que filtran solo por unas pocas de sus columnas.
Posibles valores:
- 0 — Deshabilitado. Durante el análisis del índice, se procesan todas las columnas de la clave primaria.
- 1 — Habilitado.
Si está activado, el formato Parquet puede utilizar la caché de metadatos de Parquet.
Valores posibles:
- 0 - Deshabilitado
- 1 - Habilitado
Usa la clave primaria para descartar gránulos durante la ejecución de consultas en tablas MergeTree.
Valores posibles:
- 0 — Deshabilitado.
- 1 — Habilitado.
Experimental. Enruta las lecturas a través del nuevo pipeline ReaderExecutor en lugar de la matrioshka heredada de búferes de lectura. Recurre a la ruta heredada en las configuraciones que el ejecutor aún no admite.
use_roaring_bitmap_iceberg_positional_deletes
Usa un bitmap roaring para las eliminaciones posicionales de Iceberg.
use_streaming_marks_compression
Al cargar marks para las partes de MergeTree, comprímalas en la representación en memoria un bloque cada vez (streaming), en lugar de materializar primero el array completo de marks sin comprimir. Esto reduce significativamente el uso máximo de memoria durante la carga de marks para partes compactas con muchos subflujos (p. ej., tablas con columnas JSON y write_marks_for_substreams_in_compact_parts habilitado).
use_strict_insert_block_limits
Cuando está habilitada, aplica estrictamente tanto los límites mínimos como los máximos del tamaño del bloque de inserción.
Se emite un bloque cuando:
- Umbrales mínimos (AND): Se alcanzan tanto min_insert_block_size_rows como min_insert_block_size_bytes.
- Umbrales máximos (OR): Se alcanza max_insert_block_size_rows o max_insert_block_size_bytes.
Cuando está deshabilitada, se emite un bloque cuando:
- Umbrales mínimos (OR): Se alcanza min_insert_block_size_rows o min_insert_block_size_bytes.
Nota: Si la configuración máxima es menor que la mínima, prevalecen los límites máximos y los bloques se emitirán antes de que se alcancen los umbrales mínimos.
Nota: Esta configuración se deshabilita automáticamente para las inserciones asíncronas, porque las inserciones asíncronas asocian tokens de deduplicación por entrada que son incompatibles con la división de bloques necesaria para aplicar límites estrictos.
Deshabilitada de forma predeterminada.
use_structure_from_insertion_table_in_table_functions
Usa la estructura de la tabla de inserción en lugar de inferir el esquema a partir de los datos. Valores posibles: 0 - deshabilitado, 1 - habilitado, 2 - automático
Indica si se debe usar una caché de bloques sin comprimir. Acepta 0 o 1. De forma predeterminada, 0 (deshabilitado).
Usar la caché sin comprimir (solo para tablas de la familia MergeTree) puede reducir significativamente la latencia y aumentar el rendimiento al trabajar con una gran cantidad de consultas cortas. Habilite esta configuración para los usuarios que envían solicitudes cortas con frecuencia. Preste atención también al parámetro de configuración uncompressed_cache_size (solo se establece en el archivo de configuración), que define el tamaño de los bloques de la caché sin comprimir. De forma predeterminada, es de 8 GiB. La caché sin comprimir se rellena según sea necesario y los datos menos utilizados se eliminan automáticamente.
En las consultas que leen un volumen de datos relativamente grande (un millón de filas o más), la caché sin comprimir se deshabilita automáticamente para ahorrar espacio para las consultas realmente pequeñas. Esto significa que puede mantener la configuración use_uncompressed_cache siempre establecida en 1.
use_with_fill_by_sorting_prefix
Las columnas anteriores a las columnas WITH FILL en la cláusula ORDER BY constituyen el prefijo de ordenación. Las filas con valores distintos en el prefijo de ordenación se rellenan de manera independiente Última modificación el 24 de julio de 2026