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.
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Menu Docs

$bottom (função de janela)

$bottom

Novidades na versão 5.2.

Retorna o elemento inferior de uma janela de acordo com a ordem de classificação especificada.

Observação

Desambiguação

Esta página descreve $bottom quando usado como uma função de janela. Você também pode usar o $bottom (accumulator), que retorna o elemento inferior dentro de um grupo de acordo com a ordem de classificação especificada.

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

sortBy

Obrigatório

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

saída

Obrigatório

Especifica a saída para cada elemento na janela. Pode ser qualquer expressão.

  • $bottom não filtra valores nulos.

  • $bottom converte valores ausentes em nulo.

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

Este exemplo usa $bottom como uma função de janela para calcular a classificação do documento atual em relação ao filme com classificação mais baixa no mesmo ano. Cada documento de filme contém a classificação do filme e um campo calculado que mostra o quão alta é a classificação do filme em comparação com o filme com classificação mais baixa do mesmo ano.

db.movies.aggregate( [
{
$match: {
year: { $in: [ 1980, 1981, 1982 ] },
"imdb.rating": { $exists: true, $ne: null },
genres: "Family",
rated: "PG"
}
},
{
$setWindowFields: {
partitionBy: "$year",
output: {
lowestRatedInYear: {
$bottom: {
output: { title: "$title", rating: "$imdb.rating" },
sortBy: { "imdb.rating": -1 }
},
window: {
documents: [ "unbounded", "unbounded" ]
}
}
}
}
},
{
$project: {
_id: 0,
title: 1,
year: 1,
rating: "$imdb.rating",
lowestRatedInYear: 1,
ratingAboveWorst: {
$subtract: [ "$imdb.rating", "$lowestRatedInYear.rating" ]
}
}
},
{
$limit: 10
}
] )

Neste exemplo:

  • O estágio $match filtra filmes para família com classificação PG de 1980 a 1982.

  • $setWindowFields divide os documentos por year.

  • A janela se estende de unbounded a unbounded, o que significa que $bottom considera todos os documentos na partição ao determinar o filme com classificação mais baixa.

  • $bottom retorna o filme de classificação mais baixa em cada partição como um documento incorporado contendo os campos title e rating.

  • $project calcula ratingAboveWorst subtraindo a classificação mais baixa da classificação de cada filme, mostrando o quanto cada filme está classificado acima do pior desempenho do ano.

  • $limit limita a saída a 10 documentos.

Essa abordagem preserva todos os documentos individuais do filme e inclui uma comparação de cada um com o pior desempenho de seu ano.