对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

$avg(表达式)

$avg

返回数值数组元素的平均值。

注意

消歧

本页介绍 $avg 当作为表达式使用时,它返回数组中数值元素的平均值。

您还可以在这些其他上下文中使用 $avg:

当作为表达式使用时,$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 计算以下字段的平均值:

  • quizzes

  • labs

  • final 和 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 }]
给本页内容打分