定義
グループ内の最初のドキュメントの式の結果を返します。ドキュメントが定義された順序にある場合にのみ意味があります。
$firstアキュムレータは、次のステージで使用できます。
注意
曖昧さ回避
このページでは、アキュムレータとして使用する場合の$first について説明します。アキュムレータは、入力ドキュメントのグループ全体の合計、最大、または最小などの単一の集計値を返します。
次の他のコンテキストでは $first を使用することもできます。
$first (expression)は、配列の最初の要素を返します。$first (window function)。これは$setWindowFieldsステージで使用され、ウィンドウ内の最初のドキュメントの値を返します。
構文
{ $first: <expression> }
動作
ドキュメント順序の定義
$firstグループ化ステージで のドキュメント順序を定義するには、先行する$sort ステージを追加します。
欠落値
グループ内のドキュメントには、フィールドが欠落していることがあります。 $first は欠落値を次のように処理します。
前のパイプライン ステージのドキュメントがない場合、
$groupステージは何も返しません。$firstアキュムレータが処理しているフィールドが欠落している場合、$firstはnullを返します。
例、badDataコレクション内の次のドキュメントを考えてみましょう。一部のドキュメントにはフィールドが欠落しています。
db.badData.insertMany( [ { "_id": 1, "price": 6, "quantity": 6 }, { "_id": 2, "item": "album", "price": 5, "quantity": 5 }, { "_id": 7, "item": "tape", "price": 6, "quantity": 6 }, { "_id": 8, "price": 5, "quantity": 5 }, { "_id": 9, "item": "album", "price": 3, "quantity": '' }, { "_id": 10, "item": "tape", "price": 3, "quantity": 4 }, { "_id": 12, "item": "cd", "price": 7 } ] )
badData コレクションにクエリを行い、出力を item フィールドにグループ化します。
db.badData.aggregate( [ { $sort: { item: 1, price: 1 } }, { $group: { _id: "$item", inStock: { $first: "$quantity" } } } ] )
$first 各出力グループの最初のドキュメントを選択します。 itemフィールドが欠落しているドキュメントは、_idフィールドの null 値とグループ化されます。アキュムレータフィールドが欠落している場合（この例では quantity）、$first は null を返します。
例
このページの例では、 sample_mflix データセット のデータを使用します。このデータセットを自己管理型MongoDBデプロイにロードする 方法の詳細については、「 サンプル データセットをロードする 」を参照してください。サンプルデータベースに変更を加えた場合、このページの例を実行するには、データベースを削除して再作成する必要がある場合があります。
次の例では、映画を年とタイトルでソートし、次にジャンル別にグループ化して、各ジャンルで最も早くリリースされた映画を検索します。
db.movies.aggregate( [ { $sort: { year: 1, title: 1 } }, { $unwind: "$genres" }, { $group: { _id: "$genres", firstMovieTitle: { $first: "$title" }, firstMovieYear: { $first: "$year" } } }, { $sort: { _id: 1 } }, { $limit: 5 } ] )
上記のパイプラインでは、