ajustes de sesión de query_plan_*

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

Activa o desactiva una optimización a nivel de plan de consulta que, cuando una agregación final alimenta ORDER BY con los resultados de la agregación y LIMIT n, y el plan demuestra que la selección por bucket es exacta, materializa únicamente los n mejores grupos de cada bucket de dos niveles en ese orden durante la conversión final de la agregación. El resultado es exacto: un grupo que no está entre los n mejores de su propio bucket tiene al menos n grupos por delante a nivel global, por lo que no puede estar entre los n mejores globales. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Activa la optimización de agregación en orden a nivel del plan de consulta. Solo surte efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Permite convertir ANY JOIN en SEMI o ANTI JOIN si el filtro posterior a JOIN siempre se evalúa como falso para las filas coincidentes o no coincidentes

Permite convertir JOIN en una subconsulta con IN si las columnas de salida están asociadas únicamente a la tabla izquierda. Puede producir resultados incorrectos con JOIN que no sean ANY (por ejemplo, ALL JOIN, que es el valor predeterminado).

Permite convertir OUTER JOIN en INNER JOIN si el filtro después del JOIN siempre filtra los valores predeterminados

Permite realizar el filtrado de búsqueda de texto completo en el plan de consulta usando únicamente el índice invertido de texto.

Muestra los alias internos (como __table1) en EXPLAIN PLAN en lugar de los especificados en la consulta original.

Habilita el procesamiento multihilo después de evaluar las funciones de ventana para permitir el procesamiento de flujo en paralelo

Activa o desactiva la optimización a nivel del plan de consulta.

Valores posibles:

• 0 - Desactiva todas las optimizaciones a nivel del plan de consulta
• 1 - Activa las optimizaciones a nivel del plan de consulta (aunque algunas optimizaciones individuales aún pueden desactivarse mediante sus propias configuraciones)

Activa o desactiva una optimización a nivel del plan de consulta que desplaza las expresiones después de los pasos de ordenación. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Activa o desactiva una optimización a nivel del plan de consulta que desplaza los filtros hacia abajo en el plan de ejecución. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Desactivar
• 1 - Activar

Activa o desactiva una optimización a nivel del plan de consulta que integra un filtro en columnas de elementos con ARRAY JOIN en el paso ARRAY JOIN. Filtra los arrays en el espacio de los elementos antes de expandirlos, de modo que los elementos descartados por el filtro nunca se expanden ni se replican. Solo tiene efecto si la configuración query_plan_enable_optimizations está establecida en 1.

Aplica la segmentación para JOIN si las claves de JOIN incluyen un prefijo de PRIMARY KEY en ambas tablas. Se admite para los algoritmos hash, parallel_hash, full_sorting_merge y parallel_full_sorting_merge. Normalmente no acelera las consultas, pero puede reducir el consumo de memoria.

Determina qué lado del join debe ser la tabla de construcción (también llamada interna, la que se inserta en la tabla hash para un hash join) en el plan de consulta. Esta configuración solo es compatible con la strictness ALL del join con la cláusula JOIN ON. Los valores posibles son:

• 'auto': Deja que el planificador decida qué tabla usar como tabla de construcción.
• 'false': Nunca intercambies las tablas (la tabla derecha es la tabla de construcción).
• 'true': Intercambia siempre las tablas (la tabla izquierda es la tabla de construcción).

Activa o desactiva una optimización a nivel del plan de consulta que desplaza los ARRAY JOIN hacia arriba en el plan de ejecución. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Desactivar
• 1 - Activar

Activa o desactiva una optimización a nivel del plan de consulta que mueve subárboles más grandes del plan de consulta a union para permitir optimizaciones adicionales. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Controla el límite máximo que permite usar el plan de consulta para la optimización de indexación diferida en JOIN. Si es cero, no hay límite.

Controla el valor máximo del límite que permite usar el plan de consulta para la optimización de materialización diferida. Si es cero, no hay límite.

Controla el valor máximo del límite que permite evaluar el plan de consulta para la optimización TopK mediante el índice de omisión minmax y el filtrado dinámico por umbral. Si es cero, no hay límite.

Esta configuración también controla el comportamiento de enable_group_by_top_k_optimization.

Limita el número total de optimizaciones aplicadas al plan de consulta; consulte la configuración query_plan_enable_optimizations. Es útil para evitar tiempos de optimización prolongados en consultas complejas. En la consulta EXPLAIN PLAN, deja de aplicar optimizaciones cuando se alcanza este límite y devuelve el plan tal cual. En la ejecución normal de consultas, si el número real de optimizaciones supera esta configuración, se lanza una excepción.

