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
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 24.12 | 0 | Nueva configuración. |
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.
use_client_time_zone
Usa la zona horaria del client para interpretar los valores de cadena DateTime, en lugar de usar la zona horaria del server.
use_compact_format_in_distributed_parts_names
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 21.1 | 1 | Usa de forma predeterminada el formato compacto para `INSERT` asíncronos en tablas `Distributed` |
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}]].
use_concurrency_control
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 24.12 | 1 | Habilita el control de concurrencia de forma predeterminada |
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
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.7 | 0 | Nueva configuración para incorporar constantes a nivel de partición en el predicado de filtro para cada parte durante el análisis de índices de MergeTree, lo que mejora la poda en filtros cuyas ramas dependen de valores de partición. |
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:
SELECT * FROM t WHERE (a = 1 AND b >= 1) OR (a = 2 AND b > 10) OR (a = 3 AND b > 10)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
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.1 | 1 | Nueva configuración. Anteriormente reflejaba la configuración 'collect_hash_table_stats_during_joins'. |
Habilita el uso de las estadísticas recopiladas de la tabla hash para estimar la cardinalidad durante la reordenación de joins
use_hedged_requests
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 21.9 | 1 | Habilita la función de Hedged Requests de forma predeterminada |
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.
use_hive_partitioning
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 25.1 | 1 | La configuración se habilitó de forma predeterminada. |
| 24.8 | 0 | Permite usar el particionamiento de estilo Hive para los motores File, URL, S3, AzureBlobStorage y HDFS. |
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_indexes_refiner_in_read_pools
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.8 | 0 | Nueva configuración para descartar, antes de crear tareas de lectura en los grupos de lectura de MergeTree, rangos de marcas totalmente filtrados por índices de omisión o por un índice de proyección. |
Aplica dentro de los grupos de lectura de MergeTree los índices evaluados durante la lectura de datos: los rangos de marcas totalmente filtrados por índices de omisión (consulta use_skip_indexes_on_data_read) o por el índice de proyección (consulta optimize_use_projection_filtering) se descartan antes de crear una tarea de lectura, en lugar de omitirse gránulo a gránulo durante la lectura.
En el grupo de lectura con prefetch, los rangos descartados nunca se precargan, pero los límites de las tareas y la admisión de prefetch mediante filesystem_prefetch_max_memory_usage / filesystem_prefetches_limit se siguen determinando antes del filtrado. Por lo tanto, con filtros muy selectivos, las tareas resultantes pueden ser más pequeñas que el tamaño de tarea previsto y la admisión puede ser conservadora.
use_join_disjunctions_push_down
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.1 | 1 | Se habilitó esta optimización. |
| 25.10 | 0 | Nueva configuración. |
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.
use_legacy_to_time
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.7 | 0 | Usa de forma predeterminada la nueva función `toTime` (que convierte valores al tipo de dato `Time`) en lugar de la función `toTime` heredada, que sigue disponible como `toTimeWithFixedDate`. |
| 25.6 | 1 | Nueva configuración. Permite al usuario usar la lógica anterior de la función `toTime`, que funciona como `toTimeWithFixedDate`. |
Cuando está habilitada, el nombre toTime se refiere a la función toTime heredada,
que convierte una fecha con hora en una fecha fija determinada, conservando la hora.
De lo contrario, el nombre se refiere a la nueva función toTime,
que convierte valores de distintos tipos al tipo Time.
La función heredada anterior también está disponible incondicionalmente como toTimeWithFixedDate, independientemente de esta configuración.
Mientras esta configuración esté habilitada, use CAST(x AS Time) o x::Time para convertir al tipo Time.
use_lightweight_primary_key_index_analysis
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.6 | 1 | Nueva configuración para optimizar el análisis del índice de clave primaria en tablas con claves primarias largas |
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.
use_parquet_metadata_cache
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.3 | 1 | Habilita la caché de metadatos de archivos Parquet. |
Si está activado, el formato Parquet puede utilizar la caché de metadatos de Parquet.
Valores posibles:
- 0 - Deshabilitado
- 1 - Habilitado
use_primary_key
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.1 | 1 | Nueva configuración que controla si MergeTree usa la clave primaria para descartar gránulos. |
Usa la clave primaria para descartar gránulos durante la ejecución de consultas en tablas MergeTree.
Valores posibles:
- 0 — Deshabilitado.
- 1 — Habilitado.
use_reader_executor
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.6 | 0 | Nueva configuración experimental para enrutar las lecturas a través del nuevo pipeline ReaderExecutor en lugar de la matrioshka heredada de búferes de lectura. |
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
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 25.8 | 0 | Nueva configuración |
Usa un bitmap roaring para las eliminaciones posicionales de Iceberg.
use_streaming_marks_compression
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.7 | 0 | Nueva configuración para comprimir las marks en la representación en memoria un bloque cada vez (streaming), en lugar de materializar primero el array completo de marks sin comprimir, lo que reduce el uso máximo de memoria durante la carga de marks para partes compactas con muchos subflujos. |
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
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 26.4 | 0 | Nueva configuración para aplicar límites mínimos y máximos estrictos a los bloques de inserción durante las inserciones. Cuando min < max, prevalecen los límites máximos. |
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
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 22.11 | 2 | Mejora el uso de la estructura de la tabla de inserción en las funciones de tabla |
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
use_uncompressed_cache
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
Historial de versiones
| Versión | Valor predeterminado | Comentario |
|---|---|---|
| 23.5 | 1 | 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 |
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