How to write union queries in mongoDB How to write union queries in mongoDB mongodb mongodb

How to write union queries in mongoDB


Doing unions in MongoDB in a 'SQL UNION' fashion is possible using aggregations along with lookups, in a single query.

Something like this:

    db.getCollection("AnyCollectionThatContainsAtLeastOneDocument").aggregate(    [      { $limit: 1 }, // Reduce the result set to a single document.      { $project: { _id: 1 } }, // Strip all fields except the Id.      { $project: { _id: 0 } }, // Strip the id. The document is now empty.      // Lookup all collections to union together.      { $lookup: { from: 'collectionToUnion1', pipeline: [...], as: 'Collection1' } },      { $lookup: { from: 'collectionToUnion2', pipeline: [...], as: 'Collection2' } },      { $lookup: { from: 'collectionToUnion3', pipeline: [...], as: 'Collection3' } },      // Merge the collections together.      {        $project:        {          Union: { $concatArrays: ["$Collection1", "$Collection2", "$Collection3"] }        }      },      { $unwind: "$Union" }, // Unwind the union collection into a result set.      { $replaceRoot: { newRoot: "$Union" } } // Replace the root to cleanup the resulting documents.    ]);

Here is the explanation of how it works:

  1. Instantiate an aggregate out of any collection of your database that has at least one document in it. If you can't guarantee any collection of your database will not be empty, you can workaround this issue by creating in your database some sort of 'dummy' collection containing a single empty document in it that will be there specifically for doing union queries.

  2. Make the first stage of your pipeline to be { $limit: 1 }. This will strip all the documents of the collection except the first one.

  3. Strip all the fields of the remaining document by using $project stages:

    { $project: { _id: 1 } },{ $project: { _id: 0 } }
  4. Your aggregate now contains a single, empty document. It's time to add lookups for each collection you want to union together. You may use the pipeline field to do some specific filtering, or leave localField and foreignField as null to match the whole collection.

    { $lookup: { from: 'collectionToUnion1', pipeline: [...], as: 'Collection1' } },{ $lookup: { from: 'collectionToUnion2', pipeline: [...], as: 'Collection2' } },{ $lookup: { from: 'collectionToUnion3', pipeline: [...], as: 'Collection3' } }
  5. You now have an aggregate containing a single document that contains 3 arrays like this:

    {    Collection1: [...],    Collection2: [...],    Collection3: [...]}

    You can then merge them together into a single array using a $project stage along with the $concatArrays aggregation operator:

    {  "$project" :  {    "Union" : { $concatArrays: ["$Collection1", "$Collection2", "$Collection3"] }  }}
  6. You now have an aggregate containing a single document, into which is located an array that contains your union of collections. What remains to be done is to add an $unwind and a $replaceRoot stage to split your array into separate documents:

    { $unwind: "$Union" },{ $replaceRoot: { newRoot: "$Union" } }
  7. VoilĂ . You know have a result set containing the collections you wanted to union together. You can then add more stages to filter it further, sort it, apply skip() and limit(). Pretty much anything you want.


Starting Mongo 4.4, the aggregation framework provides a new $unionWith stage, performing the union of two collections (the combined pipeline results from two collections into a single result set).

Thus, in order to combine documents from 3 collections:

// > db.collection1.find()//   { "circuitId" : 12, "a" : "1" }//   { "circuitId" : 17, "a" : "2" }//   { "circuitId" : 12, "a" : "5" }// > db.collection2.find()//   { "circuitId" : 12, "b" : "x" }//   { "circuitId" : 12, "b" : "y" }// > db.collection3.find()//   { "circuitId" : 12, "c" : "i" }//   { "circuitId" : 32, "c" : "j" }db.collection1.aggregate([  { $match: { circuitId: 12 } },  { $unionWith: { coll: "collection2", pipeline: [{ $match: { circuitId: 12 } }] } },  { $unionWith: { coll: "collection3", pipeline: [{ $match: { circuitId: 12 } }] } }])// { "circuitId" : 12, "a" : "1" }// { "circuitId" : 12, "a" : "5" }// { "circuitId" : 12, "b" : "x" }// { "circuitId" : 12, "b" : "y" }// { "circuitId" : 12, "c" : "i" }

This:

  • First filters documents from collection1
  • Then includes documents from collection2 into the pipeline with the new $unionWith stage. The pipeline parameter is an optional aggregation pipeline applied on documents from the collection being merged before the merge happens.
  • And also includes documents from collection3 into the pipeline with the same $unionWith stage.


Unfortunately document based MongoDB doesn't support JOINS/Unions as in Relational DB engines.One of the key design principles on MongoDB is to prevent joins using embedded documents as per your application's data fetch patterns.Having said that, you will need to manage the logic in your application end if you really need to use the 4 collections or you may redesign your DB design as per MongoDB best practices.

For more info : https://docs.mongodb.com/master/core/data-model-design/