ajustes de sesión enable_*

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

Habilita el algoritmo adaptativo de GROUP BY: cada hilo agrega datos en su tabla hash local hasta alcanzar adaptive_aggregator_freeze_threshold claves (o adaptive_aggregator_freeze_threshold_bytes de memoria); entonces, la tabla se congela, de modo que las filas con claves ya vistas (frecuentes) siguen actualizándola in situ, mientras que las claves nuevas (poco frecuentes) se enrutan según su hash a colas pendientes por bucket y se agregan exactamente una vez durante la fusión paralela por bucket. Las claves frecuentes permanecen en pequeñas tablas residentes en caché, y las claves poco frecuentes se almacenan y procesan una vez, en lugar de una vez por hilo.

Se respetan las configuraciones de agregación externa (max_bytes_before_external_group_by, max_bytes_ratio_before_external_group_by): al superar el umbral, las colas pendientes se vacían anticipadamente en la tabla compartida y, si eso no basta para volver a situarse por debajo de él, la tabla compartida se vuelca al disco mediante la agregación externa ordinaria.

Hace que el procesador vuelque datos al almacenamiento externo de forma adaptativa. Actualmente, se admite grace join.

Habilita DISTINCT en las subconsultas IN. Esta configuración implica una compensación: al habilitarla, puede reducir considerablemente el tamaño de las tablas temporales transferidas en las subconsultas IN distribuidas y acelerar de forma significativa la transferencia de datos entre segmentos, ya que garantiza que solo se envíen valores únicos. Sin embargo, habilitar esta configuración añade trabajo adicional de merging en cada nodo, ya que debe realizarse la deduplicación (DISTINCT). Use esta configuración cuando la transferencia de red sea un cuello de botella y el costo adicional de merging sea aceptable.

Permite utilizar el códec de compresión experimental ALP.

Si está habilitada, ClickHouse activará automáticamente esta optimización cuando la expresión de la clave de partición sea determinista y todas las columnas utilizadas en ella estén incluidas en la clave primaria. Esta derivación automática garantiza que las filas con los mismos valores de clave primaria siempre pertenecerán a la misma partición, por lo que es seguro evitar las fusiones entre particiones.

Habilita el optimizador basado en costes Cascades para los planes de consultas distribuidas. Solo surte efecto junto con make_distributed_plan = 1: esta configuración por sí sola no modifica la planificación de consultas en un único nodo.

Habilita la optimización de consultas mediante la cual se analizan los resultados de funciones y subconsultas, y se reescribe la consulta si hay constantes

Habilita o deshabilita la devolución de resultados de tipo Date32 con un rango ampliado (en comparación con el tipo Date) o de tipo DateTime64 con un rango ampliado (en comparación con el tipo DateTime).

Valores posibles:

• 0 — Las funciones devuelven Date o DateTime para todos los tipos de argumentos.
• 1 — Las funciones devuelven Date32 o DateTime64 para argumentos Date32 o DateTime64, y Date o DateTime en los demás casos.

La siguiente tabla muestra el comportamiento de esta configuración para varias funciones de fecha y hora.

Alias: allow_experimental_full_text_index

Si se establece en true, permite utilizar el índice de texto.

Habilita el plegado anticipado de constantes mediante cortocircuito para and y or durante el análisis de consultas. Cuando está habilitada, se analizan las ramas no alcanzables de subconsultas escalares aptas para preservar sus tipos y validar la semántica de las consultas, pero no se ejecutan. La optimización recurre al análisis normal cuando se requiere la cardinalidad escalar o valores en tiempo de ejecución.

Propagar las sentencias WITH a las consultas UNION y a todas las subconsultas

Habilita la optimización de filtrado TopK durante la agregación en consultas GROUP BY keys ORDER BY <prefix of keys> LIMIT K y en consultas GROUP BY keys LIMIT K sin ORDER BY (en este caso, cualquier grupo de K es un resultado válido, por lo que se sintetiza una ordenación de todas las claves).

Cuando está habilitada, la agregación mantiene un heap acotado con las K claves principales observadas hasta el momento y omite insertar nuevas filas en la tabla hash cuando su clave de agrupación no puede formar parte del resultado final. Esto evita agregar filas que se descartarían con el posterior ORDER BY ... LIMIT y, cuando el heap clasifica la clave completa de GROUP BY, también elimina de la tabla hash intermedia los grupos expulsados, limitando su tamaño a LIMIT en lugar de al número de claves distintas. Cuando ORDER BY solo abarca un prefijo propio de las claves de GROUP BY, la clasificación no puede identificar un grupo completo, por lo que solo se omiten filas: la tabla hash conserva todos los grupos admitidos y aún puede crecer según la cardinalidad de las columnas de clave restantes.

