/ /

$sum (Función de ventana)

Definición

$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 puedes usar $sum en estos otros contextos:

$sum (accumulator), que devuelve la suma colectiva de los valores numéricos de un grupo de documentos.
$sum (expression), que devuelve la suma de los valores numéricos en una matriz.

Sintaxis

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

Comportamiento

Tipo de resultado

Cuando se mezclan tipos de entrada, $sum prioriza el tipo de entrada más pequeño sobre el más grande. Un tipo se considera más grande cuando representa un rango de valores más amplio. El orden de los tipos numéricos de menor a mayor es: entero → largo → doble → 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 se realiza ninguna promoción de tipo del resultado.

Valores nulos o faltantes

Si algunos documentos en 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 de la ventana tienen un valor null para el campo o les falta 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 su implementación autogestionada de MongoDB, consulte Cargar el conjunto de datos de ejemplo. Si realizó alguna modificación en las bases de datos de ejemplo, es posible que deba eliminarlas y volver a crearlas para ejecutar los ejemplos de esta página.

Este ejemplo utiliza $setWindowFields para calcular un total acumulado de votos 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 } }
] )

[
  {
    title: 'Bran Nue Dae',
    year: 2009,
    imdb: { votes: 1327 },
    cumulativeVotesInYear: 1327,
    rankInYear: 1
  },
  {
    title: 'Face',
    year: 2009,
    imdb: { votes: 595 },
    cumulativeVotesInYear: 1922,
    rankInYear: 2
  },
  {
    title: 'Fame',
    year: 2009,
    imdb: { votes: 13364 },
    cumulativeVotesInYear: 15286,
    rankInYear: 3
  },
  {
    title: 'Guy and Madeline on a Park Bench',
    year: 2009,
    imdb: { votes: 356 },
    cumulativeVotesInYear: 15642,
    rankInYear: 4
  },
  {
    title: 'Lo',
    year: 2009,
    imdb: { votes: 2027 },
    cumulativeVotesInYear: 17669,
    rankInYear: 5
  },
  {
    title: 'Nine',
    year: 2009,
    imdb: { votes: 35900 },
    cumulativeVotesInYear: 53569,
    rankInYear: 6
  },
  {
    title: 'Oxygen',
    year: 2009,
    imdb: { votes: 493 },
    cumulativeVotesInYear: 54062,
    rankInYear: 7
  },
  {
    title: 'Ricky Rapper and the Bicycle Thief',
    year: 2009,
    imdb: { votes: 149 },
    cumulativeVotesInYear: 54211,
    rankInYear: 8
  },
  {
    title: 'Stingray Sam',
    year: 2009,
    imdb: { votes: 619 },
    cumulativeVotesInYear: 54830,
    rankInYear: 9
  },
  {
    title: 'Anjaana Anjaani',
    year: 2010,
    imdb: { votes: 3576 },
    cumulativeVotesInYear: 3576,
    rankInYear: 1
  },
  {
    title: 'Basilicata Coast to Coast',
    year: 2010,
    imdb: { votes: 1245 },
    cumulativeVotesInYear: 4821,
    rankInYear: 2
  },
  {
    title: 'Camp Rock 2: The Final Jam',
    year: 2010,
    imdb: { votes: 8984 },
    cumulativeVotesInYear: 13805,
    rankInYear: 3
  },
  {
    title: 'Pure Country 2: The Gift',
    year: 2010,
    imdb: { votes: 524 },
    cumulativeVotesInYear: 14329,
    rankInYear: 4
  },
  {
    title: 'Score: A Hockey Musical',
    year: 2010,
    imdb: { votes: 415 },
    cumulativeVotesInYear: 14744,
    rankInYear: 5
  },
  {
    title: 'StarStruck',
    year: 2010,
    imdb: { votes: 6331 },
    cumulativeVotesInYear: 21075,
    rankInYear: 6
  },
  {
    title: 'The Ugly Duckling',
    year: 2010,
    imdb: { votes: 159 },
    cumulativeVotesInYear: 21234,
    rankInYear: 7
  }
]

La tubería precedente:

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

Obtén más información

Volver

$stdDevSamp

$top