/ /

$sum (função de janela)

Definição

$sum

Retorna a soma de valores numéricos de documentos em uma janela específica.

Observação

Outros usos de $sum

Esta página descreve $sum quando usado como uma função de janela.

Você também pode usar $sum nestes outros contextos:

$sum (accumulator), que retorna a soma coletiva de valores numéricos em um grupo de documentos.
$sum (expression), que retorna a soma de valores numéricos em uma array.

Sintaxe

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

Comportamento

Tipo de resultado

Quando os tipos de entrada são mistos, $sum promove o tipo de entrada menor para o maior dos dois. Um tipo é considerado maior quando representa uma faixa de valores mais ampla. A ordem dos tipos numéricos do menor para o maior é: inteiro → longo → duplo → decimal.

O maior dos tipos de entrada também determina o tipo de resultado, a menos que a operação se exceda e esteja além da faixa representada por esse tipo de dados maior. Em casos de excesso, $sum promove o resultado de acordo com a seguinte ordem:

Se o tipo de entrada maior for integer, o tipo de resultado será promovido para long.
Se o tipo de entrada maior for long, o tipo de resultado será promovido para double.
Se o tipo maior for double ou decimal, o resultado de transbordamento será representado como infinito positivo ou negativo. Não há nenhum tipo de promoção do resultado.

Valores nulos ou ausentes

Se alguns documentos na janela tiverem um valor null para o campo ou estiverem faltando o campo, $sum ignorará esses valores e somará os valores restantes.

Se todos os documentos na janela tiverem um valor null para o campo ou estiverem faltando o campo, $sum retornará 0.

Exemplo

Os exemplos nesta página usam dados do conjunto de dados sample_mflix. Para obter detalhes sobre como carregar esse conjunto de dados em sua implantação autogerenciada do MongoDB , consulte Carregar o conjunto de dados de amostra. Se você fez modificações nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.

Este exemplo usa $setWindowFields para calcular um total de votos cumulativos em execução para cada filme Universal de 2009 e 2010. Cada documento recebe o valor $sum calculado desde o início de sua partição anual até o documento atual.

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
  }
]

O pipeline anterior:

Usa $match para filtrar filmes músicas de 2009 e 2010 com uma classificação numérica do IMDb e pelo menos um voto.
Utiliza $setWindowFields para dividir filmes por year e classificá-los por title. O estágio usa $sum com uma janela de documentos de [ "unbounded", "current" ] para criar os seguintes campos para cada documento:
- cumulativeVotesInYear: a soma cumulativa em execução de imdb.votes.
- rankInYear: um número de linha por partição atribuído por $documentNumber.
Utiliza $project para incluir title, year, imdb.votes, cumulativeVotesInYear e rankInYear na saída.
Utiliza $sort para classificar os resultados por ano e título.

Saiba mais

Voltar

$stdDevSamp

$top