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.

$bottomN (operador acumulador )

$bottomN

Novidades na versão 5.2.

Retorna uma agregação dos elementos n menos importantes dentro de um grupo, de acordo com a ordem de classificação especificada. Se o grupo tiver menos de n elementos, $bottomN retornará todos os elementos no grupo.

Observação

Desambiguação

Esta página descreve $bottomN quando usado como um acumulador. Acumuladores retornam um valor agregado em um grupo de documentos de entrada.

Você também pode usar bottomN nestes outros contextos:

  • $bottomN (window function) retorna os n elementos inferiores de documentos em uma janela específica de acordo com a ordem de classificação especificada.

  • $bottomN (expression operator) retorna os n elementos inferiores de um array de valores de entrada de acordo com a ordem de classificação especificada.

{ $bottomN: { n: <expression>, output: <expression>, sortBy: { <field1>: <sort order>, <field2>: <sort order> ... } }}
Campo
necessidade
Descrição

n

Obrigatório

O número de elementos que $bottomN retorna do grupo. Para um exemplo de configuração dinâmica de n, consulte Defina n dinamicamente com base na chave de grupo.

output

Obrigatório

Determina a saída para cada elemento no grupo. Pode ser qualquer expressão.

sortBy

Obrigatório

Define a ordem de classificação dos elementos dentro de cada grupo, com sintaxe semelhante a $sort. Não afeta a ordem dos documentos na saída do pipeline.

  • $bottomN não filtra valores nulos.

  • $bottomN converte valores ausentes em nulo que são preservados na saída.

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: { $bottomN: { output: [ "$playerId", "$score" ], sortBy: { "score": -1 }, n: 3 } } } }] )

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 um nulo score. Esses valores são considerados nulos.

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

  • Devido ao sortBy: { "score" : -1 }, os valores nulos são classificados no final da array playerId retornada.

[ { _id: "G1", playerId: [ [ "PlayerA", 1 ], [ "PlayerD", null ], [ "PlayerE", null ] ] }]

Ao classificar diferentes tipos, a ordem dos tipos de dados BSON é usada para determinar a ordem. Como exemplo, considere uma collection cujos valores consistem em strings e números.

  • Em uma classificação crescente, os valores de string são classificados após valores numéricos.

  • Em uma classificação decrescente, os valores de string são classificados antes dos valores numéricos.

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

Neste exemplo:

  • PlayerA tem uma pontuação inteira.

  • PlayerB tem uma pontuação de string "2" .

  • PlayerC tem uma pontuação de string vazia.

Como a classificação está em { "score" : -1 } decrescente, os valores literais da string são classificados antes da pontuação numérica PlayerA:

[ { _id: "G1", playerId: [ [ "PlayerB", "2" ], [ "PlayerC", "" ], [ "PlayerA", 1 ] ] }]

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

Você pode usar o acumulador $bottomN para encontrar os três filmes com as avaliações mais baixas no gênero Short.

db.movies.aggregate( [ { $match: { genres: "Short", "imdb.rating": { $exists: true } } }, { $group: { _id: "Short", lowestRatedMovies: { $bottomN: { output: [ "$title", "$imdb.rating" ], sortBy: { "imdb.rating": -1, title: 1 }, n: 3 } } } }] )

O exemplo de pipeline:

  • Usa $match para restringir a entrada a Short filmes que incluem um valor imdb.rating.

  • Usa $group para colocar os filmes correspondentes em um único grupo Short.

  • Usa sortBy: { "imdb.rating": -1, title: 1 } para classificar filmes por avaliação e usa title como critério de desempate.

  • Especifica os campos retornados por $bottomN com output: [ "$title", "$imdb.rating" ].

  • Usa $bottomN para retornar os três filmes correspondentes inferiores com n: 3.

Você pode usar o acumulador $bottomN para encontrar os filmes menos avaliados para cada gênero.

db.movies.aggregate( [ { $unwind: "$genres" }, { $match: { "imdb.rating": { $exists: true } } }, { $group: { _id: "$genres", lowestRatedMovie: { $bottomN: { output: [ "$title", "$imdb.rating" ], sortBy: { "imdb.rating": -1, title: 1 }, n: 3 } } } }, { $sort: { _id: 1 } }, { $limit: 5 }] )

O exemplo de pipeline:

  • Usa $unwind para expandir o array genres de cada filme.

  • Utiliza $match para manter apenas documentos que incluem um valor imdb.rating.

  • Utiliza $group para agrupar os resultados por gênero.

  • Especifica os campos retornados por $bottomN com output: [ "$title", "$imdb.rating" ].

  • Usa sortBy: { "imdb.rating": -1, title: 1 } para classificar filmes por avaliação e usa title como um desempate determinístico.

  • Usa $bottomN para retornar os três filmes com menor classificação para cada gênero com n: 3.

  • Usa $sort e $limit para mostrar os cinco primeiros gêneros em ordem alfabética.

Você pode atribuir o valor de n dinamicamente. O exemplo a seguir usa a $cond expressão para retornar diferentes números de filmes com base na classificação de conteúdo.

db.movies.aggregate([ { $match: { rated: { $in: [ "G", "PG", "PG-13", "R" ] }, "imdb.rating": { $exists: true } } }, { $group: { _id: { rated: "$rated" }, movies: { $bottomN: { output: { title: "$title", rating: "$imdb.rating" }, n: { $cond: { if: { $eq: [ "$rated", "PG" ] }, then: 3, else: 1 } }, sortBy: { "imdb.rating": -1 } } } } }, { $sort: { "_id.rated": 1 } }] )

O exemplo de pipeline:

  • Usa $match para manter apenas filmes com classificações de conteúdo G, PG, PG-13 ou R que incluem um valor imdb.rating.

  • Utiliza $group para agrupar os resultados por classificação de conteúdo com _id: { rated: "$rated" }.

  • Especifica os campos retornados por $bottomN com output: { title: "$title", rating: "$imdb.rating" }.

  • Se a classificação do conteúdo for PG, então n será 3. Caso contrário, n é 1.

  • Usa sortBy: { "imdb.rating": -1 } para encontrar os n piores filmes com base na classificação do IMDb.

  • Classifica os resultados alfabeticamente pela classificação de conteúdo.