Menu Docs

Página inicial do DocsDesenvolver aplicaçõesManual do MongoDB

$bottom (acúmulo de agregação)

Nesta página

  • Definição
  • Sintaxe
  • Comportamento
  • Restrições
  • Exemplos
$bottom

Novidades na versão 5,2.

Retorna o elemento inferior de um grupo de acordo com a ordem de classificação especificada.

{
$bottom:
{
sortBy: { <field1>: <sort order>, <field2>: <sort order> ... },
output: <expression>
}
}
Campo
necessidade
Descrição
sortBy
Obrigatório
Especifica a ordem dos resultados, com sintaxe semelhante a $sort.
saída
Obrigatório
Representa a saída de cada elemento no grupo e pode ser qualquer expressão.

Considere a seguinte agregação que retorna o documento inferior de um grupo de pontuações:

  • $bottom não filtra valores nulos.

  • $bottom converte valores ausentes em nulo.

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

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.

  • Especifique a ordem de classificação com sortBy: { "score": -1 }.

  • PlayerD e PlayerE empatado para o elemento inferior. PlayerD é retornado como o score inferior.

  • Para ter um comportamento de quebra de vínculo mais determinístico para vários valores nulos, adicione mais campos a ''Ordenar por''.

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

$bottom não é suportado como uma expressão de agregação.

$bottom é suportado como um window operator.

Os pipelines de agregação que chamam $bottom estão sujeitos ao limite de 100 MB. Se esse limite for excedido para um grupo individual, a agregação falhará com um erro.

Considere uma collection gamescores com os seguintes 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 }
])

Você pode usar o acumulador $bottom para encontrar a pontuação mais baixa em um único jogo.

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

O exemplo de pipeline:

  • Utiliza $match para filtrar os resultados em um único gameId. Neste caso, G1.

  • Utiliza $group para agrupar os resultados por gameId. Neste caso, G1.

  • Especifica os campos que são de saída para $bottom com output : ["$playerId"," $score"].

  • Utiliza sortBy: { "score": -1 } para classificar as pontuações em ordem decrescente.

  • Usa $bottom para retornar a pontuação inferior do jogo.

A operação retorna os seguintes resultados:

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

Você pode usar o acumulador de $bottom para encontrar o score inferior em cada jogo.

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

O exemplo de pipeline:

  • Utiliza $group para agrupar os resultados por gameId.

  • Usa $bottom para retornar o score inferior para cada jogo.

  • Especifica os campos que são de saída para $bottom com output : ["$playerId", "$score"].

  • Utiliza sortBy: { "score": -1 } para classificar as pontuações em ordem decrescente.

A operação retorna os seguintes resultados:

[
{ _id: 'G2', playerId: [ 'PlayerA', 10 ] },
{ _id: 'G1', playerId: [ 'PlayerD', 1 ] }
]
← $bitXor (agregação)