AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

$topN(式)

$topN

バージョン8.3の新機能。

指定ソート順に従って、配列の上位 個の n 要素を返します。配列に含まれる要素が n 未満の場合、$topN は配列内のすべての要素を返します。

注意

$topN のその他の使用方法

このページでは、配列値に対して操作する 式 として使用する場合の $topN について説明します。

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

式として使用する場合、$topN は次の構文をとります。

{ $topN: { n: <expression>, sortBy: <expression>, input: <expression> }}
フィールド
必要性
説明

n

必須

返される配列要素の数。

sortBy

必須

結果の順序を指定します。sortBy 値の詳細については、ソートの動作を参照してください。

入力

必須

$topN が評価する配列。

  • $topN は、null 値をフィルタリングで除外しません。

  • $topN 欠落値を null に変換します。

MongoDB はsortBy 値に基づいて input 配列をソートします。次の表に、さまざまなソートオプションの例を示します。

input
sortBy
ソート済み input
[ 8, 3, 1, 10]

1

[1, 3, 8, 10]
[ 8, 3, 1, 10]

-1

[10, 8, 3, 1]
[ { a: 1, b: 1 }, { a: 2, b: 2 }, { a: 2, b: 1 }]

{ a: 1, b: 1 }

[ { a: 1, b: 1 }, { a: 2, b: 1 }, { a: 2, b: 2 }]

input フィールドは配列に解決される必要があります。配列ではない input を指定した場合、MongoDB はエラーを返します。

以下の例では、sample_mflix サンプル データセットの movies コレクションを使用します。このデータセットを配置にロードする方法について詳しくは、「サンプル データセットのロード」を参照してください。

moviesコレクションには、次の例のようなドキュメントが含まれています。

{ _id: ObjectId('573a1396f29313caabce4a9a'), year: 1972, genres: [ 'Crime', 'Drama' ], title: 'The Godfather', cast: [ 'Marlon Brando', 'Al Pacino', 'James Caan', 'Richard S. Castellano' ], directors: [ 'Francis Ford Coppola' ], runtime: 175, ...}

次の集計パイプラインでは、cast 配列で $topN を使用します。

db.movies.aggregate([ { $match: { title: "The Godfather" } }, { $project: { _id: 0, title: 1, firstThreeCastMembersAlphabetically: { $topN: { n: 3, sortBy: 1, input: "$cast" } } } }])
[ { title: 'The Godfather', firstThreeCastMembersAlphabetically: [ 'Al Pacino', 'James Caan', 'Marlon Brando' ] }]

この例では 、$topN は既存の cast 配列をアルファベットの昇順でソートし、最初の 3 つの値を返します。

このページを評価