Número máximo de filas de un conjunto de la cláusula IN para el que el comparador de proyecciones calcula y compara hashes de contenido al decidir si dos conjuntos son iguales. Los conjuntos que superan este valor se tratan como no coincidentes y omiten la proyección. El valor cero desactiva por completo la comparación de hash de contenido: una coincidencia de proyección nunca se completa correctamente en nodos que contienen conjuntos de la cláusula IN.

Lo utiliza el comparador de proyección de agregación (y cualquier comparador de proyección futuro que necesite comparar conjuntos de la cláusula IN). Calcular el hash de contenido es O(N log N) en función del número de elementos del conjunto; esta configuración limita el coste asumido durante la planificación cuando aparecen muchas cláusulas IN en la consulta o en la proyección.

Longitud máxima de la descripción de un paso en EXPLAIN PLAN.

Permite fusionar expresiones en el paso JOIN durante la optimización del reordenamiento de JOIN.

Activa o desactiva una optimización a nivel del plan de consulta que fusiona filtros consecutivos. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Posibles valores:

• 0 - Desactivar
• 1 - Activar

Permite fusionar el filtro con la condición de JOIN y convertir CROSS JOIN en INNER.

Permite fusionar filtros en el plan de consulta.

Controla el número mínimo de columnas del payload del lado izquierdo necesario para habilitar la optimización de indexación diferida en JOIN. 0 significa que la optimización está deshabilitada.

Permite responder a SELECT count() ... WHERE <text search predicate> directamente a partir de las cardinalidades de las listas de publicación del índice de texto, sin materializar las filas coincidentes. Solo tiene efecto cuando query_plan_direct_read_from_text_index está habilitado.

Especifica qué algoritmos de orden de JOIN se intentan durante la optimización del plan de consulta. Están disponibles los siguientes algoritmos:

• 'greedy' - algoritmo voraz básico: funciona rápido, pero puede no producir el mejor orden de join
• 'dpsize' - implementa el algoritmo DPsize, actualmente solo para INNER JOIN: considera todos los órdenes de join posibles y encuentra el más óptimo, pero puede ser lento para consultas con muchas tablas y predicados de join.
• 'dpsub' - implementa el algoritmo DPsub, que admite tanto INNER JOIN como joins que no son INNER: considera todos los órdenes de join posibles y encuentra el más óptimo, pero puede ser lento para consultas con muchas tablas y predicados de join.
• 'dphyp' - implementa el algoritmo DPhyp (programación dinámica mediante partición de hipergrafos), actualmente solo para INNER JOIN: explora el mismo espacio de búsqueda que dpsize, pero enumera solo pares de subgrafos conectados, lo que genera menos joins intermedios en grafos de join dispersos, a costa de no considerar productos cartesianos Se pueden especificar varios algoritmos como una lista separada por comas; por ejemplo, dphyp,greedy. Se prueban en orden; si un algoritmo no puede procesar la consulta (p. ej., debido a OUTER JOIN o a componentes desconectados), se usa el siguiente como fallback.

Optimiza el orden de los JOIN dentro de la misma subconsulta. Actualmente, solo se admite en casos muy limitados. El valor es el número máximo de tablas que se pueden optimizar.

Número máximo de planes parciales que el optimizador del orden de join puede enumerar antes de detenerse y pasar al siguiente algoritmo en query_plan_optimize_join_order_algorithm. Esto limita de forma determinista el tiempo de optimización (independientemente del tiempo de reloj) en grafos de join densos, como cliques o estrellas, donde el espacio de búsqueda crece exponencialmente. Establézcalo en 0 para desactivar el límite. No tiene efecto sobre el valor predeterminado de query_plan_optimize_join_order_limit, donde la búsqueda siempre se mantiene muy por debajo de este umbral.

Cuando es distinto de cero, el optimizador de orden de JOIN utiliza cardinalidades y NDV generados aleatoriamente en lugar de estadísticas reales. Cuando se establece en 1, se genera una semilla aleatoria; cuando se establece en un valor > 1, ese valor se usa directamente como semilla. Está pensado para pruebas, con el fin de encontrar errores provocados por distintos órdenes de JOIN.

