ajustes de sesión de aggregate_*

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

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

​

aggregate_function_input_format

Cómo leen los formatos de entrada las columnas de tipo AggregateFunction.

Valores posibles:

• state — el estado serializado de la función de agregación, tal como lo escriben los formatos de salida (valor predeterminado).
• value — un valor del argumento de la función de agregación, o una tupla de los argumentos si hay varios. El valor se agrega para formar el estado.
• array — un array de valores, tal como se describe en la opción value anterior. Todos los elementos del array se agregan para formar el estado.

En los modos value y array, el formato lee la columna como si tuviera el tipo de los valores: T para AggregateFunction(f, T), Tuple(T1, T2) para AggregateFunction(f, T1, T2), o un Array de ese tipo en el modo array. Los valores se escriben con la representación que el formato emplea para ese tipo: un número o una cadena en un formato de texto, un array JSON en los formatos JSON, la codificación binaria del tipo en RowBinary o Native, una columna de ese tipo en Parquet, etc. Esto se aplica a todos los formatos de entrada, y también a AggregateFunction anidado en Array, Tuple o Map.

Ejemplos

Para una tabla con la estructura:

CREATE TABLE example (
    user_id UInt64,
    avg_session_length AggregateFunction(avg, UInt32)
);

Con aggregate_function_input_format = 'value':

INSERT INTO example FORMAT CSV
123,456

INSERT INTO example FORMAT JSONEachRow
{"user_id": 123, "avg_session_length": 456}

Con aggregate_function_input_format = 'array':

INSERT INTO example FORMAT CSV
123,"[456,789,101]"

INSERT INTO example FORMAT JSONEachRow
{"user_id": 123, "avg_session_length": [456, 789, 101]}

Nota: los formatos value y array son más lentos que el formato predeterminado state, ya que requieren crear y agregar valores durante la inserción.

​

aggregate_functions_null_for_empty

Activa o desactiva la reescritura de todas las funciones de agregación de una consulta, añadiéndoles el sufijo -OrNull. Actívelo para garantizar la compatibilidad con el estándar SQL. Se implementa mediante la reescritura de consultas (de forma similar a la configuración count_distinct_implementation) para obtener resultados coherentes en las consultas distribuidas.

Valores posibles:

• 0 — Deshabilitado.
• 1 — Habilitado.

Ejemplo

Considere la siguiente consulta con funciones de agregación:

SELECT SUM(-1), MAX(0) FROM system.one WHERE 0;

Con aggregate_functions_null_for_empty = 0 se obtendría:

┌─SUM(-1)─┬─MAX(0)─┐
│       0 │      0 │
└─────────┴────────┘

Con aggregate_functions_null_for_empty = 1, el resultado sería:

┌─SUMOrNull(-1)─┬─MAXOrNull(0)─┐
│          NULL │         NULL │
└───────────────┴──────────────┘