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

定義

$push

グループ内の各ドキュメントに式を適用した結果得られるすべての値の配列を返します。

$pushアキュムレータは、次のステージで使用できます。

• $bucket

• $bucketAuto

• $group

構文

{ $push: <expression> }

式の詳細については、「式 」を参照してください。

動作

$pushをアキュムレータとして使用する場合、パイプラインに取り込まれるドキュメントの順序によって、出力配列内のドキュメントの順序が決まります。指定された順序を保証するには、$sort ステージの前に$group ステージを配置します。

例

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

次の操作では、映画を役員ごとにグループ化し、$pushアキュムレータを使用して、その役員が監督する各映画のプライマリジャンルを収集します。

db.movies.aggregate( [
   {
      $match: {
         year: { $gte: 2010, $lte: 2015 },
         genres: { $exists: true, $ne: [] },
         directors: { $exists: true, $ne: [] }
      }
   },
   {
      $unwind: "$directors"
   },
   {
      $group: {
         _id: "$directors",
         genres: { $push: { $first: "$genres" } }
      }
   },
   {
      $sort: { _id: 1 }
   },
   {
      $limit: 5
   }
] )

[
  { _id: 'A. Karunakaran', genres: [ 'Romance' ] },
  { _id: 'A.J. Edwards', genres: [ 'Biography' ] },
  { _id: 'A.R. Murugadoss', genres: [ 'Action', 'Action' ] },
  { _id: 'AJ Schnack', genres: [ 'Documentary' ] },
  { _id: 'Aanand Rai', genres: [ 'Comedy' ] }
]

先行するパイプライン:

• を使用して、ジャンルと役員の情報を持つ - $matchの映画をフィルタリングします。20102015

• $unwindを使用して、directors 配列内の各役員に個別のドキュメントを作成します。

• 結果のドキュメントを役員ごとにグループ化し、$push を使用して各映画のプライマリジャンルを収集します。

• 結果を役員名でアルファベット順にソートします。

• 出力を 5 つのディレクティブに制限します。

A.R. Murugadoss出力では、Action は を 2Action 回リストされています。これらの映画は をプライマリ ジャンルとして 2 つの映画で監督したためです。これは、一意の値の配列を返す$push $addToSetとは異なり、 には重複した値が含まれていることを示しています。

詳細

• アキュムレータ

• $addToSet

• 集計パイプラインの制限