定義
指定ソート順に従って、グループ内の最上位の要素を返します。
注意
曖昧さ回避
このページでは、$top をアキュムレータとして使用する場合について説明します。アキュムレータは、入力ドキュメントのグループ全体で単一の集計値を返します。
特定のウィンドウのドキュメントから最上位の要素を返すために、$top (window function) を $setWindowFields ステージで使用することもできます。
構文
{ $top: { sortBy: { <field1>: <sort order>, <field2>: <sort order> ... }, output: <expression> }}フィールド | 必要性 | 説明 |
|---|---|---|
sortBy | 必須 | |
出力 | 必須 | グループ内の各要素の出力を表し、任意の 式 にすることができます。 |
動作
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 } } } } }] )この例では、次のことが行われます。
$documentsは、プレイヤーのスコアを含むリテラル ドキュメントを作成します。$groupはドキュメントをgameIdでグループ化します。 この例ではgameId、G1は 1 つのみです。PlayerDはスコアが欠落しており、PlayerEには nullscoreがあります。 これらの値は両方とも 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 } } } } }] )例
このページの例では、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 } } } } }] )サンプル パイプライン:
複数の評価で最高評価を見つける
$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 } }] )サンプル パイプライン:
使用して
$matchで、G、PG、PG-13、Rカテゴリの映画のうち、IMDb レーティングがプラスのものをフィルターします。ratedで結果をグループ化するために$groupを使用します。$topを使用して、カテゴリーごとに最高評価の映画を返します。を使用して
$topoutput : ["$title", "$imdb.rating"]の出力するフィールドを指定します。sortBy: { "imdb.rating": -1 }を使用して、各グループ内の映画を IMDb レーティングで降順にランク付けし、それによって$topが返す映画が決定されます。評価カテゴリ別に結果をアルファベット順に並べ替えるために、
$sortを使用します。