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

$unionWith(集計ステージ)

$unionWith

バージョン8.0で変更。

2 つの集計を 1 つの結果セットに結合します。 $unionWithは結合された結果セット(重複を含む)を次のステージに出力します。

結合された結果セットのドキュメントが出力される順序は指定されていません。

$unionWith ステージの構文は次のとおりです。

{ $unionWith: { coll: "<collection>", pipeline: [ <stage1>, ... ] } }

指定したコレクションの全ドキュメントを処理せずに含めるには、簡略化された形式を使用できます。

{ $unionWith: "<collection>" } // Include all documents from the specified collection

$unionWithステージは、次のフィールドを持つドキュメントを取得します。

フィールド
必要性
説明

pipeline を省略する場合は必須です。それ以外は任意です。

結果セットに含めるパイプライン結果を持つコレクションまたはビュー。

collフィールドを省略する場合は、$documents の最初のステージを持つpipelineフィールドを指定する必要があります

coll を省略する場合は必須です。それ以外は任意です。

入力ドキュメントに適用する集計パイプライン。

  • collを指定すると、パイプラインはcollのドキュメントに適用されます。

  • coll を省略すると、パイプラインはパイプライン内の $documents ステージのドキュメントに適用されます。例えについては、「指定されたドキュメントとの Union の作成」を参照してください。

パイプラインには $out ステージと $merge ステージを含めることはできません。v6.0 以降では、pipeline にはパイプライン内の最初のステージとして MongoDB Search $search ステージを含めることができます。詳しくは、「MongoDB Search サポート」を参照してください。

$unionWith操作は、次の SQL ステートメントに対応します。

SELECT *FROM Collection1WHERE ...UNION ALLSELECT *FROM Collection2WHERE ...

前のステージと $unionWith ステージから組み合わせた結果には重複が含まれる場合があります。

例として、次の集計は、movies コレクションに対する 2 つのクエリからの title フィールドのプロジェクション結果を組み合わせたものです。結果セットには重複が含まれています。

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $project: { title: 1, _id: 0 } }, { $unionWith: { coll: "movies", pipeline: [ { $match: { runtime: { $gt: 1000 } } }, { $project: { title: 1, _id: 0 } } ] } }] )
[ { title: 'Centennial' }, { title: 'Baseball' }, { title: 'Centennial' }, { title: 'Baseball' }]

重複を除くには、$group ステージを追加して、title フィールドでグループ化します。結果セットには重複が含まれなくなりました。

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $project: { title: 1, _id: 0 } }, { $unionWith: { coll: "movies", pipeline: [ { $match: { runtime: { $gt: 1000 } } }, { $project: { title: 1, _id: 0 } } ] } }, { $group: { _id: "$title" } }, { $sort: { _id: 1 } }] )
[ { _id: 'Baseball' }, { _id: 'Centennial' }]

db.collection.aggregate()にcollationドキュメントが含まれている場合、その照合が操作に使用され、他の照合は無視されます。

db.collection.aggregate()にcollationドキュメントが含まれていない場合、 db.collection.aggregate()メソッドは、 db.collection.aggregate()が実行される最上位のコレクションやビューの照合を使用します。

  • $unionWith coll がコレクションの場合、その照合は無視されます。

  • $unionWith coll がビューの場合、その照合は最上位のコレクションやビューの照合と一致する必要があります。そうでない場合はエラーとなります。

MongoDB6.0 以降では、 パイプラインでMongoDB Search$search $searchMetaまたは$unionWith ステージを指定して、Atlas クラスター上のコレクションを検索できます。$search または $searchMeta ステージは、$unionWithパイプライン内の最初のステージである必要があります。

と$unionWith$search の例については、 MongoDB Search チュートリアルの「 $unionWith を使用してMongoDB Search $search クエリを実行する 」を参照してください。

MongoDB 8.0 以降では、from フィールドと coll フィールドが正しく使用されるように、$lookup と $unionWith 内のサブパイプラインの名前空間が検証されます。

  • $lookup の場合、指定されたコレクションを必要としないステージを持つサブパイプラインを使用する場合は、from フィールドを省略する(例: $documents ステージ)。

  • 同様に、$unionWith の場合、coll フィールドを省略する。

