$maxN (aggregation accumulator)
定義
構文
{ $maxN: { input: <expression>, n: <expression> } }
input
specifies an expression that is the input to$maxN
. It is evaluated for each element in the group and$maxN
preserves the maximumn
values.n
limits the number of results per group andn
has to be a positive integral expression that is either a constant or depends on the_id
value for$group
.
動作
結果の型
$maxN
は BSON 比較の順序に従って入力データを比較し、適切な出力型を決定します。入力データに複数のデータ型が含まれている場合、$maxN
出力型は比較順序で最も高くなります。
NULL および欠損値
$maxN
filters out null and missing values.
Consider the following aggregation that returns the maximum n
documents from a group:
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", maximumThreeScores: { $maxN: { input: "$score", n: 4 } } } } ] )
この例では、次のことが行われます。
$documents
は、プレイヤーのスコアを含むリテラル ドキュメントを作成します。$group
はドキュメントをgameId
でグループ化します。 この例ではgameId
、G1
は 1 つのみです。PlayerD
にはスコアがあり、PlayerE
には nullscore
があります。 これらの値は両方とも null と見なされます。The
maximumThreeScores
field is specified as$maxN
withinput : "$score"
and returned as an array.Since there are only 3 documents with
scores
maxN
returns the maximum 3score
fields even thoughn = 4
.
[ { _id: 'G1', maximumThreeScores: [ 3, 2, 1 ] } ]
Comparison of $maxN
and $topN
Accumulators
Both $maxN
and $topN
accumulators can accomplish similar
results.
In general:
制限事項
ウィンドウ関数と集計式のサポート
You can use $maxN
as an accumulator.
$maxN
is supported as an
aggregation expression.
$maxN
is supported as a
window operator
.
メモリ制限に関する考慮事項
$maxN
を呼び出す集計パイプラインには100 MB の制限が適用されます。 個々のグループでこの制限を超えると、集計はエラーで失敗します。
例
以下のドキュメントを持つgamescores
コレクションを考えてみましょう。
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 } ])
Find the Maximum Three Scores
for a Single Game
You can use the $maxN
accumulator to find the maximum three scores
in a single game.
db.gamescores.aggregate( [ { $match : { gameId : "G1" } }, { $group: { _id: "$gameId", maxThreeScores: { $maxN: { input: ["$score","$playerId"], n:3 } } } } ] )
サンプル パイプライン:
$match
を使用して結果を単一のgameId
でフィルタリングします。 この場合は、G1
ます。$group
を使用して結果をgameId
でグループ化します。 この場合は、G1
ます。Specifies the fields that are input for
$maxN
withinput : ["$score","$playerId"]
.Uses
$maxN
to return the maximum three score elements for theG1
game withn : 3
.
この操作は次の結果を返します。
[ { _id: 'G1', maxThreeScores: [ [ 99, 'PlayerC' ], [ 33, 'PlayerB' ], [ 31, 'PlayerA' ] ] } ]
Finding the Maximum Three Scores Across Multiple Games
You can use the $maxN
accumulator to find the maximum n
scores in each game.
db.gamescores.aggregate( [ { $group: { _id: "$gameId", maxScores: { $maxN: { input: ["$score","$playerId"], n: 3 } } } } ] )
サンプル パイプライン:
$group
を使用して結果をgameId
でグループ化します。Uses
$maxN
to return the maximum three score elements for each game withn: 3
.Specifies the fields that are input for
$maxN
withinput: ["$score","$playerId"]
.
この操作は次の結果を返します。
[ { _id: 'G1', maxScores: [ [ 99, 'PlayerC' ], [ 33, 'PlayerB' ], [ 31, 'PlayerA' ] ] }, { _id: 'G2', maxScores: [ [ 80, 'PlayerD' ], [ 66, 'PlayerC' ], [ 14, 'PlayerB' ] ] } ]
$group
のグループキーに基づいてn
を計算
また、 n
の値を動的に割り当てることもできます。 この例では、 $cond
式はgameId
フィールドで使用されています。
db.gamescores.aggregate([ { $group: { _id: {"gameId": "$gameId"}, gamescores: { $maxN: { input: ["$score","$playerId"], n: { $cond: { if: {$eq: ["$gameId","G2"] }, then: 1, else: 3 } } } } } } ] )
サンプル パイプライン:
$group
を使用して結果をgameId
でグループ化します。Specifies the fields that input for
$maxN
withinput : ["$score","$playerId"]
.gameId
がG2
の場合、n
は 1、それ以外の場合、n
は 3 になります。
この操作は次の結果を返します。
[ { _id: { gameId: 'G2' }, gamescores: [ [ 80, 'PlayerD' ] ] }, { _id: { gameId: 'G1' }, gamescores: [ [ 99, 'PlayerC' ], [ 33, 'PlayerB' ], [ 31, 'PlayerA' ] ] } ]