/ /

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

定義

$top

指定ソート順に従って、グループ内の最上位の要素を返します。

注意

曖昧さ回避

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

$top (window function)$setWindowFieldsまた、特定のウィンドウ内のドキュメントから最上位の要素を返すには、ステージでを使用します。

構文

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

フィールド	必要性	説明
sortBy	必須	`$sort`と同様の構文で結果の順序を指定します。
出力	必須	グループ内の各要素の出力を表し、任意の式にすることができます。

動作

NULL および欠損値

スコアのグループから最上位のドキュメントを返す次の集計を検討してください。

$top は、null 値をフィルタリングで除外しません。
$top 欠落値を 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:
            {
               $top:
                  {
                     output: [ "$playerId", "$score" ],
                     sortBy: { "score": 1 }
                  }
            }
      }
   }
] )

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

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

$documents は、プレイヤーのスコアを含むリテラルドキュメントを作成します。
$groupはドキュメントをgameIdでグループ化します。この例ではgameId 、 G1は 1 つのみです。
PlayerD はスコアが欠落しており、 PlayerEには null scoreがあります。これらの値は両方とも null と見なされます。
playerIdフィールドとscoreフィールドはoutput : ["$playerId"," $score"]として指定され、配列値として返されます。
sortBy: { "score": 1 }で並べ替え順序を指定します。
PlayerD とPlayerEは最上位要素に関連付けられています。 PlayerDは上位のscoreとして返されます。
複数の null 値に対してより明確な同点動作を実現するには、 sortByにフィールドを追加します。

BSON データ型ソート順

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

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

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

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

並べ替えは { "score": -1 } の降順であるため、string 値は PlayerA の数値スコアより前にソートされます。 $top はソート後に最初の要素を返します。この要素は PlayerB です。

db.aggregate( [
   {
      $documents: [
         { playerId: "PlayerA", gameId: "G1", score: 1 },
         { playerId: "PlayerB", gameId: "G1", score: "2" },
         { playerId: "PlayerC", gameId: "G1", score: "" }
      ]
   },
   {
      $group:
         {
            _id: "$gameId",
            playerId:
               {
                  $top:
                  {
                     output: [ "$playerId", "$score" ],
                     sortBy: { "score": -1 }
                  }
               }
         }
   }
] )

[ { _id: 'G1', playerId: [ 'PlayerB', '2' ] } ]

例

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

ジャンルの最高評価を見つける

$topアキュムレータを使用して、最高評価の映画を見つけることができます。

db.movies.aggregate( [
   {
      $match: {
         genres: "Comedy",
         "imdb.rating": { $gt: 0 }
      }
   },
   {
      $group:
         {
            _id: "Comedy",
            highestRatedMovie:
               {
                  $top:
                  {
                     output: [ "$title", "$imdb.rating" ],
                     sortBy: { "imdb.rating": -1 }
                  }
               }
         }
   }
] )

[
  { _id: 'Comedy', highestRatedMovie: [ 'Over the Garden Wall', 9.2 ] }
]

サンプルパイプライン:

$matchを使用して、 IMDb 評価が正のコマンドライン映画をフィルタリングします。
$groupを使用して、すべてのコミットメント映画を単一の"Comedy" グループキーでグループ化します。
を使用して$top output : ["$title", "$imdb.rating"]の出力するフィールドを指定します。
sortBy: { "imdb.rating": -1 } を使用して、グループ内の映画を IMDb 評価で降順にランク付けします。これが、$top が返す映画を決定します。

複数の評価の中で最高の評価を見つける

$topアキュムレータを使用して、各映画評価カテゴリ内の最高評価の映画を見つけることができます。

db.movies.aggregate( [
   {
      $match: {
         rated: { $in: [ "G", "PG", "PG-13", "R" ] },
         "imdb.rating": { $gt: 0 }
      }
   },
   {
      $group:
      {
         _id: "$rated",
         highestRatedMovie:
            {
               $top:
                  {
                     output: [ "$title", "$imdb.rating" ],
                     sortBy: { "imdb.rating": -1 }
                  }
            }
      }
   },
   {
      $sort: { _id: 1 }
   }
] )

[
  { _id: 'G', highestRatedMovie: [ 'Modern Times', 8.6 ] },
  { _id: 'PG', highestRatedMovie: [ 'Life', 9.2 ] },
  {
    _id: 'PG-13',
    highestRatedMovie: [ 'A Brave Heart: The Lizzie Velasquez Story', 9.4 ]
  },
  { _id: 'R', highestRatedMovie: [ 'The Shawshank Redemption', 9.3 ] }
]

サンプルパイプライン:

を使用して、 IMDb 評価が正の、、、 $matchカテゴリ内の映画をフィルタリングします。GPGPG-13R
$groupを使用して結果をrated でグループ化します。
各カテゴリの最高評価の映画を返すには、$top を使用します。
を使用して$top output : ["$title", "$imdb.rating"]の出力するフィールドを指定します。
sortBy: { "imdb.rating": -1 } を使用して、各グループ内の映画を IMDb 評価で降順にランク付けします。これにより、$top が返す映画が決まります。
$sortを使用して、結果を評価カテゴリ別にアルファベット順にソートします。

詳細

戻る

$toObjectId

$toString