変更されていない動作:

  • コレクションのステージで開始される $lookup の場合(例: $match サブパイプラインまたは $collStats サブパイプライン)、from フィールドを含め、コレクションを指定する必要があります。

  • 同様に、$unionWith の場合は、coll フィールドを含め、コレクションを指定します。

制限事項
説明

集計パイプラインでは、 トランザクション$unionWith 内で を使用できません。

$unionWith パイプラインには$outステージを含めることはできません。

$unionWith パイプラインには$mergeステージを含めることはできません。

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

次の例では、$unionWith ステージを使用してデータを結合し、movies コレクションから結果を返します。

次の集計では、カテゴリ別に映画をリストする映画レポートを作成します。パイプラインは $unionWith を使用して movies コレクションのドキュメントを結合します。

db.movies.aggregate( [ { $match: { year: { $lt: 1910 } } }, { $set: { category: "Early Cinema" } }, { $unionWith: { coll: "movies", pipeline: [ { $match: { runtime: { $gt: 1000 } } }, { $set: { category: "Long Runtime" } } ] } }, { $project: { title: 1, year: 1, category: 1, _id: 0 } }, { $sort: { category: 1, year: 1, title: 1 } }] )
[ { title: 'The Kiss', year: 1896, category: 'Early Cinema' }, { title: 'The Kiss', year: 1896, category: 'Early Cinema' }, { title: 'The Great Train Robbery', year: 1903, category: 'Early Cinema' }, { title: 'A Corner in Wheat', year: 1909, category: 'Early Cinema' }, { title: 'Centennial', year: 1978, category: 'Long Runtime' }, { title: 'Baseball', year: 1994, category: 'Long Runtime' }]

具体的には、集計パイプラインでは次のものが使用されます。

  • 1910より前に公開された映画を選択するための$matchステージ。

  • $set ステージを使用して、値 Early Cinema を持つ category フィールドを追加します。

  • movies コレクションからドキュメントを結合するための $unionWith ステージ。runtime が 1000 より大きく、Long Runtime カテゴリのタグが付いた映画にフィルターされます。

  • title、year、およびcategory フィールドのみを返す$projectステージ。

  • $sort ステージで、category、year、title で並べ替えます。

次の集計では、ジャンルごとの合計実行時間を一覧表示する映画レポートが作成されます。パイプラインは $unionWith を使用して movies コレクションのドキュメントを結合します。

db.movies.aggregate( [ { $match: { year: { $lt: 1910 } } }, { $unionWith: { coll: "movies", pipeline: [ { $match: { runtime: { $gt: 1000 } } } ] } }, { $group: { _id: "$genres", totalRuntime: { $sum: "$runtime" } } }, { $sort: { totalRuntime: -1 } }] )
[ { _id: [ 'Action', 'Adventure', 'Drama' ], totalRuntime: 1256 }, { _id: [ 'Documentary', 'History', 'Sport' ], totalRuntime: 1140 }, { _id: [ 'Short', 'Drama' ], totalRuntime: 14 }, { _id: [ 'Short', 'Western' ], totalRuntime: 11 }, { _id: [ 'Short', 'Romance' ], totalRuntime: 2 }]
  • $matchおよび$unionWithステージは、moviesコレクションからパイプラインにドキュメントを検索します。

  • $group ステージは genres フィールドでグループ化し、$sum を使用して runtime ごとの合計 genres を計算します。

  • $sort ステージでは、ドキュメントを totalRuntime の降順で並べ替えます。

$unionWithを使用して、 pipelineフィールドに指定したドキュメントとの和集合を実行できます。 pipelineフィールドに$documentsステージを指定すると、別のコレクションに保存されていないドキュメントとの和集合が実行されます。

次の$unionWith操作は、 pipeline $documentsフィールドに指定されたドキュメントとの和集合を実行します。

db.movies.aggregate( [ { $match: { runtime: { $gt: 1000 } } }, { $project: { title: 1, year: 1, _id: 0 } }, { $unionWith: { pipeline: [ { $documents: [ { title: "Movie A", year: 2000 }, { title: "Movie B", year: 2001 } ] } ] } }] )
[ { title: 'Centennial', year: 1978 }, { title: 'Baseball', year: 1994 }, { title: 'Movie A', year: 2000 }, { title: 'Movie B', year: 2001 }]

ドキュメンテーション