La optimización se deshabilita cuando el valor solicitado de LIMIT es superior a query_plan_max_limit_for_top_k_optimization o al límite estricto de 100000, porque el coste de memoria y CPU del heap aumenta con el valor solicitado de LIMIT.

La optimización se omite para formas de consulta en las que eliminar grupos podría cambiar el resultado, incluidos WITH TOTALS, HAVING, QUALIFY, las funciones de ventana, ROLLUP/CUBE/GROUPING SETS, LIMIT WITH TIES, un COLLATE en cualquiera de las claves de GROUP BY coincidentes (un COLLATE en una columna posterior de ORDER BY, después del prefijo de clave completo, no puede afectar a qué grupos cumplen los requisitos, por lo que no deshabilita la optimización), ORDER BY sobre una agregación o sobre cualquier elemento que no sea un prefijo inicial de las claves de GROUP BY, y cuando se establece max_rows_to_group_by o exact_rows_before_limit.

Valores posibles:

• 0 — Deshabilitada.
• 1 — Habilitada.

Habilita la transformación del payload de un hash join a un diseño por filas.

Habilita o deshabilita pread para archivos HDFS. De forma predeterminada, se usa hdfsPread. Si se deshabilita, se usarán hdfsRead y hdfsSeek para leer archivos HDFS.

Habilita o deshabilita la compresión de datos en la respuesta a una petición HTTP.

Para obtener más información, lea la descripción de la interfaz HTTP.

Valores posibles:

• 0 — Deshabilitado.
• 1 — Habilitado.

Activa la caché de resolución de identificadores en el analizador de consultas. La caché comparte nodos de alias ya resueltos para evitar la explosión del AST cuando se hace referencia al mismo alias varias veces. Establézcalo en false para desactivar la caché si se sospecha que produce resultados incorrectos.

Muestra la traza de pila del creador de un job cuando este produce una excepción. Está deshabilitado de forma predeterminada para evitar el impacto en el rendimiento.

Habilita el valor clickhouse_json de la configuración dialect.

Cuando dialect se establece en clickhouse_json, las consultas se interpretan como AST JSON (la salida de parseQueryToJSON) en lugar de texto SQL. La consulta SET se sigue analizando como SQL sin procesar para poder volver a cambiar de dialecto.

Ejemplo:

SET enable_json_ast_dialect = 1;
SET dialect = 'clickhouse_json';

-- Subsequent queries are parsed as JSON ASTs:
{"type":"SelectWithUnionQuery", ...}

Habilita la replicación diferida de columnas en JOIN, ARRAY JOIN y las capturas lambda de funciones de orden superior (p. ej., arrayMap); permite evitar copiar innecesariamente las mismas filas varias veces en memoria.

Habilita las expresiones de tabla comunes materializadas; tiene preferencia sobre enable_global_with_statement

Activa la estrategia de fusión con límite de memoria para la agregación.

Traslada más condiciones de WHERE a PREWHERE y realiza lecturas desde disco y filtrado en varios pasos si hay varias condiciones combinadas con AND

Genera tuplas con nombre en la función tuple() cuando todos los nombres son únicos y pueden tratarse como identificadores sin comillas.

Habilita o deshabilita la ordenación mediante la sintaxis ORDER BY ALL; consulte ORDER BY.

Valores posibles:

• 0 — Deshabilita ORDER BY ALL.
• 1 — Habilita ORDER BY ALL.

Ejemplo

Consulta:

CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();

INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);

SELECT * FROM TAB ORDER BY ALL; -- returns an error that ALL is ambiguous

SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;

Resultado:

┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │  10 │
│ 30 │ 10 │  20 │
│ 10 │ 20 │  30 │
└────┴────┴─────┘

Utiliza una tabla hash con referencias a cadenas empaquetadas de 16 bytes (PackedStringRef) como claves para GROUP BY con una única clave String no Nullable. Las claves de hasta 11 bytes se almacenan en línea en la referencia empaquetada; las más largas se almacenan por referencia en un Arena. Esto es más rápido para la mayoría de las cargas de trabajo, pero puede ser más lento que el método heredado para GROUP BY con muy pocas claves distintas de más de 11 bytes (especialmente entre 12 y 24 bytes), ya que la tabla hash heredada mantiene las claves en línea en la celda, mientras que la empaquetada desreferencia el puntero al Arena en cada sondeo. Cuando se desactiva, se utiliza el método heredado basado en StringHashTable (el predeterminado antes de la 26.8).

