ajustes de sesión optimize_*

Ajustes de sesión de ClickHouse en el grupo generado optimize_*.

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

​

optimize_aggregators_of_group_by_keys

Elimina los agregadores min/max/any/anyLast de las claves de GROUP BY en la cláusula SELECT

​

optimize_append_index

Use restricciones para añadir la condición del índice. El valor predeterminado es false.

Valores posibles:

• true, false

​

optimize_arithmetic_operations_in_aggregate_functions

Saca las operaciones aritméticas de las funciones de agregación

​

optimize_const_name_size

Sustituir por un escalar y usar un hash como nombre para constantes grandes (el tamaño se estima por la longitud del nombre).

Posibles valores:

• entero positivo - longitud máxima del nombre,
• 0 — siempre,
• entero negativo - nunca.

​

optimize_count_from_files

Habilita o deshabilita la optimización del conteo de filas en archivos con distintos formatos de entrada. Se aplica a las funciones de tabla/motores file/s3/url/hdfs/azureBlobStorage.

Valores posibles:

• 0 — Optimización deshabilitada.
• 1 — Optimización habilitada.

​

optimize_dictget_tuple_element

Reescribe tupleElement(dictGet('dict', ('a', 'b', 'c'), key), 2) como dictGet('dict', 'b', key) para evitar recuperar atributos del diccionario innecesarios. Admite acceso posicional (.1, .2, …) y con nombre (.b), y también se aplica a dictGetOrDefault cuando el argumento por defecto es una tupla constante o un tuple(...) de constantes.

​

optimize_distinct_in_order

Habilita la optimización de DISTINCT si algunas de sus columnas forman un prefijo de la ordenación. Por ejemplo, un prefijo de la clave de ordenación en MergeTree o de la instrucción ORDER BY

​

optimize_distributed_group_by_sharding_key

Optimiza las consultas GROUP BY sharding_key al evitar una agregación costosa en el servidor iniciador (lo que reduce el uso de memoria de la consulta en ese servidor).

Se admiten los siguientes tipos de consultas (y cualquier combinación de ellos):

• SELECT DISTINCT [..., ]sharding_key[, ...] FROM dist
• SELECT ... FROM dist GROUP BY sharding_key[, ...]
• SELECT ... FROM dist GROUP BY sharding_key[, ...] ORDER BY x
• SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1
• SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1 BY x

No se admiten los siguientes tipos de consultas (más adelante podría añadirse soporte para algunas de ellas):

• SELECT ... GROUP BY sharding_key[, ...] WITH TOTALS
• SELECT ... GROUP BY sharding_key[, ...] WITH ROLLUP
• SELECT ... GROUP BY sharding_key[, ...] WITH CUBE
• SELECT ... GROUP BY sharding_key[, ...] SETTINGS extremes=1

Posibles valores:

• 0 — Deshabilitado.
• 1 — Habilitado.

Véase también:

• distributed_group_by_no_merge
• distributed_push_down_limit
• optimize_skip_unused_shards

Actualmente requiere optimize_skip_unused_shards (la razón es que, en algún momento, podría habilitarse de forma predeterminada, y solo funcionará correctamente si los datos se insertaron a través de una tabla Distributed; es decir, si los datos se distribuyen según sharding_key).

​

optimize_dry_run_check_part

Si está habilitado, OPTIMIZE ... DRY RUN valida la parte fusionada resultante con checkDataPart. Si la comprobación falla, se lanza una excepción.

​

optimize_empty_string_comparisons

Convierte expresiones como col = ” o ” = col en empty(col), y col != ” o ” != col en notEmpty(col), únicamente cuando col es de tipo String o FixedString.

​

optimize_extract_common_expressions

Permite extraer expresiones comunes de las disyunciones en las expresiones WHERE, PREWHERE, ON, HAVING y QUALIFY. Una expresión lógica como (A AND B) OR (A AND C) puede reescribirse como A AND (B OR C), lo que puede ayudar a aprovechar:

