문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/
참조
/
연산자
/
집계 파이프라인 연산자

$stdDevPop (애그리게이션)

이 페이지의 내용

  • 정의
  • 구문
  • 행동
  • 예제

정의

$stdDevPop

버전 5.0에서 변경됨

입력 값의 모집단 표준 편차를 계산합니다. 값이 나타내려는 데이터의 전체 모집단을 포함하고 더 큰 모집단에 대해 일반화하지 않으려는 경우 사용합니다. $stdDevPop 는 숫자가 아닌 값을 무시합니다.

값이 모집단에 대해 일반화할 데이터 모집단의 샘플만을 나타내는 경우 대신 $stdDevSamp 를 사용합니다.

$stdDevPop 이 단계에서 사용할 수 있습니다:

구문

$bucket, $bucketAuto, $group, $setWindowFields 단계에서 사용될 때 $stdDevPop 구문은 다음과 같습니다.

{ $stdDevPop: <expression> }

지원되는 다른 단계에서 사용되는 경우 $stdDevPop은 다음 두 가지 구문 중 하나를 갖습니다.

  • $stdDevPop 는 피연산자로 지정된 표현식 하나를 갖습니다:

    { $stdDevPop: <expression> }

  • $stdDevPop 는 피연산자로 지정된 표현식 목록을 갖습니다:

    { $stdDevPop: [ <expression1>, <expression2> ... ]  }

$stdDevPop의 인수는 배열로 해석되는 한 모든 표현식이 될 수 있습니다.

표현식에 대한 자세한 내용은 표현식을 참조하세요 .

행동

숫자가 아닌 값

$stdDevPop 은 숫자가 아닌 값을 무시합니다. $stdDevPop 의 모든 피연산자가 숫자가 아닌 경우 $stdDevPop 는 null 를 반환합니다.

단일 값

샘플이 단일 숫자 값으로 구성된 경우 $stdDevPop는 0을 반환합니다.

배열 피연산자

$group 및 $setWindowFields 단계에서 표현식이 배열로 해석되는 경우 $stdDevPop 는 피연산자를 숫자가 아닌 값으로 처리하며 계산에 영향을 주지 않습니다.

지원되는 다른 단계에서도 마찬가지입니다:

  • 단일 표현식을 피연산자로 사용해 표현식이 배열로 해석되는 경우 $stdDevPop(은)는 배열을 탐색하여 배열의 숫자 요소에 연산해 단일 값을 반환합니다.

  • 표현식 목록을 피연산자로 사용하는 경우 표현식이 배열로 해석되는 경우 $stdDevPop는 배열로 이동하지 않고 대신 배열을 숫자가 아닌 값으로 처리합니다.

창 값

$setWindowFields 단계 창에서 값을 사용한 동작:

  • 창에서 숫자가 아닌 값, null 값 및 누락된 필드를 무시합니다.

  • 창이 비어 있으면 null 을 반환합니다.

  • 윈도우에 NaN 값이 포함되어 있으면 null 을 반환합니다.

  • 창에 Infinity 값이 포함되어 있으면 null 을 반환합니다.

  • 이전 점 중 어느 것도 적용되지 않으면 double 값을 반환합니다.

예제

단계에서사용 $group

다음 문서를 사용하여 users라는 컬렉션을 만듭니다.

db.users.insertMany( [
   { _id : 1, name : "dave123", quiz : 1, score : 85 },
   { _id : 2, name : "dave2", quiz : 1, score : 90 },
   { _id : 3, name : "ahn", quiz : 1, score : 71 },
   { _id : 4, name : "li", quiz : 2, score : 96 },
   { _id : 5, name : "annT", quiz : 2, score : 77 },
   { _id : 6, name : "ty", quiz : 2, score : 82 }
] )

다음 예시에서는 각 퀴즈의 표준 편차를 계산합니다.

db.users.aggregate( [
   { $group: { _id: "$quiz", stdDev: { $stdDevPop: "$score" } } }
] )

이 연산은 다음과 같은 결과를 반환합니다.

{ "_id" : 2, "stdDev" : 8.04155872120988 }
{ "_id" : 1, "stdDev" : 8.04155872120988 }

단계에서사용 $project

다음 문서를 사용하여 quizzes 라는 이름의 예제 collection을 만듭니다.

db.quizzes.insertMany( [
   {
      _id : 1,
      scores : [
         { name : "dave123", score : 85 },
         { name : "dave2", score : 90 },
         { name : "ahn", score : 71 }
      ]
   },
   {
      _id : 2,
      scores : [
         { name : "li", quiz : 2, score : 96 },
         { name : "annT", score : 77 },
         { name : "ty", score : 82 }
      ]
   }
] )

