정의
숫자 배열 요소의 평균을 반환합니다.
참고
명확화
이 페이지에서는 배열의 숫자 요소의 평균을 반환하는 표현식으로 사용될 때의 $avg에 대해 설명합니다.
$avg를 다른 다음 문맥에서도 사용할 수 있습니다:
$avg (accumulator), 가변적인 입력 문서 수에 기초하여 단일 집계된 값을 반환합니다.$avg (window function)는$setWindowFields단계에서 특정 창의 문서에서 값의 평균을 반환하는 데 사용됩니다.
구문
표현식으로 사용할 경우, $avg는 다음 구문 중 하나가 있습니다:
{ $avg: <expression> }이 구문에서 피연산자는 배열로 확인되는 단일 표현식입니다. $avg은 배열을 순회하고 배열의 숫자 값의 평균을 반환합니다. 예시, { $avg: "$testScores" }은 testScores 배열 필드에 있는 숫자 값의 평균을 반환합니다.
{ $avg: [ <expression1>, <expression2> ... ] }이 구문에서 입력 배열의 각 표현식은 단일 숫자 값입니다. $avg는 개별 입력 값의 평균값을 반환합니다. 입력 표현식 중 특정 표현식이 배열로 해석되는 경우, $avg은 배열로 이동하지 않고 대신 배열을 숫자가 아닌 값으로 처리합니다.
행동
결과 유형
기본값 반환 유형은 double입니다. 입력 값 중 하나라도 10진수이면 반환 유형은 10진수입니다.
숫자가 아니거나 누락된 값
$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 }]