Todos los servidores que participan en una consulta distribuida deben tener el mismo valor: con distributed_aggregation_memory_efficient, los números de bucket de dos niveles dependen del hash de la clave, que difiere entre ambos métodos. Por tanto, los servidores con valores distintos para esta configuración pueden dividir la misma clave en buckets diferentes y generar un resultado combinado incorrectamente. Para garantizar la coherencia, el iniciador siempre envía su valor efectivo con las consultas secundarias (incluso cuando procede únicamente de los valores predeterminados del servidor o del perfil), anulando los valores predeterminados de los servidores remotos.

Si es true, los datos pueden parsearse directamente en columnas con serialización personalizada (p. ej., Sparse) según las pistas de serialización obtenidas de la tabla.

Permite que la agregación eficiente en memoria (consulte distributed_aggregation_memory_efficient) produzca buckets fuera de orden. Puede mejorar el rendimiento cuando los tamaños de los buckets de agregación son desiguales, al permitir que una réplica envíe buckets con identificadores más altos al iniciador mientras sigue procesando algunos buckets pesados con identificadores más bajos. La desventaja es un uso de memoria potencialmente mayor.

Permite usar el códec de compresión experimental Quantized.

Si está activado, los resultados de las consultas SELECT se obtienen de la caché de consultas.

Valores posibles:

• 0 - Deshabilitado
• 1 - Habilitado

Habilita un registro muy detallado de las solicitudes de S3. Solo tiene sentido para depuración.

Si se establece en true, evita que las subconsultas escalares deserialicen y serialicen valores escalares grandes, y puede evitar ejecutar la misma subconsulta más de una vez.

Si está deshabilitada, las declaraciones en las cláusulas WITH padre se comportarán como si se hubieran declarado en el ámbito actual.

Ten en cuenta que esta es una configuración de compatibilidad del analizador para permitir ejecutar algunas consultas no válidas que el analizador antiguo podía ejecutar.

Habilita la optimización de GROUP BY fragmentado, que distribuye las filas entre los hilos aplicando un hash a la clave de agrupación, de modo que cada hilo agregue un subconjunto disjunto de claves sin una fase de combinación.

Es eficiente para claves de alta cardinalidad con datos distribuidos uniformemente, pero puede verse afectada por distribuciones de claves muy sesgadas o por consultas con muy pocas claves distintas.

Posibles valores:

• 0 — La optimización de agregación fragmentada está deshabilitada.
• 1 — La optimización de agregación fragmentada está habilitada.

Si está habilitado, todas las subconsultas dentro de una misma consulta compartirán la misma StorageSnapshot para cada tabla. Esto garantiza una vista coherente de los datos en toda la consulta, incluso si se accede varias veces a la misma tabla.

Esto es necesario para consultas en las que la consistencia interna de las partes de datos es importante. Ejemplo:

SELECT
    count()
FROM events
WHERE (_part, _part_offset) IN (
    SELECT _part, _part_offset
    FROM events
    WHERE user_id = 42
)

Sin esta configuración, la consulta externa y la interna pueden operar sobre instantáneas de datos diferentes, lo que puede dar lugar a resultados incorrectos.

Valores posibles:

• 0 - Deshabilitado
• 1 - Habilitado

Permite compartir objetos Set creados para las subconsultas IN entre distintas tareas de la misma mutación. Esto reduce el uso de memoria y el consumo de CPU

Permite consultas continuas SELECT ... FROM t STREAM [CURSOR '{...}']. Cuando está desactivado, cualquier expresión de tabla que use el modificador STREAM se rechaza en el momento de generar el plan. Este es el control general de la funcionalidad de consultas en streaming; otras capacidades pueden estar controladas por sus propios ajustes.

Permite usar el códec de compresión experimental SZ3.

Alias: allow_experimental_time_time64_type

Permite crear los tipos de datos Time y Time64.

Permite ARRAY JOIN con varios arrays de distintos tamaños. Cuando esta configuración está habilitada, los arrays se redimensionarán hasta igualar el más largo.

Permite habilitar o deshabilitar la decodificación/codificación de la ruta en el URI en las tablas con motor URL.

Deshabilitado de forma predeterminada.

Si está habilitado, elimina las filas duplicadas durante FINAL marcando las filas como eliminadas y filtrándolas después, en lugar de fusionarlas

Si está habilitado, los resultados de las consultas SELECT se almacenan en la caché de consultas.

Valores posibles:

• 0 - Deshabilitado
• 1 - Habilitado

Permite utilizar el códec de compresión experimental ZXC.