Optimiza la lectura con FINAL en ReplacingMergeTree creando un conjunto de claves primarias y usándolo para el análisis de índices.

Usar el plan de consulta para la optimización de materialización diferida.

Utiliza la optimización de materialización diferida para leer archivos Parquet locales mediante la función de tabla file y el motor de tabla File: en las consultas ORDER BY ... LIMIT n, las columnas que no se necesitan para la ordenación ni el filtrado se leen únicamente para las n filas que permanecen tras aplicar LIMIT. Solo surte efecto si query_plan_optimize_lazy_materialization está habilitada.

Utiliza la optimización de materialización diferida al leer archivos Parquet desde el almacenamiento de objetos (incluidas las tablas Iceberg): en las consultas ORDER BY ... LIMIT n, las columnas que no son necesarias para ordenar ni filtrar solo se leen para las n filas que permanecen tras aplicar LIMIT. Solo tiene efecto si query_plan_optimize_lazy_materialization está habilitada.

Permite aplicar el filtro en la expresión PREWHERE para los almacenamientos compatibles

Activa o desactiva una optimización a nivel del plan de consulta que desplaza los LIMIT hacia abajo en el plan de ejecución. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Posibles valores:

• 0 - Deshabilitar
• 1 - Habilitar

Activa o desactiva una optimización a nivel del plan de consulta que desplaza las funciones que reducen el volumen (length, lengthUTF8, empty, notEmpty) hacia abajo en el plan de ejecución, por debajo de los pasos Sorting y Filter. El resultado de tamaño fijo reemplaza el argumento ancho de tipo String / FixedString, por lo que ya no se transporta a través de esos pasos. La transformación solo se aplica cuando la columna del argumento no se necesita por encima del paso por debajo del cual se desplaza.

Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Activa o desactiva una optimización a nivel del plan de consulta para las consultas ORDER BY ... LIMIT BY. Cuando las columnas de LIMIT BY son un prefijo de la cláusula ORDER BY, cada flujo ordenado en paralelo aplica LIMIT BY antes de que los flujos se combinen en uno solo, lo que reduce las filas procesadas por la combinación final y por las etapas posteriores de la canalización. Acelera las consultas en las que LIMIT BY descarta una gran parte de las filas.

Solo surte efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Activa o desactiva la optimización de lectura en orden a nivel del plan de consulta. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Mantiene la lectura en orden de la tabla izquierda en las operaciones JOIN, lo que puede aprovecharse en pasos posteriores.

Activa o desactiva una optimización del plan de consulta que elimina pasos DISTINCT redundantes. Solo surte efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Activa una optimización a nivel de plan de consulta que elimina pasos de ordenación redundantes, por ejemplo, en subconsultas. Solo tiene efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Activa o desactiva una optimización a nivel de plan de consulta que intenta eliminar las columnas no utilizadas (tanto de entrada como de salida) de los pasos del plan de consulta. Solo surte efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Alias: optimize_read_in_window_order

Activa una optimización a nivel del plan de consulta que aprovecha el orden de almacenamiento al ordenar para funciones de ventana. Solo surte efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Aplica cortocircuito a un JOIN cuya condición ON se reduce a una constante falsa, sustituyendo por una fuente vacía cada lado de entrada que no puede aportar ninguna fila (ambos lados para INNER/CROSS/SEMI y el lado no preservado para LEFT/RIGHT), de modo que no se lea el lado que no aporta resultados. Se aplica al analizador (enable_analyzer = 1) y a planes no distribuidos.

Activa una optimización a nivel del plan de consulta que divide los filtros en expresiones. Solo surte efecto si la configuración query_plan_enable_optimizations es 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar

Permite añadir una pista (predicado adicional) al filtrado generado a partir del índice de texto invertido en el plan de consulta.

Activa una optimización a nivel del plan de consulta que propaga ORDER BY ... LIMIT n a través de un join cuando la clave de ordenación solo hace referencia a columnas del lado preservado por el join (LEFT/RIGHT). Limita cuántas filas debe producir la entrada del lado preservado antes de realizar el join. Solo surte efecto si la configuración query_plan_enable_optimizations es 1.

Posibles valores:

• 0 - Deshabilitado
• 1 - Habilitado

Activa una optimización a nivel del plan de consulta que intenta usar el índice de similitud vectorial. Solo surte efecto si la opción query_plan_enable_optimizations tiene el valor 1.

Valores posibles:

• 0 - Deshabilitar
• 1 - Habilitar