$bottom (operador de acumulación)

Valores nulos y faltantes

Considera la siguiente agregación que devuelve el documento más bajo de un grupo de puntuaciones:

• $bottom no filtra los valores nulos.

• $bottom convierte los valores faltantes en null.

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

En este ejemplo:

• $documents crea los documentos literales que contienen las puntuaciones de los jugadores.

• $group agrupa los documentos por gameId. Este ejemplo tiene solo un gameId, G1.

• PlayerD tiene una puntuación faltante y PlayerE tiene un score nulo. Estos valores se consideran ambos nulos.

• Los campos playerId y score se especifican como output : ["$playerId"," $score"] y se devuelven como valores de un arreglo.

• Especifica el orden de clasificación con sortBy: { "score": -1 }.

• PlayerD y PlayerE empató como el elemento inferior. PlayerD se devuelve como la parte inferior score.

• Para tener un comportamiento de empate más determinista para múltiples valores nulos, añada más campos a sortBy.

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

Compatibilidad con funciones de ventana y expresiones de agregación

$bottom no es compatible como expresión de agregación.

$bottom es compatible como un window operator.

Consideraciones sobre el límite de memoria

Las pipelines de agregación que llaman a $bottom están sujetas al límite de 100 MB. Si se supera este límite para un grupo individual, la agregación falla con un error.

Encuentra el fondo Score

Puede usar el acumulador $bottom para encontrar la puntuación más baja en un solo juego.

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

La pipeline de ejemplo:

• Utiliza $match para filtrar los resultados en un solo gameId. En este caso, G1.

• Usa $group para agrupar los resultados por gameId. En este caso, G1.

• Especifica los campos que se muestran para $bottom con output : ["$playerId"," $score"].

• Utiliza sortBy: { "score": -1 } para ordenar los puntajes en orden descendente.

• Utiliza $bottom para devolver la puntuación más baja del juego.

La operación devuelve los siguientes resultados:

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

Encontrar el fondo Score a través de múltiples juegos

Puede utilizar el acumulador $bottom para encontrar el fondo score en cada juego.

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

La pipeline de ejemplo:

• Utiliza $group para agrupar los resultados por gameId.

• Utiliza $bottom para devolver el fondo score para cada juego.

• Especifica los campos que se muestran para $bottom con output : ["$playerId", "$score"].

• Utiliza sortBy: { "score": -1 } para ordenar los puntajes en orden descendente.

La operación devuelve los siguientes resultados:

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