Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

$lastN (operador acumulador )

$lastN

Retorna o resultado de avaliar uma expressão especificada para os últimos n elementos em um grupo. Os resultados só são significativos se os dados de entrada para o estágio de agrupamento tiverem uma ordem de classificação definida. Se o grupo tiver menos de n elementos, $lastN retornará todos os elementos no grupo.

O acumulador $lastN está disponível nestes estágios:

Observação

Desambiguação

Esta página descreve $lastN quando usado como um acumulador. Acumuladores retornam um valor agregado como soma, máximo ou mínimo em um grupo de documentos de entrada.

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

{
$lastN:
{
input: <expression>,
n: <expression>
}
}
Campo
Tipo
Descrição

input

Expressão

A expressão input é avaliada em cada documento no grupo de entrada, e os últimos n resultados são preservados.

n

Expressão

The number of elements that $lastN returns from the group. For an example of setting n dynamically based on the group key, see Set n Based on the Group Key.

  • $lastN não filtra valores nulos.

  • $lastN converte valores ausentes em nulo.

Você pode usar $lastN e $bottomN para retornar os últimos n elementos de um grupo. No entanto, a diferença entre quando usar cada um depende de se seus documentos de entrada já estão ordenados.

  • Se os documentos que chegam a $group já estiverem ordenados, você deverá usar $lastN.

  • Se você estiver classificando e selecionando os elementos n inferiores, poderá usar $bottomN para realizar ambas as tarefas com um acumulador.

The examples on this page use the movies collection in the sample_mflix sample dataset. To learn how to load the sample dataset into your MongoDB deployment, see Import Sample Data Into Your Atlas Deployment.

Você pode usar o acumulador $lastN para encontrar os filmes lançados mais recentemente em um gênero específico.

db.movies.aggregate( [
{
$match: { genres: "Horror", year: { $type: "int" } }
},
{
$sort: { year: 1, title: 1 }
},
{
$group:
{
_id: "Horror",
lastThreeMovies:
{
$lastN:
{
input: [ "$title", "$year" ],
n: 3
}
}
}
}
] )

O pipeline anterior:

  • Usa $match para filtro os resultados para filmes onde Horror está incluído no array genres e onde year é um número inteiro.

  • Ordena os resultados por year em ordem crescente e, em seguida, por title em ordem alfabética como critério de desempate.

  • Agrupa todos os documentos resultantes em um único grupo.

  • Especifica os campos que são entrada para $lastN com input : ["$title", "$year"].

  • Usa $lastN para retornar os três últimos documentos (classificados por ano em ordem crescente, com title como critério de desempate) para o gênero Horror com n: 3.

Você pode usar o acumulador $lastN para encontrar os últimos n campos de entrada em cada gênero.

db.movies.aggregate( [
{
$match: { year: { $type: "int" } }
},
{
$unwind: "$genres"
},
{
$sort: { year: 1, title: 1 }
},
{
$group:
{
_id: "$genres",
movies:
{
$lastN:
{
input: [ "$title", "$year" ],
n: 3
}
}
}
},
{ $sort: { _id: 1 } },
{ $limit: 5 }
] )

O pipeline anterior:

  • Usa $match como filtro para filmes onde year é um número inteiro.

  • Usa $unwind para criar um documento separado para cada gênero no array genres.

  • Classifica os resultados por year em ordem crescente e, em seguida, por title alfabeticamente.

  • Utiliza $group para agrupar os resultados por genres.

  • Usa $lastN para retornar os três últimos documentos (por ano crescente, com title como critério de desempate) para cada gênero com n: 3.

  • Especifica os campos que são entrada para $lastN com input : ["$title", "$year"].

  • Limita a saída a cinco documentos para melhorar a legibilidade.

Você pode atribuir o valor de n dinamicamente com base na chave do grupo. Neste exemplo, a expressão $cond usa o campo rated para alterar o valor de n:

db.movies.aggregate( [
{
$match: {
rated: { $in: [ "G", "PG", "PG-13", "R" ] },
year: { $type: "int" },
title: { $regex: "^[A-Za-z0-9]" }
}
},
{ $sort: { title: 1 } },
{
$group:
{
_id: { rated: "$rated" },
movies:
{
$lastN:
{
input: "$title",
n: { $cond: { if: { $eq: ["$rated", "PG"] }, then: 3, else: 1 } }
}
}
}
},
{ $sort: { "_id.rated": 1 } }
] )

O pipeline anterior:

  • Filtros para filmes com classificações de conteúdo de G, PG, PG-13 ou R, onde year é um número inteiro e title começa com um caractere alfanumérico.

  • Ordena os resultados alfabeticamente por title.

  • Agrupa filmes por rated (a classificação indicativa).

  • Usa a expressão $cond para retornar 3 filmes para filmes com classificação PGe 1 filme para todas as outras classificações.

Na saída, a classificação PG retorna 3 filmes, enquanto as classificações G, PG-13 e R retornam 1 filme cada.