$bottom (aggregation accumulator)

Valores nulos e ausentes

Consider the following aggregation that returns the bottom document from a group of scores:

• $bottom não filtra valores nulos.

• $bottom converte valores ausentes em nulo.

db.aggregate( [
   {
      $documents: [
         { playerId: "PlayerA", gameId: "G1", score: 1 },
         { playerId: "PlayerB", gameId: "G1", score: 2 },
         { playerId: "PlayerC", gameId: "G1", score: 3 },
         { playerId: "PlayerD", gameId: "G1"},
         { playerId: "PlayerE", gameId: "G1", score: null }
      ]
   },
   {
      $group:
      {
         _id: "$gameId",
         playerId:
            {
               $bottom:
                  {
                     output: [ "$playerId", "$score" ],
                     sortBy: { "score": -1 }
                  }
            }
      }
   }
] )

Neste exemplo:

• $documents cria os documentos literais que contêm as pontuações dos jogadores.

• $group agrupa os documentos por gameId. Este exemplo tem apenas um gameId, G1.

• PlayerD tem uma pontuação ausente e PlayerE tem uma score nula. Estes valores são considerados nulos.

• Os campos playerId e score são especificados como output : ["$playerId"," $score"] e retornados como valores de array.

• Especifique a ordem de classificação com sortBy: { "score": -1 }.

• PlayerD and PlayerE tied for the bottom element. PlayerD is returned as the bottom score.

• Para ter um comportamento de quebra de vínculo mais determinístico para vários valores nulos, adicione mais campos ao sortBy.

[
   {
      _id: 'G1',
      playerId: [ 'PlayerD', null ]
   }
]

Suporte para função de janela e expressão de agregação

$bottom não é aceito como uma expressão de aggregation.

$bottom é suportado como window operator.

Considerações sobre o limite de memória

Os pipelines de agregação que chamam $bottom estão sujeitos ao limite de 100 MB. Se esse limite for excedido para um grupo individual, a agregação falhará com um erro.

Find the Bottom Score

You can use the $bottom accumulator to find the bottom score in a single game.

db.gamescores.aggregate( [
   {
      $match : { gameId : "G1" }
   },
   {
      $group:
         {
            _id: "$gameId",
            playerId:
               {
                  $bottom:
                  {
                     output: [ "$playerId", "$score" ],
                     sortBy: { "score": -1 }
                  }
               }
         }
   }
] )

O exemplo de pipeline:

• Utiliza $match para filtrar os resultados em um único gameId. Neste caso, G1.

• Utiliza $group para agrupar os resultados por gameId. Neste caso, G1.

• Especifica os campos que são de saída para $bottom com output : ["$playerId"," $score"].

• Utiliza sortBy: { "score": -1 } para classificar as pontuações em ordem decrescente.

• Uses $bottom to return the bottom score for the game.

A operação retorna os seguintes resultados:

[ { _id: 'G1', playerId: [ 'PlayerD', 1 ] } ]

Finding the Bottom Score Across Multiple Games

You can use the $bottom accumulator to find the bottom score in each game.

db.gamescores.aggregate( [
      {
         $group:
         { _id: "$gameId", playerId:
            {
               $bottom:
                  {
                     output: [ "$playerId", "$score" ],
                     sortBy: { "score": -1 }
                  }
            }
         }
      }
] )

O exemplo de pipeline:

• Utiliza $group para agrupar os resultados por gameId.

• Uses $bottom to return the bottom score for each game.

• Especifica os campos que são de saída para $bottom com output : ["$playerId", "$score"].

• Utiliza sortBy: { "score": -1 } para classificar as pontuações em ordem decrescente.

A operação retorna os seguintes resultados:

[
   { _id: 'G2', playerId: [ 'PlayerA', 10 ] },
   { _id: 'G1', playerId: [ 'PlayerD', 1 ] }
]