$stdDevPop (애그리게이션)
정의
버전 5.0에서 변경됨
입력 값의 모집단 표준 편차를 계산합니다. 값이 나타내려는 데이터의 전체 모집단을 포함하고 더 큰 모집단에 대해 일반화하지 않으려는 경우 사용합니다. $stdDevPop
는 숫자가 아닌 값을 무시합니다.
값이 모집단에 대해 일반화할 데이터 모집단의 샘플만을 나타내는 경우 대신 $stdDevSamp
를 사용합니다.
$stdDevPop
이 단계에서 사용할 수 있습니다:
{ 5} 표현식을 포함하는
$match
단계$expr
$setWindowFields
(MongoDB 5.0부터 사용 가능)
구문
$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 }