Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

$sum (Función de ventana)

$sum

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:

{ $setWindowFields: { ... output: { <field>: { $sum: <expression> } } }}

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:

  • Si el tipo de entrada más grande es integer, el tipo de resultado se eleva a long.

  • Si el tipo de entrada más grande es long, el tipo de resultado se eleva a double.

  • Si el tipo mayor es double o decimal, el resultado del desbordamiento se representa como infinito positivo o negativo. No hay promoción de tipo del resultado.

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.

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 $match para filtro películas musicales de 2009 y 2010 con una calificación numérica de IMDb y al menos un voto.

  • Utiliza $setWindowFields para particionar películas por year y ordenarlas por title. La etapa utiliza $sum con una ventana de documentos de [ "unbounded", "current" ] para crear los siguientes campos para cada documento:

    • cumulativeVotesInYear: la suma acumulada continua de imdb.votes.

    • rankInYear: un número de fila por partición asignado por $documentNumber.

  • Utiliza $project para incluir title, year, imdb.votes, cumulativeVotesInYear y rankInYear en la salida.

  • Utiliza $sort para ordenar los resultados por año y título.

Documentación