Definición
Devuelve el promedio de los elementos numéricos del arreglo.
Nota
Desambiguación
Esta página describe $avg cuando se utiliza como una expresión, que devuelve el promedio de los elementos numéricos de un arreglo.
También puede usar $avg en estos otros contextos:
$avg (accumulator), que devuelve un único valor agregado basado en un número variable de documentos de entrada.$avg (window function), que se utiliza en la etapa de$setWindowFieldspara devolver el promedio de los valores de los documentos en una ventana determinada.
Sintaxis
Cuando se utiliza como una expresión, $avg tiene una de estas sintaxis:
{ $avg: <expression> }En esta sintaxis, el operando es una única expresión que se resuelve en un arreglo. $avg recorre el arreglo y devuelve el promedio de los valores numéricos del arreglo. Por ejemplo, { $avg: "$testScores" } devuelve el promedio de los valores numéricos en el campo de arreglo testScores.
{ $avg: [ <expression1>, <expression2> ... ] }En esta sintaxis, cada expresión en el arreglo de entrada es un único valor numérico. $avg devuelve el promedio de los valores de entrada individuales. Si alguna de las expresiones de entrada se resuelve en un arreglo, $avg no recorre el arreglo sino que lo trata como un valor no numérico.
Comportamiento
Tipo de resultado
El tipo de retorno por defecto es un double. Si al menos un valor de entrada es un decimal, el tipo de retorno es un decimal.
Valores no numéricos o faltantes
$avg ignora los valores no numéricos, incluidos los valores faltantes. Si todos los valores de entrada no son numéricos, $avg devuelve null.
Ejemplo
Crea una colección students con los siguientes documentos:
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 }] )La siguiente operación utiliza $avg en la $project etapa para calcular promedios para los siguientes campos:
quizzeslabsPromedio combinado de
finalymidterm
db.students.aggregate( [ { $project: { quizAvg: { $avg: "$quizzes"}, labAvg: { $avg: "$labs" }, examAvg: { $avg: [ "$final", "$midterm" ] } } }] )Salida
[ { _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 }]