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 tablafile/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_columns_cache
Indica si se debe usar la caché de columnas. Acepta 0 o 1. De forma predeterminada, 0 (deshabilitada). La caché de columnas almacena columnas deserializadas de tablasMergeTree, lo que evita tener que descomprimir y deserializar repetidamente los datos de acceso frecuente. Esto puede reducir significativamente la latencia de las consultas que se repiten sobre los mismos datos. La clave de la caché se compone del UUID de la tabla, el nombre de la parte de datos, el nombre de la columna y un segmento (stripe) de gránulos consecutivos de aproximadamente 65536 filas.
Dado que la clave de las entradas incluye el UUID de la tabla, la caché solo está activa para tablas de bases de datos que asignan UUID, como Atomic, Replicated y Shared (el motor de base de datos predeterminado en ClickHouse Cloud); las tablas MergeTree de las bases de datos Ordinary heredadas tienen un UUID nulo e ignoran esta configuración de forma silenciosa.
Actualmente, la caché solo se aplica a las partes anchas (wide): los datos de las partes compactas no se leen de la caché de columnas ni se escriben en ella, por lo que la aceleración de una lectura depende del formato de la parte.
Cada entrada contiene un rango contiguo de gránulos de un mismo segmento: un gránulo solo entra en la caché una vez que se ha leído de la primera a la última fila, las lecturas se sirven desde la caché gránulo a gránulo y los rangos escritos por distintas lecturas se fusionan, de modo que las lecturas que dividen una parte en distintos rangos de marcas comparten las mismas entradas.
use_concurrency_control
Respeta el control de concurrencia del servidor (consulta los ajustes globales del servidorconcurrent_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, conPARTITION BY a y ORDER BY b:
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 joinsuse_hedged_requests
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 dehedged_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
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
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 (consultause_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
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
Cuando está habilitada, el nombretoTime 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
Optimiza el análisis del índice de clave primaria para tablasMergeTree 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
Si está activado, el formato Parquet puede utilizar la caché de metadatos de Parquet. Valores posibles:- 0 - Deshabilitado
- 1 - Habilitado
use_primary_key
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
Experimental. Enruta las lecturas a través del nuevo pipelineReaderExecutor 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.
- Umbrales mínimos (OR): Se alcanza min_insert_block_size_rows o min_insert_block_size_bytes.
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áticouse_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ónuse_uncompressed_cache siempre establecida en 1.