# 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 操作。

译者：李冠飞

校对：李冠飞


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mongoing.com/aggregation/map-reduce.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.