sum (función de agregado)

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Devuelve el valor sum calculado a partir de los valores de un grupo.

Sintaxis

sum ( [ALL | DISTINCT] expr ) [FILTER ( WHERE cond ) ]

Esta función también se puede invocar como una función de ventana mediante la cláusula OVER.

Argumentos

  • expr: expresión que se evalúa como un valor numérico o intervalo.
  • cond: expresión booleana opcional que filtra las filas usadas para la agregación.

Devoluciones

Si expr es un tipo de número entero, se devuelve un valor BIGINT. Si expr es DECIMAL(p, s), el resultado es DECIMAL(p + min(10, 31-p), s). Si es expr un intervalo, el tipo de resultado coincide con expr. Si expr es DECFLOAT, el resultado es DECFLOAT(34).

De lo contrario, DOUBLE.

Si se especifica DISTINCT, solo se suman los valores únicos.

Para entradas DECFLOAT, con el modo de redondeo por defecto, el desbordamiento produce infinito en lugar de un error.

Para otros tipos de entrada, si el resultado se desborda del tipo, Azure Databricks genera un error de ARITHMETIC_OVERFLOW. Para devolver un NULL en su lugar, usa try_sum.

Advertencia

En Databricks Runtime, si spark.sql.ansi.enabled es false, un desbordamiento de BIGINT no provoca un error, sino que "ajusta" el resultado.

Condiciones de error comunes

Ejemplos

> SELECT sum(col) FROM VALUES (5), (10), (15) AS tab(col);
 30

> SELECT sum(col) FILTER(WHERE col <15)
    FROM VALUES (5), (10), (15) AS tab(col);
 15

> SELECT sum(DISTINCT col) FROM VALUES (5), (10), (10), (15) AS tab(col);
 30

> SELECT sum(col) FROM VALUES (NULL), (10), (15) AS tab(col);
 25

> SELECT sum(col) FROM VALUES (NULL), (NULL) AS tab(col);
 NULL

-- try_sum overflows a BIGINT
> SELECT try_sum(c1) FROM VALUES(5E18::BIGINT), (5E18::BIGINT) AS tab(c1);
 NULL

-- In ANSI mode sum returns an error if it overflows BIGINT
> SELECT sum(c1) FROM VALUES(5E18::BIGINT), (5E18::BIGINT) AS tab(c1);
 Error: ARITHMETIC_OVERFLOW

-- try_sum overflows an INTERVAL
> SELECT try_sum(c1) FROM VALUES(INTERVAL '100000000' YEARS), (INTERVAL '100000000' YEARS) AS tab(c1);
  NULL

-- sum returns an error on INTERVAL overflow
> SELECT sum(c1) FROM VALUES(INTERVAL '100000000' YEARS), (INTERVAL '100000000' YEARS) AS tab(c1);
 Error: ARITHMETIC_OVERFLOW