Docs Menu
Docs Home
/
MongoDB マニュアル
/
集計操作
/
参照
/
演算子

$maxN（配列演算子）

項目一覧

  • 定義
  • 構文
  • 動作
  • 例

定義

$maxN

バージョン 5.2 で追加。

配列内の n つの最大値を返します。

Tip

以下も参照してください。

$minN

構文

$maxN の構文は次のとおりです。

{ $maxN: { n: <expression>, input: <expression> } }
フィールド
説明
n
正の整数に解決される式。 整数は、 $maxNが返す配列要素の数を指定します。
input
最大 個のn要素を返す配列に解決される式。

動作

  • 1 nの値は指定できません。

  • $maxNは、 input配列にあるnull値をフィルタリングします。

  • 指定されたnがinput配列内の要素数以上の場合、 $maxNはinput配列内のすべての要素を返します。

  • inputが配列以外の値に解決される場合、集計操作はエラーになります。

  • inputに数値要素と string 要素の両方が含まれている場合、string 要素はBSON 比較順序に従って数値要素の前にソートされます。

例

次のドキュメントを使用して scores コレクションを作成します。

db.scores.insertMany([
    { "playerId" : 1, "score" : [ 1, 2, 3 ] },
    { "playerId" : 2, "score" : [ 12, 90, 7, 89, 8 ] },
    { "playerId" : 3, "score" : [ null ] },
    { "playerId" : 4, "score" : [ ] }
    { "playerId" : 5, "score" : [ 1293, "2", 3489, 9 ]}
])

次の例では、 $maxN演算子を使用して、各プレイヤーの最高のスコアを 2 つ検索します。 最高スコアは、 $addFieldsによって作成された新しいフィールドmaxScoresに返されます。

db.scores.aggregate([
   { $addFields: { maxScores: { $maxN: { n: 2, input: "$score" } } } }
])

この操作は次の結果を返します。

[{
  "playerId": 1,
  "score": [ 1, 2, 3 ],
  "maxScores": [ 3, 2 ]
},
{
  "playerId": 2,
  "score": [ 12, 90, 7, 89, 8 ],
  "maxScores": [ 90, 89 ]
},
{
  "playerId": 3,
  "score": [ null ],
  "maxScores": [ ]
},
{
  "playerId": 4,
  "score": [ ],
  "maxScores": [ ]
},
{
  "playerId": 5,
  "score": [ 1293, "2", 3489, 9 ],
  "maxScores": [ "2", 3489 ]
}]

戻る

$maxN