• índices en expresiones de filtrado simples
• la optimización de CROSS a INNER JOIN

​

optimize_functions_to_subcolumns

Habilita o deshabilita la optimización mediante la transformación de algunas funciones para que lean subcolumnas. Esto reduce la cantidad de datos que se deben leer.

Estas funciones pueden transformarse:

• length para leer la subcolumna size0.
• empty para leer la subcolumna size0.
• notEmpty para leer la subcolumna size0.
• isNull para leer la subcolumna null.
• isNotNull para leer la subcolumna null.
• count para leer la subcolumna null.
• mapKeys para leer la subcolumna keys.
• mapValues para leer la subcolumna values.
• has y notHas para Map, para leer la subcolumna keys.
• mapContainsKeyLike para leer la subcolumna keys.
• mapContainsValueLike para leer la subcolumna values.

Valores posibles:

• 0 — Optimización deshabilitada.
• 1 — Optimización habilitada.

​

optimize_inverse_dictionary_lookup

Evita repetir la búsqueda inversa en diccionarios mediante búsquedas más rápidas en un conjunto precalculado de posibles valores de clave.

​

optimize_multiif_to_if

Sustituye ‘multiIf’ por ‘if’ cuando solo haya una condición.

​

optimize_mutations_with_partition_pruning

Cuando está habilitada, ClickHouse detecta automáticamente las condiciones de la clave de partición en la cláusula WHERE de las mutaciones ALTER TABLE UPDATE/DELETE y de las sentencias UPDATE/DELETE ligeras en tablas de la familia ReplicatedMergeTree, y procesa únicamente las particiones afectadas en lugar de todas las particiones.

Actualmente, este descarte automático se aplica únicamente a tablas replicadas. En tablas MergeTree no replicadas, use una cláusula IN PARTITION explícita para limitar una mutación a particiones específicas.

Valores posibles:

• 0 — Deshabilitada. Las mutaciones y las actualizaciones ligeras procesarán todas las particiones.
• 1 — Habilitada. Las mutaciones y las actualizaciones ligeras procesarán únicamente las particiones que cumplan la condición WHERE.

​

optimize_normalize_count_variants

Reescribe las funciones de agregación semánticamente equivalentes a count() como count().

​

optimize_on_insert

Habilita o deshabilita la transformación de datos antes de la inserción, como si se hubiera realizado una fusión en este bloque (según el motor de la tabla).

Posibles valores:

• 0 — Deshabilitado.
• 1 — Habilitado.

Ejemplo

La diferencia entre habilitado y deshabilitado:

Consulta:

SET optimize_on_insert = 1;

CREATE TABLE test1 (`FirstTable` UInt32) ENGINE = ReplacingMergeTree ORDER BY FirstTable;

INSERT INTO test1 SELECT number % 2 FROM numbers(5);

SELECT * FROM test1;

SET optimize_on_insert = 0;

CREATE TABLE test2 (`SecondTable` UInt32) ENGINE = ReplacingMergeTree ORDER BY SecondTable;

INSERT INTO test2 SELECT number % 2 FROM numbers(5);

SELECT * FROM test2;

Resultado:

┌─FirstTable─┐
│          0 │
│          1 │
└────────────┘

┌─SecondTable─┐
│           0 │
│           0 │
│           0 │
│           1 │
│           1 │
└─────────────┘

Tenga en cuenta que esta configuración afecta al comportamiento de la vista materializada.

​

optimize_prewhere_after_pushdown

Ejecuta una segunda pasada de promoción de PREWHERE después de que optimizaciones posteriores del plan de consulta hayan podido añadir filtros adicionales sobre un paso de lectura de MergeTree (p. ej., pushdown de predicados a través de JOIN, reescrituras de proyección). Cuando ya existe un PREWHERE, el nuevo filtro se fusiona con él mediante AND en lugar de permanecer como un paso de filtro independiente.

