定义
返回数值数组元素的平均值。
注意
消歧
本页介绍 $avg 当作为表达式使用时,它返回数组中数值元素的平均值。
您还可以在这些其他上下文中使用 $avg:
$avg (accumulator), 它基于可变数量的输入文档返回单一的聚合值。$avg (window function),用于$setWindowFields阶段以返回特定窗口中文档的平均值。
语法
当作为表达式使用时,$avg 具有以下语法之一:
{ $avg: <expression> }在此语法中,操作数是一个单一的表达式,该表达式可解析为数组。$avg 遍历数组,并返回数组中数值的平均值。示例,{ $avg: "$testScores" } 返回 testScores 数组字段中数值的平均值。
{ $avg: [ <expression1>, <expression2> ... ] }在此语法中,输入数组中的每个表达式都是单个数值。$avg返回各个输入值的平均值。如果任何输入表达式解析为数组,$avg 不会遍历该数组,而是将该数组视为非数值。
行为
结果类型
默认返回类型是 double。如果至少有一个输入值是 decimal,则返回类型为 decimal。
非数值或缺失值
$avg 忽略非数字值,包括缺失值。如果所有输入值均非数字,则 $avg 会返回 null。
例子
使用以下文档创建 students 集合:
db.students.insertMany( [ { _id: 1, quizzes: [ 10, 6, 7 ], labs: [ 5, 8 ], final: 80, midterm: 75 }, { _id: 2, quizzes: [ 9, 10 ], labs: [ 8, 8 ], final: 95, midterm: 80 }, { _id: 3, quizzes: [ 4, 5, 5 ], labs: [ 6, 5 ], final: 78, midterm: 70 }] )以下操作在 $project 阶段中使用 $avg 计算以下字段的平均值:
quizzeslabsfinal和midterm的组合平均值
db.students.aggregate( [ { $project: { quizAvg: { $avg: "$quizzes"}, labAvg: { $avg: "$labs" }, examAvg: { $avg: [ "$final", "$midterm" ] } } }] )输出
[ { _id: 1, quizAvg: 7.666666666666667, labAvg: 6.5, examAvg: 77.5 }, { _id: 2, quizAvg: 9.5, labAvg: 8, examAvg: 87.5 }, { _id: 3, quizAvg: 4.666666666666667, labAvg: 5.5, examAvg: 74 }]