Definición
Devuelve la suma de valores numéricos en un arreglo.
Nota
Otros usos de $sum
Esta página describe $sum cuando se utiliza como una expresión, que devuelve la suma de los valores numéricos de un arreglo.
También puede usar $sum en estos otros contextos:
$sum (accumulator), que devuelve la suma total de valores numéricos en un grupo de documentos.$sum (window function), que se utiliza en la etapa$setWindowFieldspara calcular la suma acumulada de valores en una ventana.
Sintaxis
Cuando se utiliza como expresión, $sum tiene una de dos sintaxis posibles:
{ $sum: <expression> }En la sintaxis anterior, el operando es una única expresión que se evalúa como un arreglo. $sum recorre el arreglo y devuelve la suma de los valores numéricos del arreglo.
{ $sum: [ <expression1>, <expression2>, ... ] }En la sintaxis anterior, cada expresión es un único valor numérico. $sum devuelve la suma de esos valores.
Comportamiento
Tipo de resultado
Cuando se mezclan los tipos de entrada, $sum promueve el tipo de entrada menor al mayor de los dos. Un tipo se considera mayor cuando representa un rango más amplio de valores. El orden de los tipos numéricos, de menor a mayor, es: entero → largo → double → decimal.
El tipo de entrada mayor también determina el tipo de resultado, a menos que la operación se desborde y salga del rango representado por ese tipo de dato mayor. En casos de desbordamiento, $sum promueve el resultado según el siguiente orden:
Campos no numéricos o no existentes
Si se utiliza en un campo que contiene tanto valores numéricos como no numéricos, $sum ignora los valores no numéricos y devuelve la suma de los valores numéricos.
Si todos los operandos no son numéricos, $sum devuelve 0.
Ejemplo
Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si realizó alguna modificación en las bases de datos de muestra, es posible que deba descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.
Este ejemplo utiliza $sum en la etapa $project para calcular los premios totales ganados y nominados para tres películas, y almacenar el resultado en un nuevo campo llamado totalAwards.
db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Inception", "The Dark Knight" ] } } }, { $project: { _id: 0, title: 1, totalAwards: { $sum: [ "$awards.wins", "$awards.nominations" ] } } }, { $sort: { totalAwards: -1 } }] )El pipeline anterior: