> For the complete documentation index, see [llms.txt](https://docs.mongoing.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mongoing.com/aggregation/map-reduce.md).

# Map-Reduce

在本页面

* [Map-Reduce JavaScript 函数](#map-reduce-javascript-functions)
* [Map-Reduce 行为](#map-reduce-results)
* [分片集合](#sharded-collections)
* [视图](#views)

Map-reduce 是一种数据处理范式，用于将大量数据压缩为有用的聚合结果。对于 map-reduce 操作，MongoDB 提供[MapReduce](/aggregation/map-reduce.md)数据库命令。

> **\[success] 注意**
>
> 从4.2版开始，MongoDB弃用：
>
> * 用于创建新分片集合的map-reduce选项，以及用于map-reduce的[分片](/aggregation/map-reduce.md)选项。若要输出到分片集合，请先创建分片集合。MongoDB 4.2也不赞成替换现有的分片集合。
> * [nonAtomic：false](/aggregation/map-reduce.md)选项的显式规范。

考虑以下 map-reduce 操作：

![带注释的 map-reduce 操作图。](https://docs.mongodb.com/manual/_images/map-reduce.bakedsvg.svg)

在此 map-reduce 操作中，MongoDB 将 map 阶段应用于每个输入文档(即：集合中与查询条件匹配的文档)。 map函数会发出 key-value 对。对于具有多个值的键，MongoDB 应用 reduce 阶段，该阶段收集并压缩聚合数据。然后 MongoDB 结果存储在一个集合中。可选地，reduce 函数的输出可以通过 finalize 函数以进一步压缩或处理聚合的结果。

MongoDB 中的所有 map-reduce 函数都是JavaScript，在mongod进程中运行。 Map-reduce 操作将单个[集合](/aggregation/map-reduce.md)的文档作为输入，并且可以在开始 map 阶段之前执行任意排序和限制。 [MapReduce](/aggregation/map-reduce.md)可以将map-reduce操作的结果作为文档返回，或者可以将结果写入集合。

> **\[success] 注意**
>
> 对于大多数聚合操作，[聚合管道](/aggregation/aggregation-pipeline.md)提供更好的性能和更一致的接口。但是，map-reduce 操作提供了一些在聚合管道中目前不可用的灵活性。

## Map-Reduce JavaScript 函数

在 MongoDB 中，map-reduce 操作使用自定义 JavaScript 函数将值映射或关联到一个键。如果一个键有多个值映射到它，则操作会将 键的值减少为单个对象。

自定义 JavaScript 函数的使用为 map-reduce 操作提供了灵活性。例如，在处理文档时，map 函数可以创建多个键和值映射或不创建映射。 Map-reduce 操作还可以使用自定义 JavaScript 函数对 map和reduce操作结束时的结果进行最终修改，例如执行其他计算。

在4.2.1版本开始，MongoDB的不支持在`map`，`reduce`和`finalize`中使用范围（即:[BSON type 15](/aggregation/map-reduce.md)）的JavaScript。要限定变量的范围，请使用`scope`参数。

## Map-Reduce 行为

在 MongoDB 中，map-reduce 操作可以将结果写入集合或内联返回结果。如果将 map-reduce 输出写入集合，则可以对同一输入集合执行后续 map-reduce 操作，这些集合将替换，合并或reduce新结果与先前结果合并。有关详细信息和示例，请参阅[MapReduce](/aggregation/map-reduce.md)和[执行增量 Map-Reduce](/aggregation/map-reduce.md)。

在内联返回 map-reduce 操作的结果时，结果文档必须在[BSON 文件大小](/aggregation/map-reduce.md)限制范围内，当前为 16 兆字节。有关 map-reduce 操作的限制和限制的其他信息，请参阅[MapReduce 参考](/aggregation/map-reduce.md) 页面。

## 分片集合

MongoDB 支持[分片集合](/aggregation/map-reduce.md)上的 map-reduce 操作。

但是，从版本4.2开始，MongoDB弃用map-reduce选项来\_创建\_新的分片集合，并将 `sharded`选项用于map-reduce。若要输出到分片集合，请首先创建分片集合。MongoDB 4.2不建议替换现有分片集合。

见[Map-Reduce and Sharded Collections](/aggregation/map-reduce/map-reduce-and-sharded-collections.md)。

## 视图

[视图](/aggregation/map-reduce.md)不支持 map-reduce 操作。

译者：李冠飞

校对：李冠飞