/ /

$bottomN（アキュムレータ演算子）

定義

$bottomN: バージョン5.2の新機能。
指定ソート順に従って、グループ内の最下位のn要素の集計を返します。グループに含まれる要素がn未満の場合、 $bottomNはグループ内のすべての要素を返します。

注意

曖昧さ回避

このページでは、$bottomN をアキュムレータとして使用する場合について説明します。アキュムレータは、入力ドキュメントのグループ全体で集計値を返します。

bottomN は、これらの他のコンテキストでも使用できます。

指定されたソート順に従って、$bottomN (window function) は特定のウィンドウ内のドキュメントから最下位の n 個の要素を返します。
$bottomN (expression operator) は、指定ソート順に従って、入力値の配列から最下位のn個の要素を返します。

構文

{
   $bottomN:
      {
         n: <expression>,
         output: <expression>,
         sortBy: { <field1>: <sort order>, <field2>: <sort order> ... }
      }
}

オプション

フィールド	必要性	説明
`n`	必須	The number of elements that `$bottomN` returns from the group. For an example of setting n dynamically, see Set n Dynamically Based on the Group Key.
`output`	必須	グループ内の各要素に対する出力を決定します。任意の式を指定できます。
`sortBy`	必須	各グループ内の要素のランキング順序を定義します。構文は、`$sort` に似ています。パイプライン出力のドキュメントの順序には影響しません。

動作

NULL および欠損値

$bottomN は、null 値をフィルタリングで除外しません。
$bottomN は、出力に保持される欠落値を null に変換します。

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

この例では、次のことが行われます。

$documents は、プレイヤーのスコアを含むリテラルドキュメントを作成します。
$groupはドキュメントをgameIdでグループ化します。この例ではgameId 、 G1は 1 つのみです。
PlayerD はスコアが欠落しており、 PlayerEには null scoreがあります。これらの値は両方とも null と見なされます。
playerIdフィールドとscoreフィールドはoutput : ["$playerId"," $score"]として指定され、配列値として返されます。
sortBy: { "score" : -1 }により、null 値は返されたplayerId配列の末尾にソートされます。

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

BSON データ型ソート順

異なるタイプをソートする場合、順序を決定するためにBSON データ型の順序が使用されます。例として、値が string と数値で構成されるコレクションを考えてみましょう。

昇順ソートでは、string 値は数値の後にソートされます。
降順ソートでは、string 値が数値の前にソートされます。

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

この例では、次のことが行われます。

PlayerA は整数スコアを持ちます。
PlayerB は string "2"スコアを持ちます。
PlayerC には空のstringスコアがあります。

並べ替えは{ "score" : -1 }の降順であるため、string リテラル値はPlayerAの数値スコアより前にソートされます。

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

例

このページの例では、sample_mflix データセットのデータを使用しています。自己管理型 MongoDB 配置にこのデータセットをロードする方法の詳細については、「サンプルデータセットのロード」を参照してください。サンプルデータベースに何らかの変更を加えた場合は、今ページの例を実行するには、データベースを削除して再作成する必要がある可能性があります。

1つのジャンルで評価が最も低い映画3本を検索

$bottomN アキュムレータを使用すると、Short ジャンルの中で評価が最も低い映画3本を検索できます。

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

[
  {
    _id: 'Short',
    lowestRatedMovies: [
      [ 'Andrè and Wally B.', 5.4 ],
      [ 'The Education of Mohammad Hussein', 5.4 ],
      [ 'Enigma', 5.3 ]
    ]
  }
]

サンプルパイプライン:

$match を使用して、入力を imdb.rating 値を含む Short 個の映画に制限します。
$group を使用して、一致した映画を単一の Short グループに配置します。
sortBy: { "imdb.rating": -1, title: 1 } を使用して評価によって映画の順位を付け、title をタイブレーカーとして使用します。
$bottomN が output: [ "$title", "$imdb.rating" ] で返すフィールドを指定します。
$bottomN を使用して、n: 3 と一致する映画の下位 3 位を返します。

