$avg (축적자 연산자)

정의

$avg

문서 그룹 전체에 걸쳐 숫자 값의 평균을 반환합니다.

$avg 축적자는 다음 단계에서 사용할 수 있습니다.

참고

명확화

이 페이지에서는 $avg을 축적자로 사용할 때에 대해 설명합니다. 축적자는 입력 문서 그룹 전체에 걸쳐 합계, 최댕값 또는 최소값과 같은 단일 집계 값을 반환합니다.

$avg를 다른 다음 문맥에서도 사용할 수 있습니다:

$avg (expression), 배열에서 숫자 요소의 평균을 반환합니다.
$avg (window function)는 $setWindowFields 단계에서 특정 창의 문서에서 값의 평균을 반환하는 데 사용됩니다.

구문

{ $avg: <expression> }

행동

결과 유형

기본값 반환 유형은 double입니다. 입력 값 중 하나라도 10진수이면 반환 유형은 10진수입니다.

숫자가 아니거나 누락된 값

$avg 누락된 값을 포함하여 숫자가 아닌 값을 무시합니다. 모든 입력 값이 숫자가 아닌 경우, $avg이 null을 반환합니다.

배열 피연산자

피연산자가 배열로 해석되면 $avg는 피연산자를 숫자가 아닌 값으로 취급합니다.

예시

다음 문서로 sales 컬렉션을 생성합니다.

db.sales.insertMany( [   { _id: 1, item: "abc", price: 10, quantity: 2, date: ISODate("2014-01-01T08:00:00Z") },   { _id: 2, item: "jkl", price: 20, quantity: 1, date: ISODate("2014-02-03T09:00:00Z") },   { _id: 3, item: "xyz", price: 5, quantity: 5, date: ISODate("2014-02-03T09:05:00Z") },   { _id: 4, item: "abc", price: 10, quantity: 10, date: ISODate("2014-02-15T08:00:00Z") },   { _id: 5, item: "xyz", price: 5, quantity: 10, date: ISODate("2014-02-15T09:12:00Z") }] )

다음 작업은 다음을 수행합니다.

item 필드를 기준으로 문서를 그룹화합니다.
$avg 축적자를 사용하여 각 그룹에 대한 평균 금액과 평균 수량을 계산합니다.

db.sales.aggregate(   [     {       $group:         {           _id: "$item",           avgAmount: { $avg: { $multiply: [ "$price", "$quantity" ] } },           avgQuantity: { $avg: "$quantity" }         }     }   ])

출력:

[   { _id: 'xyz', avgAmount: 37.5, avgQuantity: 7.5 },   { _id: 'abc', avgAmount: 60, avgQuantity: 6 },   { _id: 'jkl', avgAmount: 20, avgQuantity: 1 }]

돌아가기

$addToSet

$bottom