db.collection.aggregate()
除了$out和$geoNear阶段之外的所有内容都可以在管道中多次出现
计算集合或视图中数据的聚合值
1 | db.collection.aggregate(pipeline, options) |
| 参数 | 类型 | 描述 |
|---|---|---|
pipeline |
排列 | 一系列数据聚合操作或阶段。有关详细信息,请参阅 聚合管道运算在2.6版中更改:该方法仍然可以将管道阶段作为单独的参数接受,而不是作为数组中的元素; 但是,如果未指定pipeline为数组,则无法指定 options参数。 |
options |
文献 | 可选的。aggregate()传递给aggregate命令的其他选项。版本2.6中的新功能:仅在您指定pipeline为数组时可用。 |
该options文档可以包含以下字段和值:
| 领域 | 类型 | 描述 |
|---|---|---|
explain |
布尔 | 可选的。指定返回有关管道处理的信息。有关示例,请参阅 聚合管道操作的返回信息。在多文档交易中不可用。 |
allowDiskUse |
布尔 | 可选的。允许写入临时文件。设置为时true,聚合操作可以将数据写入_tmp目录中的 dbPath子目录。有关示例,请参阅 使用外部排序执行大型排序操作。2.6版中的新功能。 |
cursor |
文献 | 可选的。指定游标的初始批处理大小。该cursor 字段的值是具有该字段的文档batchSize。有关语法和示例,请参阅 指定初始批处理大小。2.6版中的新功能。 |
maxTimeMS |
非负整数 | 可选的。指定处理游标操作的时间限制(以毫秒为单位)。如果未指定maxTimeMS的值,则操作不会超时。值0显式指定默认的无界行为。MongoDB使用与其相同的机制终止超出其分配时间限制的操作db.killOp()。MongoDB仅终止其指定中断点之一的操作。 |
bypassDocumentValidation |
布尔 | 可选的。仅在指定$out聚合运算符时可用。允许db.collection.aggregate在操作期间绕过文档验证。这使您可以插入不符合验证要求的文档。版本3.2中的新功能。 |
readConcern |
文献 | 可选的。指定读取问题。readConcern选项具有以下语法:版本3.6中已更改。复制复制readConcern : { level : < value > }可能的阅读关注水平是:"local"。这是默认的读取关注级别。"available"。当读取操作和afterClusterTime以及“level”未指定时,这是对辅助节点的读取的默认值。查询返回实例的最新数据。"majority"。适用于使用WiredTiger存储引擎的副本集 。"linearizable"。仅适用于读取操作 primary。有关读取关注级别的更多信息,请参阅 读取关注级别。对于"local"(默认)或"majority"读取关注级别,您可以指定使afterClusterTime读取操作返回满足级别要求的数据和指定的群集时间要求的选项。有关更多信息,请参阅 读取操作和afterClusterTime。 |
collation |
文献 | 可选的。指定 要用于操作的排序规则。排序规则允许用户为字符串比较指定特定于语言的规则,例如字母和重音标记的规则。排序规则选项具有以下语法:复制复制collation : { locale : < string > , caseLevel : < boolean > , caseFirst : < string > , strength : < int > , numericOrdering : < boolean > , alternate : < string > , maxVariable : < string > , backwards : < boolean > }指定排序规则时,该locale字段是必填字段; 所有其他校对字段都是可选的。有关字段的说明,请参阅排序文档。如果未指定排序规则但集合具有默认排序规则(请参阅参考资料db.createCollection()),则该操作将使用为集合指定的排序规则。如果没有为集合或操作指定排序规则,MongoDB使用先前版本中使用的简单二进制比较进行字符串比较。您无法为操作指定多个排序规则。例如,您不能为每个字段指定不同的排序规则,或者如果使用排序执行查找,则不能对查找使用一个排序规则,而对排序使用另一个排序规则。版本3.4中的新功能。 |
hint |
字符串或文件 | 可选的。用于聚合的索引。索引位于运行聚合的初始集合/视图上。通过索引名称或索引规范文档指定索引。注意该hint不适$lookup和 $graphLookup阶段。版本3.6中的新功能。 |
comment |
串 | 可选的。用户可以指定任意字符串,以帮助通过数据库探查器,currentOp和日志跟踪操作。版本3.6中的新功能。 |
一个光标通过聚集流水线操作的最后阶段产生的文件,或者如果包括 explain选项,提供了聚集操作的处理细节的文件。
| 阶段 | 描述 |
|---|---|
$addFields |
向文档添加新字段。类似于 $project,$addFields重塑流中的每个文档; 具体而言,通过向输出文档添加新字段,该文档包含输入文档和新添加字段中的现有字段。 |
$bucket |
根据指定的表达式和存储区边界,将传入的文档分组,称为存储桶。 |
$bucketAuto |
根据指定的表达式将传入的文档分类为特定数量的组(称为存储桶)。自动确定存储桶边界,以尝试将文档均匀地分配到指定数量的存储桶中。 |
$collStats |
返回有关集合或视图的统计信息。 |
$count |
返回聚合管道此阶段的文档数量计数。 |
$facet |
在同一组输入文档的单个阶段内处理多个聚合管道。支持创建能够在单个阶段中跨多个维度或方面表征数据的多面聚合。 |
$geoNear |
基于与地理空间点的接近度返回有序的文档流。集成的功能 $match,$sort以及$limit地理空间数据。输出文档包括附加距离字段,并且可以包括位置标识符字段。 |
$graphLookup |
对集合执行递归搜索。对于每个输出文档,添加一个新的数组字段,其中包含该文档的递归搜索的遍历结果。 |
$group |
按指定的标识符表达式对文档进行分组,并将累加器表达式(如果已指定)应用于每个组。消耗所有输入文档,并为每个不同的组输出一个文档。输出文档仅包含标识符字段,如果指定,则包含累积字段。 |
$indexStats |
返回有关集合的每个索引的使用的统计信息。 |
$limit |
将未修改的前n个文档传递给管道,其中n是指定的限制。对于每个输入文档,输出一个文档(对于前n个文档)或零文档(在前n个文档之后)。 |
$listSessions |
列出活动时间足以传播到system.sessions集合的所有会话。 |
$lookup |
对同一数据库中的另一个集合执行左外连接,以 从“已连接”集合中过滤文档以进行处理。 |
$match |
过滤文档流以仅允许匹配的文档未经修改地传递到下一个管道阶段。 $match使用标准的MongoDB查询。对于每个输入文档,输出一个文档(匹配)或零文档(不匹配)。 |
$out |
将聚合管道的结果文档写入集合。要使用$out舞台,它必须是管道中的最后一个阶段。 |
$project |
重新整形流中的每个文档,例如添加新字段或删除现有字段。对于每个输入文档,输出一个文档。 |
$redact |
通过基于文档本身中存储的信息限制每个文档的内容来重塑流中的每个文档。包含$project和的功能 $match。可用于实现字段级别的编辑。对于每个输入文档,输出一个或零个文档。 |
$replaceRoot |
用指定的嵌入文档替换文档。该操作将替换输入文档中的所有现有字段,包括_id字段。指定嵌入在输入文档中的文档以将嵌入文档提升到顶层。 |
$sample |
从输入中随机选择指定数量的文档。 |
$skip |
跳过前n个文档,其中n是指定的跳过编号,并将未修改的其余文档传递给管道。对于每个输入文档,输出零文档(对于前n个文档)或一个文档(如果在前n个文档之后)。 |
$sort |
按指定的排序键重新排序文档流。只有订单改变; 文件保持不变。对于每个输入文档,输出一个文档。 |
$sortByCount |
根据指定表达式的值对传入文档进行分组,然后计算每个不同组中的文档计数。 |
$unwind |
从输入文档解构数组字段以输出每个元素的文档。每个输出文档都使用元素值替换数组。对于每个输入文档,输出n个文档,其中n是数组元素的数量,对于空数组,可以为零。 |
对于要在管道阶段中使用的聚合表达式运算符,请参阅 聚合管道运算符。
1 | expression:聚合表达式 |
db.aggregate()
从3.6版开始,MongoDB还提供了以下 db.aggregate方法:以下阶段使用db.aggregate()方法而不是db.collection.aggregate()方法。
| 阶段 | 描述 |
|---|---|
$currentOp |
返回有关MongoDB部署的活动和/或休眠操作的信息。 |
$listLocalSessions |
列出最近在当前连接mongos或mongod 实例上使用的所有活动会话。这些会话可能尚未传播到system.sessions集合中。 |
聚合api
$project(更改原有字段的输出,维度是_id,即每一条数据不变)
将包含请求字段的文档传递到管道中的下一个阶段。指定的字段可以是输入文档或新计算字段中的现有字段。
1 | { $project: { <specification(s)> } } |
该$project需要,可以指定包含字段的压制文档_id领域,增加新的字段,以及现有字段的值的复位。或者,您可以指定 字段的排除。
该$project规范有以下几种形式:
| 形成 | 描述 |
|---|---|
<field>: <1 or true> |
指定包含字段。 |
_id: <0 or false> |
指定_id字段的抑制。要有条件地排除字段,请改用REMOVE 变量。有关详细信息,请参阅有条件地排除字段。 |
<field>: <expression> |
添加新字段或重置现有字段的值。在版本3.6中更改: MongoDB 3.6添加了变量REMOVE。如果表达式求值为$$REMOVE,则在输出中排除该字段。有关详细信息,请参阅有条件地排除字段。 |
<field>:<0 or false> |
版本3.4中的新功能。指定排除字段。要有条件地排除字段,请改用REMOVE 变量。有关详细信息,请参阅有条件地排除字段。如果您指定排除其他字段_id,则不能使用任何其他$project 规范表单。此限制不适用于使用REMOVE 变量有条件地排除字段。 |
注意事项
包含现有字段
_id默认情况下,该字段包含在输出文档中。要在输出文档中包含输入文档中的任何其他字段,必须明确指定包含在中$project。- 如果指定包含文档中不存在的字段,则
$project忽略该字段包含,并且不将该字段添加到文档中。
取消_id字段
默认情况下,该_id字段包含在输出文档中。要从_id输出文档中排除字段,必须明确指定_id字段 的抑制$project。
排除字段
版本3.4中的新功能。
如果指定排除某个或多个字段,则在输出文档中返回所有其他字段。
如果指定排除除以外的字段_id,则不能使用任何其他$project规范表单:即,如果排除字段,则不能指定包含字段,重置现有字段的值或添加新字段。此限制不适用于使用REMOVE变量对字段进行条件排除 。
有条件地排除字段
版本3.6中的新功能。
从MongoDB 3.6开始,您可以使用REMOVE聚合表达式中的变量来有条件地抑制字段。有关示例,请参阅有条件排除字段。
添加新字段或重置现有字段
要添加新字段或重置现有字段的值,请指定字段名称并将其值设置为某个表达式。有关表达式的更多信息,请参阅表达式。
文字值
若要将字段值直接设置为数字或布尔文字,而不是将字段设置为解析为文字的表达式,请使用$literal运算符。否则, $project将数字或布尔文字视为包含或排除字段的标志。
字段重命名
通过指定新字段并将其值设置为现有字段的字段路径,可以有效地重命名字段。
新数组字段
从MongoDB 3.2开始,$projectstage支持使用方括号[]直接创建新的数组字段。如果数组规范包含文档中不存在的字段,则该操作将替换null为该字段的值。有关示例,请参阅Project New Array Fields。
嵌入文档字段
在嵌入文档中投影或添加/重置字段时,您可以使用点表示法,如
"contact.address.country": <1 or 0 or expression>
contact: { address: { country: <1 or 0 or expression> } }
当嵌套的领域,你不能使用点表示法嵌入文档中指定的领域,比如是无效的。contact: {"address.country": <1 or 0 or expression> }
限制
在版本3.4中更改。
如果$project 规范是空文档,MongoDB 3.4及更高版本会产生错误。
示例
1.在输出文档中包含特定字段
考虑一个books包含以下文档的集合:
1 | { |
2.抑制_id输出文档中的字段
_id默认情况下始终包含该字段。要从舞台_id 的输出文档中$project排除该_id字段,请通过0在投影文档中将其设置为指定字段的排除。
考虑一个books包含以下文档的集合:
1 | { |
3.从输出文档中排除字段
版本3.4中的新功能。
考虑一个books包含以下文档的集合
1 | { |
从嵌入式文档中排除字段
版本3.4中的新功能。
考虑一个books包含以下文档的集合
1 | { |
4.有条件地排除字段
版本3.6中的新功能。
从MongoDB 3.6开始,您可以使用REMOVE聚合表达式中的变量来有条件地抑制字段。
考虑一个books包含以下文档的集合:
1 | { |
5.包含嵌入式文档中的特定字段
考虑一个bookmarks包含以下文档的集合:
1 | { _id: 1, user: "1234", stop: { title: "book1", author: "xyz", page: 32 } } |
6.包含计算字段
考虑一个books包含以下文档的集合:
1 | { |
7.项目新数组字段
例如,如果集合包含以下文档:
1 | { "_id" : ObjectId("55ad167f320c6be244eb3b95"), "x" : 1, "y" : 1 } |
如果数组规范包含文档中不存在的字段,则该操作将替换null为该字段的值。
例如,给定相同的文档如上述,以下的动作项目的字段x,y以及一个不存在的字段 $someField作为一个新的领域元素myArray:
1 | db.collection.aggregate( [ { $project: { myArray: [ "$x", "$y", "$someField" ] } } ] ) |
$out
获取聚合管道返回的文档并将它们写入指定的集合。该
$out操作者必须在最后阶段的管道。版本3.2.0中已更改: MongoDB 3.2添加了对文档验证的支持。该
bypassDocumentValidation字段使您可以$out在聚合操作阶段绕过文档验证 。这使您可以插入不符合验证要求的文档。指定bypassDocumentValidation聚合方法或命令的选项。
{ $out: "<output-collection>" }
$out 获取一个指定输出集合名称的字符串。
重要
行为
创建新集合
$out如果当前数据库尚不存在,则该操作将在当前数据库中创建新集合。在聚合完成之前,集合不可见。如果聚合失败,MongoDB不会创建集合。
替换现有集合
如果$out操作指定的集合已存在,则在完成聚合后,该$out 阶段将使用新结果集合原子替换现有集合。具体来说,$out操作:
- 创建临时集合。
- 将索引从现有集合复制到临时集合。
- 将文档插入临时集合中。
- 调用
db.collection.renameCollection与 到临时集合重命名为目的地集合。dropTarget: true
该$out操作不会更改先前集合中存在的任何索引。如果聚合失败,则$out操作不会对预先存在的集合进行任何更改。
索引约束
如果管道生成的文档违反任何唯一索引(包括_id原始输出集合字段的索引),则管道将无法完成 。
交易
$out在交易中不允许。
示例
集合books包含以下文档:
1 | { "_id" : 8751, "title" : "The Banquet", "author" : "Dante", "copies" : 2 } |
$group(根据不同的字段进行统计,或者输出)
按一些指定的表达式对文档进行分组,并为每个不同的分组输出到下一个阶段的文档。输出文档包含一个
_id按键包含不同组的字段。输出文档还可以包含存储由分组一些累加器表达式的值来计算字段$group的_id字段。$group并没有 责令其输出文档。
该$group阶段具有以下原型形式:
1 | { $ group : {_ id : < expression > , < field1 >: { < accumulator1 > : < expression1 > }, ... } } |
该_id字段是强制性的 ; 但是,您可以指定 _idnull值或任何其他常量值,以计算所有输入文档的累计值。
其余的计算字段是可选的,并使用<accumulator>运算符计算 。
在_id和<accumulator>表达式可以接受任何有效的表达。有关表达式的更多信息,请参阅表达式
注意事项
累加运算符
该<accumulator>操作必须是以下之一:
| 名称 | 描述 |
|---|---|
$addToSet |
返回每个组的唯一表达式值数组。数组元素的顺序未定义。 |
$avg |
返回数值的平均值。忽略非数字值。 |
$first |
返回每个组的第一个文档中的值。仅在文档按定义的顺序定义时才定义订单。 |
$last |
返回每个组的最后一个文档的值。仅在文档按定义的顺序定义时才定义订单。 |
$max |
返回每个组的最高表达式值。 |
$mergeObjects |
返回通过组合每个组的输入文档创建的文档。 |
$min |
返回每个组的最低表达式值。 |
$push |
返回每个组的表达式值数组。 |
$stdDevPop |
返回输入值的总体标准偏差。 |
$stdDevSamp |
返回输入值的样本标准偏差。 |
$sum |
返回数值的总和。忽略非数字值。 |
$group运算符和内存
该$group阶段的RAM限制为100兆字节。默认情况下,如果阶段超出此限制,$group将产生错误。但是,要允许处理大型数据集,请将allowDiskUse选项设置 true为启用$group操作以写入临时文件。有关详细信息,请参阅db.collection.aggregate()方法和 aggregate命令。
版本2.6中更改: MongoDB为$group舞台引入了100兆字节的RAM限制, 以及allowDiskUse处理大型数据集操作的选项。
示例
1.计算计数,总和和平均值
给出sales包含以下文档的集合:
1 | { "_id" : 1, "item" : "abc", "price" : 10, "quantity" : 2, "date" : ISODate("2014-03-01T08:00:00Z") } |
按月,日和年分组
以下聚合操作使用$group阶段按月,日和年对文档进行分组,并计算总价格和平均数量,并计算每个组的文档:
1 | db.sales.aggregate( |
2.分组null
下面的聚合操作指定一组_id的 null,计算总价格和平均数量以及计数集合中的所有文件:
1 | db.sales.aggregate( |
也可以看看
3.检索不同的值
给出sales包含以下文档的集合:
1 | { "_id" : 1, "item" : "abc", "price" : 10, "quantity" : 2, "date" : ISODate("2014-03-01T08:00:00Z") } |
4.Pivot Data
1 | { "_id" : 8751, "title" : "The Banquet", "author" : "Dante", "copies" : 2 } |
分组文件author
以下聚合操作使用$$ROOT 系统变量按作者对文档进行分组。生成的文件不得超过限制。
BSON Document Size:最大BSON文档大小为16兆字节。
最大文档大小有助于确保单个文档不会使用过多的RAM,或者在传输过程中使用过多的带宽。为了存储大于最大大小的文档,MongoDB提供了GridFS API。有关GridFS的更多信息,请参阅驱动程序
mongofiles的文档。
1 | db.books.aggregate( |
$unwind(统计数组的每一个值,输出以该值为维度的数据,数据变多了,其他值一样)
从输入文档解构数组字段以输出每个元素的文档。每个输出文档都是输入文档,其中数组字段的值由元素替换。
该$unwind阶段具有以下两种语法之一:
- 操作数是一个字段路径:要指定字段路径,请在字段名称前加上美元符号,
$并用引号括起来
1 | { $unwind: <field path> } |
- 操作数是一个文件:
1 | { |
| 领域 | 类型 | 描述 |
|---|---|---|
path |
string | 数组字段的字段路径。要指定字段路径,请在字段名称前加上美元符号,$并用引号括起来。 |
includeArrayIndex |
string | 可选的。用于保存元素的数组索引的新字段的名称。该名称不能以美元符号开头$。 |
preserveNullAndEmptyArrays |
boolean | 可选的。如果true,如果path为null,缺少或为空数组,则$unwind输出文档。如果false,$unwind如果path为null,缺少或空数组, 则不输出文档。默认值为false。 |
行为
非阵列场路径
版本3.2中更改:$unwind非数组操作数上的阶段不再出错。如果操作数未解析为数组但未丢失,null或空数组,$unwind则将操作数视为单个元素数组。
以前,如果字段路径指定的字段中的值 不是数组,db.collection.aggregate()则会生成错误。
缺少字段
如果为输入文档中不存在的字段指定路径,或者该字段为空数组,则$unwind默认情况下会忽略输入文档,并且不会输出该输入文档的文档。
版本3.2中的新增功能:要输出缺少数组字段的文档,null或空数组,请使用该选项preserveNullAndEmptyArrays。
示例
展开数组
考虑inventory使用以下文档:
1 | { "_id" : 1, "item" : "ABC1", sizes: [ "S", "M", "L"] } |
includeArrayIndex和preserveNullAndEmptyArrays¶
版本3.2中的新功能。
集合inventory包含以下文件:
1 | { "_id" : 1, "item" : "ABC", "sizes": [ "S", "M", "L"] } |
以下$unwind操作使用该 includeArrayIndex选项输出数组元素的数组索引。
1 | db.inventory.aggregate( [ { $unwind: { path: "$sizes", includeArrayIndex: "arrayIndex" } } ] ) |
以下$unwind操作使用该 preserveNullAndEmptyArrays选项在输出中包含sizes缺少字段的文档,null或空数组。
1 | db.inventory.aggregate( [ |
$match
过滤文档以仅将符合指定条件的文档传递到下一个管道阶段。
该$match阶段具有以下原型形式:
1 | { $match: { <query> } } |
$match获取指定查询条件的文档。查询语法与读操作查询语法相同; 即 $match不接受原始聚合表达式。相反,使用$expr查询表达式包含聚合表达式$match。
行为
Pipeline Optimization
- 放置
$match在聚集早 管道越好。由于$match限制了聚合管道中的文档总数,因此先前的$match操作可以最大限度地减少管道的处理量。 - 如果您
$match在管道的最开头放置一个,则查询可以利用其他任何索引db.collection.find()或索引db.collection.findOne()。
限制
该$match查询语法等同于读出操作查询语法; 即 $match不接受原始聚合表达式。要包含聚合表达式$match,请使用$expr查询表达式:
1 | { $match: { $expr: { <aggregation expression> } } } |
您不能在 查询中使用
$near或作为聚合管道的一部分。作为替代方案,您可以:$nearSphere$match- 使用
$geoNear舞台而不是$match舞台。 - 使用
$geoWithin查询运营商,$center或$centerSphere在$match阶段。
- 使用
要
$text在$match舞台上使用,$match舞台必须是管道的第一阶段。视图不支持文本搜索。
示例
平等匹配
这些示例使用以articles下列文档命名的集合:
1 | { "_id" : ObjectId("512bc95fe835e68f199c8686"), "author" : "dave", "score" : 80, "views" : 100 } |
执行计数
以下示例使用$match管道运算符选择要处理的文档 ,然后将结果通过$group管道传输给管道运算符以计算文档计数:
1 | db.articles.aggregate( [ |
$lookup
版本3.2中的新功能。
对同一 数据库中的未整数集合执行左外连接,以从“已连接”集合中过滤文档以进行处理。对于每个输入文档,该
$lookup阶段添加一个新的数组字段,其元素是来自“已连接”集合的匹配文档。该$lookup阶段通过这些重塑文件到下一阶段。
语法
该$lookup阶段具有以下语法:
平等匹配
要在输入文档中的字段与“已加入”集合的文档中的字段之间执行相等匹配,该 $lookup阶段具有以下语法:
1 | { |
在$lookup需要具有以下字段的文档:
| 领域 | 描述 |
|---|---|
from |
指定同一数据库中的集合以执行连接。该from集合无法分片。有关详细信息,请参阅Sharded Collection Restrictions。 |
localField |
指定输入到$lookup舞台的文档中的字段 。$lookup执行上的平等匹配localField到foreignField从的文档from 集合。如果输入文档不包含该输入文档 localField,则$lookup将该字段视为具有null用于匹配目的的值。注意如果您localField是一个数组,则可能需要$unwind在管道中添加一个 阶段。否则,之间的平等条件localField,并 foreignField为。foreignField: { $in: [localField.elem1, localField.elem2, ... ] }请参阅此页面上的示例。 |
foreignField |
指定from 集合中文档的字段。$lookup执行上的平等匹配foreignField到localField从输入文件。如果from集合中的文档不包含foreignField,$lookup则将值视为null匹配目的。 |
as |
指定要添加到输入文档的新数组字段的名称。新数组字段包含from集合中的匹配文档。如果输入文档中已存在指定的名称,则会覆盖现有字段 。 |
该操作将对应于以下伪SQL语句:
1 | SELECT *, <output array field> |
请参阅以下示例:
加入条件和不相关的子查询
版本3.6中的新功能。
要在两个集合之间执行不相关的子查询以及允许除单个相等匹配之外的其他连接条件,该 $lookup阶段具有以下语法:
1 | { |
在$lookup需要具有以下字段的文档:
| 领域 | 描述 |
|---|---|
from |
指定同一数据库中的集合以执行连接。该from集合无法分片。有关详细信息,请参阅Sharded Collection Restrictions。 |
let |
可选的。指定要在pipeline字段阶段中使用的变量。使用变量表达式从输入到$lookup舞台的文档中访问字段。在pipeline不能直接访问输入文档字段。相反,首先定义输入文档字段的变量,然后引用中的阶段中的变量pipeline。要访问中的let变量pipeline,请使用 $expr运算符。注意该let变量是在该阶段访问 pipeline,包括额外的$lookup嵌套的阶段pipeline。 |
pipeline |
指定要在已连接集合上运行的管道。该 pipeline决定从加入集合生成的文件。要返回所有文档,请指定一个空管道 []。在pipeline不能直接访问输入文档字段。相反,首先定义输入文档字段的变量,然后引用中的阶段中的变量pipeline。要访问中的let变量pipeline,请使用 $expr运算符。注意该let变量是在该阶段访问 pipeline,包括额外的$lookup嵌套的阶段pipeline。 |
as |
指定要添加到输入文档的新数组字段的名称。新数组字段包含from集合中的匹配文档。如果输入文档中已存在指定的名称,则会覆盖现有字段 。 |
该操作将对应于以下伪SQL语句:
1 | SELECT *, <output array field> |
请参阅以下示例:
考虑
视图和整理
如果执行涉及多个视图的聚合(例如使用$lookup或)$graphLookup,则视图必须具有相同的排序规则。
分片收集限制
在$lookup阶段,from收集不能被 分片。但是,可以对运行该aggregate()方法的集合 进行分片。也就是说,在以下内容中:
1 | db.collection.aggregate([ |
- 该
collection可以分片。 - 在
fromCollection不能分片。
因此,要将分片集合与未分片集合连接,您可以在分片集合上运行聚合并查找未整理的集合; 例如:
1 | db.shardedCollection.aggregate([ |
或者,或者要连接多个分片集合,请考虑:
示例
执行单个等式连接$lookup
orders使用以下文档创建集合:
1 | db.orders.insert([ |
inventory使用以下文档创建另一个集合:
1 | db.inventory.insert([ |
在下面的聚合操作orders系列外,从文件orders从文件 inventory使用的字段集合item从 orders收集和sku从外地inventory 收集:
1 | db.orders.aggregate([ |
该操作将对应于以下伪SQL语句:
1 | SELECT *, inventory_docs |
使用$lookup与数组
如果您localField是一个数组,并且您希望将其中的元素与foreignField单个元素进行匹配,则您需要$unwind将该数组作为聚合管道的一个阶段。
考虑一个orders包含以下文档的集合:
1 | { "_id" : 1, "item" : "MON1003", "price" : 350, "quantity" : 2, "specs" : |
另一个集合inventory包含以下文档:
1 | { "_id" : 1, "sku" : "MON1003", "type" : "Monitor", "instock" : 120, |
以下聚合操作对orders集合中的文档执行连接,这些文档 将specs 数组的特定元素size与inventory集合中的字段进行匹配。
1 | db.orders.aggregate([ |
使用$lookup与$mergeObjects
在版本3.6中更改: MongoDB 3.6添加了$mergeObjects运算符以将多个文档合并到单个文档中
orders使用以下文档创建集合:
1 | db.orders.insert([ |
下面的操作首先使用$lookup阶段加入由两个集合item的字段,然后使用 $mergeObjects在$replaceRoot给加盟的文件从合并items和orders:
1 | db.orders.aggregate([ |
使用指定多个连接条件$lookup
在版本3.6中更改: MongoDB 3.6添加了对在已加入集合上执行管道的支持,这允许指定多个连接条件以及不相关的子查询。
1 | db.orders.insert([ |
以下操作将orders集合与 warehouse项目集合以及库存中的数量是否足以覆盖订购数量:
1 | db.orders.aggregate([ |
该操作将对应于以下伪SQL语句:
1 | SELECT *, stockdata |
不相关的子查询
在版本3.6中更改: MongoDB 3.6添加了对在已加入集合上执行管道的支持,这允许指定多个连接条件以及不相关的子查询。
absences使用以下文档创建集合:
1 | db.absences.insert([ |
以下操作将absences集合与集合中的2018个假日信息结合在一起holidays:
1 | db.absences.aggregate([ |
该操作将对应于以下伪SQL语句:
1 | SELECT *, holidays |