Definición
Devuelve la suma de los valores numéricos de los documentos en una ventana específica.
Nota
Otros usos de $sum
Esta página describe $sum cuando se utiliza como función de ventana.
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 (expression), que devuelve la suma de valores numéricos en un arreglo.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $sum: <expression> } } }}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:
Valores nulos o faltantes
Si algunos documentos de la ventana tienen un valor null para el campo o les falta el campo, $sum ignora esos valores y suma los valores restantes.
Si todos los documentos en la ventana tienen un valor null para el campo o no tienen el campo, $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 $setWindowFields para calcular un total de votos acumulados en curso para cada película musical de 2009 y 2010. Cada documento recibe el valor $sum calculado desde el inicio de su partición anual hasta el documento actual.
db.movies.aggregate( [ { $match: { genres: "Musical", year: { $in: [ 2009, 2010 ] }, "imdb.rating": { $type: "double" }, "imdb.votes": { $gt: 0 } } }, { $setWindowFields: { partitionBy: "$year", sortBy: { title: 1 }, output: { cumulativeVotesInYear: { $sum: "$imdb.votes", window: { documents: [ "unbounded", "current" ] } }, rankInYear: { $documentNumber: {} } } } }, { $project: { _id: 0, title: 1, year: 1, "imdb.votes": 1, cumulativeVotesInYear: 1, rankInYear: 1 } }, { $sort: { year: 1, title: 1 } }] )El pipeline anterior:
Utiliza
$matchpara filtro películas musicales de 2009 y 2010 con una calificación numérica de IMDb y al menos un voto.Utiliza
$setWindowFieldspara particionar películas poryeary ordenarlas portitle. La etapa utiliza$sumcon una ventana de documentos de[ "unbounded", "current" ]para crear los siguientes campos para cada documento:cumulativeVotesInYear: la suma acumulada continua deimdb.votes.rankInYear: un número de fila por partición asignado por$documentNumber.
Utiliza
$projectpara incluirtitle,year,imdb.votes,cumulativeVotesInYearyrankInYearen la salida.Utiliza
$sortpara ordenar los resultados por año y título.