Definición
Nuevo en la versión 5.2.
$lastN Puede usarse como acumulador de agregación u operador de matriz. Como acumulador de agregación, agrega los últimos n elementos de un grupo. Como operador de matriz, devuelve el número especificado de elementos desde el final de una matriz.
Acumulador de agregación
Cuando se utiliza $lasttN como acumulador de agregación, los elementos devueltos solo son significativos si siguen un orden de clasificación específico. Si el grupo contiene menos de n elementos, $lastN devuelve todos los elementos del grupo.
Sintaxis
{ $lastN: { input: <expression>, n: <expression> } }
inputEspecifica el/los campo(s) del documento del que se tomará el últimon. La entrada puede ser cualquier expresión.ntiene que ser una expresión integral positiva que sea una constante o dependa del valor_idpara$group. Para más detalles, véase Ejemplo de clave de grupo.
Comportamiento
Valores nulos y faltantes
$lastNno filtra valores nulos.$lastNConvierte los valores faltantes en nulos.
Considere la siguiente agregación que devuelve los últimos cinco documentos de un grupo:
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", lastFiveScores: { $lastN: { input: "$score", n: 5 } } } } ] )
En este ejemplo:
$documentscrea los documentos literales que contienen las puntuaciones de los jugadores.$groupagrupa los documentosgameIdpor. Este ejemplo solo tiene un,.gameIdG1PlayerDtiene una puntuación faltante yPlayerEtiene un valor nuloscore. Ambos valores se consideran nulos.El campo
lastFiveScoresse especifica utilizandoinput : "$score"y se devuelve como una matriz.Dado que no hay criterios de clasificación, se devuelven los últimos 5
scorecampos.
[ { _id: "G1", lastFiveScores: [ 1, 2, 3, null, null ] } ]
Comparación de $lastN y $bottomN
Los acumuladores $lastN y $bottomN pueden lograr resultados similares.
En general:
Si los documentos que llegan a ya están ordenados,
$groupdebes$lastNutilizar.Si está ordenando y seleccionando los elementos inferiores
n, puede usar$bottomNpara realizar ambas tareas con un acumulador.$lastNse puede utilizar como expresión de agregación,$bottomNno.
Restricciones
Compatibilidad con funciones de ventana y expresiones de agregación
$lastN se admite como expresión de agregación.
$lastN se admite window operator como.
Ejemplos
Considera una colección gamescores con los siguientes documentos:
db.gamescores.insertMany([ { playerId: "PlayerA", gameId: "G1", score: 31 }, { playerId: "PlayerB", gameId: "G1", score: 33 }, { playerId: "PlayerC", gameId: "G1", score: 99 }, { playerId: "PlayerD", gameId: "G1", score: 1 }, { playerId: "PlayerA", gameId: "G2", score: 10 }, { playerId: "PlayerB", gameId: "G2", score: 14 }, { playerId: "PlayerC", gameId: "G2", score: 66 }, { playerId: "PlayerD", gameId: "G2", score: 80 } ])
Encuentra las puntuaciones de los últimos tres jugadores de un mismo juego
Puedes usar el acumulador $lastN para encontrar los últimos tres puntajes en un solo juego.
db.gamescores.aggregate( [ { $match : { gameId : "G1" } }, { $group: { _id: "$gameId", lastThreeScores: { $lastN: { input: ["$playerId", "$score"], n:3 } } } } ] )
El ejemplo de canalización:
Utiliza para filtrar los resultados según un
$matchúnico.gameIdEn esteG1caso,.Usa para agrupar los
$groupresultadosgameIdpor. En esteG1caso,.Especifica los campos que se generan desde
$lastNconoutput : ["$playerId"," $score"].Utiliza
$lastNpara devolver los últimos tres documentos del juegoG1conn : 3.
La operación devuelve los siguientes resultados:
[ { _id: "G1", lastThreeScores: [ [ "PlayerB", 33 ], [ "PlayerC", 99 ], [ "PlayerD", 1 ] ] } ]
Cómo encontrar las puntuaciones de los tres últimos jugadores en varios juegos
Puedes utilizar el acumulador $lastN para encontrar los últimos n campos de entrada en cada juego.
db.gamescores.aggregate( [ { $group: { _id: "$gameId", playerId: { $lastN: { input: [ "$playerId","$score" ], n: 3 } } } } ] )
El ejemplo de canalización:
Utiliza
$grouppara agrupar los resultados porgameId.Utiliza
$lastNpara devolver los últimos tres documentos de cada juego conn: 3.Especifica los campos que se ingresan para
$lastNconinput : ["$playerId", "$score"].
La operación devuelve los siguientes resultados:
[ { _id: 'G2', playerId: [ [ 'PlayerB', 14 ], [ 'PlayerC', 66 ], [ 'PlayerD', 80 ] ] }, { _id: 'G1', playerId: [ [ 'PlayerB', 33 ], [ 'PlayerC', 99 ], [ 'PlayerD', 1 ] ] } ]
Usando $sort con $lastN
Utilizar una etapa $sort anterior en la pipeline puede influir en los resultados del acumulador $lastN.
En este ejemplo:
{$sort : { score : -1 } }Ordena las puntuaciones más altas al final de cada grupo.lastNdevuelve las tres puntuaciones más bajas del final de cada grupo.
db.gamescores.aggregate( [ { $sort : { score : -1 } }, { $group: { _id: "$gameId", playerId: { $lastN: { input: [ "$playerId","$score" ], n: 3 } } } } ] )
La operación devuelve los siguientes resultados:
[ { _id: 'G2', playerId: [ [ 'PlayerC', 66 ], [ 'PlayerB', 14 ], [ 'PlayerA', 10 ] ] }, { _id: 'G1', playerId: [ [ 'PlayerB', 33 ], [ 'PlayerA', 31 ], [ 'PlayerD', 1 ] ] } ]
Cálculo n de según la clave de grupo para $group
También puede asignar el valor n dinámicamente. En este ejemplo,$cond se utiliza la expresión en el gameId campo.
db.gamescores.aggregate([ { $group: { _id: {"gameId": "$gameId"}, gamescores: { $lastN: { input: "$score", n: { $cond: { if: {$eq: ["$gameId","G2"] }, then: 1, else: 3 } } } } } } ] )
El ejemplo de canalización:
Utiliza
$grouppara agrupar los resultados porgameId.Especifica los campos que se ingresan para
$lastNconinput : "$score".Si
gameIdesG2entoncesnes 1, de lo contrariones 3.
La operación devuelve los siguientes resultados:
[ { _id: { gameId: "G1" }, gamescores: [ 33, 99, 1 ] }, { _id: { gameId: "G2" }, gamescores: [ 80 ] } ]
Uso de $lastN como expresión de agregación
También puedes utilizar $lastN como expresión de agregación.
En este ejemplo:
$documentscrea el documento literal que contiene una matriz de valores.$projectse utiliza para devolver la salida de$lastN._idse omite de la salida con_id : 0.$lastNutiliza la matriz de entrada de[10, 20, 30, 40].Se devuelven los últimos tres elementos de la matriz para el documento de entrada.
db.aggregate( [ { $documents: [ { array: [10, 20, 30, 40] } ] }, { $project: { lastThreeElements:{ $lastN: { input: "$array", n: 3 } } } } ] )
La operación devuelve los siguientes resultados:
[ { lastThreeElements: [ 20, 30, 40 ] } ]
Operador de arreglos
Sintaxis
$lastN tiene la siguiente sintaxis:
{ $lastN: { n: <expression>, input: <expression> } }
Comportamiento
$lastNdevuelve elementos en el mismo orden en que aparecen en la matriz de entrada.$lastNno filtranulllos valores en la matriz de entrada.No se puede especificar un valor de
nmenor que1.Si el especificado
nes mayor o igual que la cantidad de elementos en lainputmatriz, devuelve$lastNlainputmatriz.Si
inputse resuelve en un valor que no es una matriz, la operación de agregación genera un error.
Ejemplo
La colección games tiene los siguientes documentos:
db.games.insertMany([ { "playerId" : 1, "score" : [ 1, 2, 3 ] }, { "playerId" : 2, "score" : [ 12, 90, 7, 89, 8 ] }, { "playerId" : 3, "score" : [ null ] }, { "playerId" : 4, "score" : [ ] }, { "playerId" : 5, "score" : [ 1293, null, 3489, 9 ]}, { "playerId" : 6, "score" : [ "12.1", 2, Long("2090845886852"), 23 ]} ])
El siguiente ejemplo utiliza el operador para recuperar las tres últimas puntuaciones de cada jugador. Las puntuaciones se devuelven en el nuevo $lastN campo lastScores creado $addFields por.
db.games.aggregate([ { $addFields: { lastScores: { $lastN: { n: 3, input: "$score" } } } } ])
La operación devuelve los siguientes resultados:
[{ "playerId": 1, "score": [ 1, 2, 3 ], "lastScores": [ 1, 2, 3 ] }, { "playerId": 2, "score": [ 12, 90, 7, 89, 8 ], "lastScores": [ 7, 89, 8 ] }, { "playerId": 3, "score": [ null ], "lastScores": [ null ] }, { "playerId": 4, "score": [ ], "lastScores": [ ] }, { "playerId": 5, "score": [ 1293, null, 3489, 9 ], "lastScores": [ null, 3489, 9 ] }, { "playerId": 6, "score": [ "12.1", 2, Long("2090845886852"), 23 ], "lastScores": [ 2, Long("2090845886852"), 23 ] }]