定义
返回数组中数值的总和。
注意
$sum 的其他用途
此页面介绍 $sum 用作表达式时,它返回数组中数值的总和。
您还可以在这些其他上下文中使用 $sum:
$sum (accumulator),返回一组文档中数值的总和。$sum (window function),用于在$setWindowFields阶段中计算窗口中值的累积总和。
语法
当作为表达式使用时,$sum 具有以下两种语法之一:
{ $sum: <expression> }在上述语法中,操作数是一个单一的表达式,该表达式的求值结果为数组。$sum 遍历数组并返回数组中数值的总和。
{ $sum: [ <expression1>, <expression2>, ... ] }在前面的语法中,每个表达式都是一个单一的数值。$sum 返回这些值的总和。
行为
结果类型
当混合输入类型时,$sum 会将较小的输入类型提升为两者中较大的输入类型。当一个类型表示更广泛的值范围时,该类型被视为较大。数字类型从小到大的顺序为:integer → long → double → decimal。
较大的输入类型也决定了结果类型,除非操作溢出,超出了较大数据类型所代表的范围。在溢出的情况下,$sum 按照以下顺序推送结果:
非数字或不存在的字段
如果用于同时包含数字值和非数字值的字段,$sum 会忽略非数字值并返回数字值的总和。
如果所有操作数都为非数字,则 $sum 会返回 0。
例子
本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息,请参阅 加载示例数据集。如果您对示例数据库进行了任何修改,您可能需要删除并重新创建数据库,才能运行此页面上的示例。
此示例在 $project 阶段中使用 $sum 用于计算三部电影获得和提名的奖项总数,并将结果存储在名为 totalAwards 的新字段中。
db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Inception", "The Dark Knight" ] } } }, { $project: { _id: 0, title: 1, totalAwards: { $sum: [ "$awards.wins", "$awards.nominations" ] } } }, { $sort: { totalAwards: -1 } }] )前面的管道: