定义
将文档数组合并为单个文档。
注意
消歧
本页介绍了 $mergeObjects 当作为 表达式 使用时的情况,该表达式将合并一个文档数组。
您还可以在这些其他上下文中使用 $mergeObjects:
$mergeObjects (accumulator), 对一组输入文档返回合并的文档。$mergeObjects (window function),用于在$setWindowFields阶段返回来自窗口中的文档的合并文档。
语法
当作为表达式使用时,$mergeObjects 具有如下语法:
{ $mergeObjects: <expression> }<expression> 操作数可以是:
一个单一表达式,评估结果为要合并的文档数组。示例,
$blogPosts,其中文档字段blogPosts包含文档数组。表达式数组,每个表达式都计算为一个文档。示例,
[ "$doc1", "$doc2", "$doc3" ],其中每个文档字段包含单个文档。
行为
$mergeObjects 忽略 null 输入值。如果所有输入值都是 null,$mergeObjects 将返回一个空文档 { }。
$mergeObjects 会在合并文档时覆盖字段值。如果多个输入文档包含相同的字段名,输出包含来自 最后一个包含冲突字段的输入文档的值。
例子 | 结果 |
|---|---|
| |
| |
| |
| |
例子
本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息,请参阅 加载示例数据集。如果您对示例数据库进行了任何修改,您可能需要删除并重新创建数据库,才能运行此页面上的示例。
以下管道在 $replaceWith 中使用 $mergeObjects 将每部电影的 imdb 和 tomatoes.critic 子文档合并到单个 ratings 文档中。两个子文档都包含 rating 字段,因此 $mergeObjects 会使 imdb 评级被 tomatoes.critic 评级覆盖。来自每个子文档的独特字段将在结果中保留。
db.movies.aggregate( [ { $match: { genres: "Action", year: 2010, "imdb.rating": { $exists: true }, "tomatoes.critic.rating": { $exists: true } } }, { $sort: { title: 1 } }, { $limit: 5 }, { $replaceWith: { title: "$title", year: "$year", ratings: { $mergeObjects: [ "$imdb", "$tomatoes.critic" ] } } }] )在前面的管道中:
$match过滤器到来自 2010 的操作电影,具有现有imdb.rating和tomatoes.critic.rating。$sort按title对文档进行字母顺序排序。$limit将输出限制为 5 个文档,以提高可读性。$replaceWith使用$mergeObjects来将$imdb和$tomatoes.critic合并到ratings字段中。因为两个子文档都包含
rating字段,$mergeObjects使用tomatoes.critic中的值(即最后一个参数)。来自
imdb的唯一字段votes和id,以及来自tomatoes.critic的numReviews和meter,均得以保留。