Aggregation Pipeline as Alternative
Starting in MongoDB 5.0, map-reduce is deprecated:
For map-reduce operations that require custom functionality, you can use the
For examples of aggregation pipeline alternatives to map-reduce, see:
Map-reduce is a data processing paradigm for condensing large volumes
of data into useful aggregated results. To perform map-reduce
operations, MongoDB provides the
Consider the following map-reduce operation:
In this map-reduce operation, MongoDB applies the map phase to each input document (i.e. the documents in the collection that match the query condition). The map function emits key-value pairs. For those keys that have multiple values, MongoDB applies the reduce phase, which collects and condenses the aggregated data. MongoDB then stores the results in a collection. Optionally, the output of the reduce function may pass through a finalize function to further condense or process the results of the aggregation.
mongod process. Map-reduce operations take the
documents of a single collection as the input and can perform
any arbitrary sorting and limiting before beginning the map stage.
mapReduce can return the results of a map-reduce operation
as a document, or may write the results to collections.
You can use map-reduce for deployments hosted in the following environments:
MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud
Map-reduce is unsupported for MongoDB Atlas free clusters and MongoDB Atlas serverless instances.
MongoDB Enterprise: The subscription-based, self-managed version of MongoDB
MongoDB Community: The source-available, free-to-use, and self-managed version of MongoDB
To learn more about creating aggregation pipelines for deployments hosted in MongoDB Atlas, see Run Aggregation Pipelines.
Starting in MongoDB 4.4,
mapReduce no longer supports
(BSON type 15) for its functions. The
finalize functions must be either BSON
type String (BSON type 2) or
To pass constant values which will be accessible in the
finalize functions, use the
functions has been deprecated since version 4.2.1.
In MongoDB, the map-reduce operation can write results to a collection
or return the results inline. If you write map-reduce output to a
collection, you can perform subsequent map-reduce operations on the
same input collection that merge replace, merge, or reduce new results
with previous results. See
Perform Incremental Map-Reduce for details and
When returning the results of a map-reduce operation inline, the result documents must be within the BSON Document Size limit, which is currently 16 megabytes. For additional information on limits and restrictions on map-reduce operations, see the mapReduce reference page.
MongoDB supports map-reduce operations on sharded collections.
However, starting in version 4.2, MongoDB deprecates the map-reduce
option to create a new sharded collection and the use of the
sharded option for map-reduce. To output to a sharded collection,
create the sharded collection first. MongoDB 4.2 also deprecates the
replacement of an existing sharded collection.
Views do not support map-reduce operations.