​

optimize_qbit_distance_function_reads

Sustituye las funciones de distancia del tipo de dato QBit por otras equivalentes que solo leen del almacenamiento las columnas necesarias para el cálculo.

​

optimize_read_in_order

Habilita la optimización de ORDER BY en las consultas SELECT para la lectura de datos de tablas MergeTree.

Valores posibles:

• 0 — la optimización de ORDER BY está deshabilitada.
• 1 — la optimización de ORDER BY está habilitada.

Véase también

• cláusula ORDER BY

​

optimize_read_in_reverse_order_final

Habilita la lectura de datos en orden inverso de la clave de ordenación en consultas SELECT con el modificador FINAL en tablas ReplacingMergeTree. Solo surte efecto si optimize_read_in_order también está habilitado.

Valores posibles:

• 0 — Se deshabilita la lectura en orden inverso con FINAL.
• 1 — Se habilita la lectura en orden inverso con FINAL.

​

optimize_respect_aliases

Si se establece en true, respetará los alias en WHERE/GROUP BY/ORDER BY, lo que ayudará con el descarte de particiones/índices secundarios/optimize_aggregation_in_order/optimize_read_in_order/optimize_trivial_count

​

optimize_sorting_by_input_stream_properties

Optimiza la ordenación en función de las propiedades de ordenación del flujo de entrada

​

optimize_substitute_columns

Use restricciones para sustituir columnas. El valor predeterminado es false.

Valores posibles:

• true, false

​

optimize_syntax_fuse_functions

Permite fusionar funciones de agregación con el mismo argumento. Reescribe una consulta que contiene al menos dos funciones de agregación de sum, count o avg con el mismo argumento como sumCount.

Valores posibles:

• 0 — Las funciones con el mismo argumento no se fusionan.
• 1 — Las funciones con el mismo argumento se fusionan.

Ejemplo

Consulta:

CREATE TABLE fuse_tbl(a Int8, b Int8) Engine = Log;
SET optimize_syntax_fuse_functions = 1;
EXPLAIN SYNTAX run_query_tree_passes = 1 SELECT sum(a), sum(b), count(b), avg(b) from fuse_tbl FORMAT TSVRaw;

Resultado:

SELECT
    sum(__table1.a) AS `sum(a)`,
    tupleElement(sumCount(__table1.b), 1) AS `sum(b)`,
    tupleElement(sumCount(__table1.b), 2) AS `count(b)`,
    divide(tupleElement(sumCount(__table1.b), 1), toFloat64(tupleElement(sumCount(__table1.b), 2))) AS `avg(b)`
FROM default.fuse_tbl AS __table1

​

optimize_throw_if_noop

Habilita o deshabilita el lanzamiento de una excepción si una consulta OPTIMIZE no realizó ninguna fusión.

De forma predeterminada, OPTIMIZE se completa correctamente incluso si no hizo nada. Esta configuración le permite distinguir estas situaciones y obtener el motivo en el mensaje de excepción.

Valores posibles:

• 1 — El lanzamiento de una excepción está habilitado.
• 0 — El lanzamiento de una excepción está deshabilitado.

​

optimize_time_filter_with_preimage

Optimiza los predicados de Date y DateTime convirtiendo las funciones en comparaciones equivalentes sin necesidad de conversiones (p. ej., toYear(col) = 2023 -> col >= '2023-01-01' AND col <= '2023-12-31')

​

optimize_truncate_order_by_after_group_by_keys

Eliminar los elementos finales de ORDER BY una vez que todas las claves de GROUP BY queden incluidas en el prefijo de ORDER BY.

​

optimize_uniq_to_count

Reescribe uniq y sus variantes (excepto uniqUpTo) como count si la subconsulta tiene DISTINCT o una cláusula GROUP BY.

​

optimize_using_constraints

Use restricciones para la optimización de consultas. El valor predeterminado es false.

Valores posibles:

• true, false