定義
グループ内の各ドキュメントに式を適用した結果得られるすべての値の配列を返します。
$push アキュムレータは次のステージで使用可能です。
注意
曖昧さ回避
このページでは、$push をアキュムレータとして使用する場合について説明します。アキュムレータは、入力ドキュメントのグループ全体で集計値を返します。
$push は、これらの他のコンテキストでも使用できます。
$push (window function)は、特定のウィンドウのドキュメントからすべての値の配列を返すために、$setWindowFieldsステージで使用されます。$push (update operator)、ドキュメント内の配列フィールドに値を追加します。
構文
{ $push: <expression> }式の詳細については、「式 」を参照してください。
動作
$push をアキュムレータとして使用する場合、パイプラインに取り込まれるドキュメントの順序によって、出力配列内のドキュメントの順序が決まります。指定された順序を保証するには、$sort ステージの前に$group ステージが必要です。
制限
$push アキュムレータは、一時ファイルをディスクに書き込み (write)ことができません。internalQueryMaxPushBytes サーバーパラメータは $push メモリ制限を制御します。蓄積された配列がその制限を超えると、allowDiskUse が true であっても、MongoDB はエラーを返します。デフォルトでは、パラメータは 104857600 バイト (100 メガバイト) です。setParameter コマンドを使用して、実行時に制限を最大 2147483647 バイトまで引き上げることができます。
集計メモリの制限の詳細については、集計パイプラインの制限事項を参照してください。
例
このページの例では、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 }] )以前のパイプライン:
$matchを使用して、2010 年から 2015 年までのジャンルと役員の情報を持つ映画にフィルターします。$unwindを使用して、directors配列内の各役員に対して個別のドキュメントを作成します。結果のドキュメントを役員ごとにグループ化し、
$pushを使用して各映画のプライマリジャンルを収集します。結果を役員名でアルファベット順にソートします。
出力を5人の役員に制限します。
出力では、A.R. Murugadoss は Action を 2 回表示しています。それは、 がプライマリジャンルが Action である 2 本の映画を監督したためです。これは、$push には重複値が含まれていることを示しています。$addToSet とは異なり、こちらは一意の値の配列を返します。