Saltar al contenido principal
Estos ajustes están disponibles en system.settings y se generan automáticamente a partir del código fuente.

use_query_cache

Si está habilitado, las consultas SELECT pueden utilizar la caché de consultas. Los parámetros enable_reads_from_query_cache y enable_writes_to_query_cache controlan con más detalle cómo se usa la caché. Valores posibles:
  • 0 - Deshabilitado
  • 1 - Habilitado

use_query_condition_cache

Habilita la caché de condiciones de consulta. La caché almacena rangos de gránulos en partes de datos que no cumplen la condición de la cláusula WHERE, y reutiliza esta información como un índice efímero para consultas posteriores. Valores posibles:
  • 0 - Deshabilitado
  • 1 - Habilitado

use_query_condition_cache_for_time_conditions

Activa la caché de condiciones de consulta para condiciones que dependen de la hora actual, p. ej., WHERE time >= now() - INTERVAL 10 DAY, al leer de tablas MergeTree. Las lecturas de archivos y del almacenamiento de objetos (file, s3 y similares) solo usan la caché de condiciones de consulta para condiciones deterministas y no se ven afectadas por este parámetro de configuración. Estas condiciones son no deterministas (varían con el reloj), por lo que no pueden almacenarse en caché directamente. En su lugar, se deriva de ellas una condición determinista redondeando sobre una cuadrícula temporal la constante de la hora actual ya evaluada; p. ej., WHERE time >= '2026-08-09 12:34:56' se convierte en WHERE time >= '2026-08-09 00:00:00' (se redondea hacia abajo para las lecturas de la caché y hacia arriba para las escrituras, lo que garantiza que la caché siga siendo correcta). El paso de la cuadrícula es proporcional a la distancia entre la constante y la hora actual (consulte query_condition_cache_time_condition_grid_factor) y está limitado a un valor de entre un segundo y un día. Si la constante ya está alineada con la cuadrícula (p. ej., WHERE time >= today() - 10 o WHERE time >= toStartOfDay(now())), la caché es efectiva durante toda la celda de la cuadrícula, p. ej., hasta el final del día. De lo contrario, la caché solo se reutiliza para límites inferiores de tiempo, p. ej., WHERE time >= now() - INTERVAL 10 DAY: las entradas de caché escritas durante una celda de la cuadrícula se usan durante la siguiente. Un límite superior no alineado, como WHERE time < now(), ya sea por sí solo o como parte de una ventana deslizante como WHERE time >= now() - INTERVAL 10 DAY AND time < now(), no se reutiliza en consultas posteriores, porque su condición no está contenida en la de las consultas anteriores. Este parámetro de configuración no tiene efecto a menos que use_query_condition_cache también esté habilitado. Valores posibles:
  • 0 - Deshabilitado
  • 1 - Habilitado

use_query_condition_cache_for_top_k

Habilita la caché de condiciones de consulta para las consultas que usan la optimización ORDER BY <column> LIMIT n (TopK), basada en filtrado dinámico o índices de omisión. Cuando está deshabilitada, estas lecturas no consultan ni rellenan la caché. Estas consultas pueden descartar gránulos durante la ejecución según el umbral en uso, por lo que sus entradas de caché se particionan por los parámetros del plan TopK y el conjunto de partes leídas (en el caso de una tabla File, por el conjunto de archivos leídos y sus versiones; en el caso de una tabla de lago de datos, por su instantánea). Esta opción no tiene efecto a menos que también esté habilitada use_query_condition_cache. Valores posibles:
  • 0 - Deshabilitada
  • 1 - Habilitada