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

$first(アキュムレータ演算子)

$first

グループ内の最初のドキュメントの式の結果を返します。ドキュメントが定義された順序にある場合にのみ意味があります。

$first アキュムレータは次のステージで使用可能です。

注意

曖昧さ回避

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

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

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

上記のパイプラインでは、

  • $sort は、year で映画を昇順に並べ、その後、title をアルファベット順に並べます。

  • $unwind は、genres 配列内の各ジャンルごとに個別のドキュメントを作成し、前のステージで確立されたソート順を維持します。

  • $first を使用して、$group は、各ジャンルについて、最初の映画 (年が最も古いもの、その後タイトルでアルファベット順) の title と year を返します。

  • 2 番目の $sort は、結果をジャンル別にアルファベット順に並べ替えます。

  • $limit 出力を 5 ジャンルに制限します。

このページを評価