$ out（汇总）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 聚合管道阶段 > $ out（汇总）

在本页面

定义
行为举止
例

定义¶

$out¶

获取聚合管道返回的文档，并将其写入指定的集合。该$out操作者必须在最后阶段的管道。该$out运营商让聚合框架返回结果集的任何尺寸。

在版本3.2.0中进行了更改。

该$out阶段具有以下原型形式：

复制

{ $out: "<output-collection>" }

$out 采用指定输出集合名称的字符串。

重要

您不能将分片集合指定为输出集合。管道的输入集合可以分片。要输出到分片集合，请参阅$merge （从MongoDB 4.2开始可用）。
该$out运营商不能将结果写入封顶集合。

与¶的比较`$merge`

$merge和$out比较

$merge在4.2版中引入之后，MongoDB提供了两个阶段，$merge和$out，用于将聚合管道的结果写入集合。以下总结了这两个阶段的功能：

`$out`	`$merge`
从MongoDB 2.6开始可用	从MongoDB 4.2开始可用
只能输出到同一数据库中的集合。	可以输出到相同或不同数据库中的集合。
如果输出集合尚不存在，则创建一个新集合。	如果输出集合尚不存在，则创建一个新集合。
如果输出集合已经存在，则将其完全替换。	可以将结果（插入新文档，合并文档，替换文档，保留现有文档，使操作失败，使用自定义更新管道处理文档）合并到现有集合中。可以替换集合的内容，但前提是汇总结果包含集合中所有现有文档的匹配项。
无法输出到分片集合。但是，输入分片可以分片。	可以输出到分片集合。输入集合也可以分片。
对应于SQL语句： `INSERT INTO T2 SELECT FROM T1`。 `SELECT INTO T2 FROM T1`。	对应于SQL语句： `MERGE`。 `INSERT INTO T2 SELECT FROM T1`。 `SELECT INTO T2 FROM T1`。创建/刷新实例化视图。

行为¶

创建新集合¶

$out如果当前数据库中尚不存在一个新集合，则该操作将创建一个新集合。在聚合完成之前，该集合不可见。如果聚合失败，则MongoDB不会创建集合。

替换现有集合¶

如果$out操作指定的集合已经存在，那么在聚合完成后，该$out 阶段将用新的结果集合原子替换现有的集合。具体来说，该$out操作：

创建一个临时集合。
将索引从现有集合复制到临时集合。
将文档插入到临时集合中。
呼叫db.collection.renameCollection与到临时集合重命名为目的地集合。dropTarget: true

该$out操作不会更改先前集合上存在的任何索引。如果聚合失败，则该$out操作不会更改现有集合。

指标约束¶

如果管道产生的文档违反任何唯一索引，包括_id原始输出集合的字段上的索引，则管道将无法完成。

交易¶

$out不允许进行交易。

视图¶

4.2版中的新功能。

该$out阶段不允许作为视图定义的一部分。如果视图定义包括嵌套管道（例如，视图定义包括$lookup或 $facet阶段），则此$out阶段限制也适用于嵌套管道。[1]

[1]	从4.2开始，您不能将`$out`舞台包括在`$lookup`舞台的嵌套管道中，无论`$lookup`该视图是否是视图定义的一部分。

`linearizable`阅读关注点¶

从MongoDB 4.2开始，此$out阶段不能与“关注”一起使用"linearizable"。也就是说，如果您为指定了"linearizable"读取关注 db.collection.aggregate()，则不能将$out阶段包括在管道中。

`majority`阅读关注点¶

从MongoDB 4.2开始，您可以为包含阶段的聚合指定读取关注级别。"majority"$out

在MongoDB 4.0和更早版本中，您不能包括将读取关注用于聚合的$out 阶段"majority"。

与¶的交互`mongodump`

如果客户端发出在转储过程中包括的聚合管道，则“ mongodump开头为”将 --oplog失败$out。请参阅以获取更多信息。mongodump --oplog

例子¶

集合books包含以下文档：

复制

{ "_id" : 8751, "title" : "The Banquet", "author" : "Dante", "copies" : 2 }
{ "_id" : 8752, "title" : "Divine Comedy", "author" : "Dante", "copies" : 1 }
{ "_id" : 8645, "title" : "Eclogues", "author" : "Dante", "copies" : 2 }
{ "_id" : 7000, "title" : "The Odyssey", "author" : "Homer", "copies" : 10 }
{ "_id" : 7020, "title" : "Iliad", "author" : "Homer", "copies" : 10 }

以下聚合操作将books 集合中的数据旋转为具有按作者分组的标题，然后将结果写入到authors集合中。

复制

db.books.aggregate( [
                      { $group : { _id : "$author", books: { $push: "$title" } } },
                      { $out : "authors" }
                  ] )

操作后，authors集合包含以下文档：

复制

{ "_id" : "Homer", "books" : [ "The Odyssey", "Iliad" ] }
{ "_id" : "Dante", "books" : [ "The Banquet", "Divine Comedy", "Eclogues" ] }

MongoDB 中文手册

$ out（汇总）

定义¶

与¶的比较$merge

行为¶