各ジャンルの最低評価映画を探す

$bottomN アキュムレータを使用して、各ジャンルの評価が最も低い映画を検索できます。

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

[
  {
    _id: 'Action',
    lowestRatedMovie: [
      [ 'Starship: Rising', 2.1 ],
      [ 'House of the Dead', 2 ],
      [ 'Krampus: The Christmas Devil', 2 ]
    ]
  },
  {
    _id: 'Adventure',
    lowestRatedMovie: [
      [ 'Battlefield Earth', 2.4 ],
      [ 'Epic Movie', 2.3 ],
      [ 'Son of the Mask', 2.1 ]
    ]
  },
  {
    _id: 'Animation',
    lowestRatedMovie: [
      [ 'The Adventures of Rocky & Bullwinkle', 4.1 ],
      [ 'The King and I', 4 ],
      [ 'Space Chimps 2: Zartog Strikes Back', 2.7 ]
    ]
  },
  {
    _id: 'Biography',
    lowestRatedMovie: [
      [ 'Man in the Mirror: The Michael Jackson Story', 3.5 ],
      [ 'The Gaul', 2.7 ],
      [ 'The Undefeated', 2.3 ]
    ]
  },
  {
    _id: 'Comedy',
    lowestRatedMovie: [
      [ 'Superbabies: Baby Geniuses 2', 1.9 ],
      [ 'The Hottie & the Nottie', 1.9 ],
      [ 'Saving Christmas', 1.6 ]
    ]
  }
]

サンプルパイプライン:

各映画の genres配列を拡張するために $unwind を使用します。
$match を使用して、imdb.rating 値を含むドキュメントのみを保持します。
結果をジャンル別にグループ化するために、$group を使用します。
$bottomN が output: [ "$title", "$imdb.rating" ] で返すフィールドを指定します。
sortBy: { "imdb.rating": -1, title: 1 } を使用して評価による映画の順付けを行い、title を決定的なタイブレーカーとして使用します。
$bottomN を使用して、n: 3 で各ジャンルの下位 3 作の映画を返します。
$sort と $limit を使用して、最初の5つのジャンルをアルファベット順に表示します。

グループキーに基づいて n を動的に設定する

n の値をダイナミックに割り当てることができます。次の例では、$cond 式を使用して、コンテンツの評価に基づいて異なる数の映画を返します。

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

[
  {
    _id: { rated: 'G' },
    movies: [ { title: 'Justin Bieber: Never Say Never', rating: 1.6 } ]
  },
  {
    _id: { rated: 'PG' },
    movies: [
      { title: 'Superbabies: Baby Geniuses 2', rating: 1.9 },
      { title: "Justin Bieber's Believe", rating: 1.6 },
      { title: 'Saving Christmas', rating: 1.6 }
    ]
  },
  {
    _id: { rated: 'PG-13' },
    movies: [ { title: 'The Hottie & the Nottie', rating: 1.9 } ]
  },
  { _id: { rated: 'R' }, movies: [ { title: 'House of the Dead', rating: 2 } ] }
]

サンプルパイプライン:

$match を使用して、G、PG、PG-13、または R のコンテンツレーティングを持ち、imdb.rating の値を含む映画のみを保持します。
_id: { rated: "$rated" }を使用して、$group でコンテンツの評価に基づいて結果をグループ化します。
$bottomN が output: { title: "$title", rating: "$imdb.rating" } で返すフィールドを指定します。
コンテンツの評価が PG の場合、n は 3 です。それ以外の場合、n は 1 です。
sortBy: { "imdb.rating": -1 } を使用して、IMDb スコアに基づいて下位 n 作品を検索します。
コンテンツ評価で結果をアルファベット順にソートします。

詳細

戻る

$bottom

$concatArrays