다음 예시에서는 각 퀴즈의 표준 편차를 계산합니다.

db.quizzes.aggregate( [
   { $project: { stdDev: { $stdDevPop: "$scores.score" } } }
] )

이 연산은 다음과 같은 결과를 반환합니다.

{ _id : 1, stdDev : 8.04155872120988 }
{ _id : 2, stdDev : 8.04155872120988 }

단계에서사용 $setWindowFields

버전 5.0에 추가.

캘리포니아주(CA)와 워싱턴주(WA)의 케이크 판매량이 포함된 cakeSales collection을 생성합니다.

db.cakeSales.insertMany( [
   { _id: 0, type: "chocolate", orderDate: new Date("2020-05-18T14:10:30Z"),
     state: "CA", price: 13, quantity: 120 },
   { _id: 1, type: "chocolate", orderDate: new Date("2021-03-20T11:30:05Z"),
     state: "WA", price: 14, quantity: 140 },
   { _id: 2, type: "vanilla", orderDate: new Date("2021-01-11T06:31:15Z"),
     state: "CA", price: 12, quantity: 145 },
   { _id: 3, type: "vanilla", orderDate: new Date("2020-02-08T13:13:23Z"),
     state: "WA", price: 13, quantity: 104 },
   { _id: 4, type: "strawberry", orderDate: new Date("2019-05-18T16:09:01Z"),
     state: "CA", price: 41, quantity: 162 },
   { _id: 5, type: "strawberry", orderDate: new Date("2019-01-08T06:12:03Z"),
     state: "WA", price: 43, quantity: 134 }
] )

이 예제에서는 $stdDevPop $setWindowFields quantity state단계에서 를 사용하여 각 에 대한 케이크 판매량 의 모집단 표준 편차를 출력합니다.

db.cakeSales.aggregate( [
   {
      $setWindowFields: {
         partitionBy: "$state",
         sortBy: { orderDate: 1 },
         output: {
            stdDevPopQuantityForState: {
               $stdDevPop: "$quantity",
               window: {
                  documents: [ "unbounded", "current" ]
               }
            }
         }
      }
   }
] )

예를 들면 다음과 같습니다.

  • partitionBy: "$state" 는 collection의 문서를 state로 파티셔닝합니다. CA 및 WA에 대한 파티션이 있습니다.

  • sortBy: { orderDate: 1 } 각 파티션의 문서를 orderDate을 기준으로 오름차순(1)으로 정렬하므로, 가장 이른 orderDate이 첫 번째가 됩니다.

  • output 문서 창에서 실행되는 stdDevPopQuantityForState 를 quantity 사용하여 $stdDevPop 필드를 모집단 표준 편차 값으로 설정합니다.

    이 창 에는 unbounded 하한과 출력의 current 문서 사이의 문서가 포함됩니다. 즉, $stdDevPop 은 파티션의 시작 부분과 현재 문서 사이의 문서에 대한 quantity 모집단 표준 편차 값을 반환합니다.

이 예시 출력에서는 CA 및 WA 에 대한 quantity 모집단 표준 편차 값이 stdDevPopQuantityForState 필드에 표시됩니다.

{ _id : 4, type : "strawberry", orderDate : ISODate("2019-05-18T16:09:01Z"),
  state : "CA", price : 41, quantity : 162, stdDevPopQuantityForState : 0 }
{ _id : 0, type : "chocolate", orderDate : ISODate("2020-05-18T14:10:30Z"),
  state : "CA", price : 13, quantity : 120, stdDevPopQuantityForState : 21 }
{ _id : 2, type : "vanilla", orderDate : ISODate("2021-01-11T06:31:15Z"),
  state : "CA", price : 12, quantity : 145, stdDevPopQuantityForState : 17.249798710580816 }
{ _id : 5, type : "strawberry", orderDate : ISODate("2019-01-08T06:12:03Z"),
  state : "WA", price : 43, quantity : 134, stdDevPopQuantityForState : 0 }
{ _id : 3, type : "vanilla", orderDate : ISODate("2020-02-08T13:13:23Z"),
  state : "WA", price : 13, quantity : 104, stdDevPopQuantityForState : 15 }
{ _id : 1, type : "chocolate", orderDate : ISODate("2021-03-20T11:30:05Z"),
  state : "WA", price : 14, quantity : 140, stdDevPopQuantityForState : 15.748015748023622 }

돌아가기

$sqrt

다음

$stdDevSamp

이 페이지의 내용