정의
버전 5.0에 추가.
$setWindowFields 단계 파티션에서 다른 문서를 기준으로 한 문서 위치(순위라고 함)를 반환합니다.
$setWindowFields 단계의 sortBy 필드 값은 문서 순위를 결정합니다. $rank 연산자와 함께 사용되는 경우 sortBy는 하나의 필드만 값으로 취할 수 있습니다. MongoDB가 서로 다른 유형의 필드를 비교하는 방법에 대해 자세히 알아보려면 BSON 비교 순서를 참조하세요.
여러 문서가 동일한 순위를 차지하는 경우 $rank(은)는 후속 값이 있는 문서를 간격이 있는 순위에 배치합니다(동작 참조).
$rank는 $setWindowFields 스테이지에서만 사용할 수 있습니다.
$rank 구문:
{ $rank: { } }
$rank 어떤 매개변수도 허용하지 않습니다.
행동
$rank와 $denseRank는 중복 sortBy 필드 값의 순위를 지정하는 방법이 다릅니다. 예를 들어, sortBy 필드 값이 7, 9, 9및 10인 경우 다음과 같습니다.
$denseRank값의 순위를 1, 2, 2 및 3으로 지정합니다. 중복된 9 값의 순위는 2이고 10의 순위는 3입니다. 순위에는 격차가 없습니다.$rank값의 순위를 1, 2, 2 및 4로 지정합니다. 중복된 9 값의 순위는 2이고 10의 순위는 4입니다. 3위와 순위가 차이가 납니다.
sortBy 필드에 null 값이 있는 문서 또는 sortBy 필드가 누락된 문서에는 BSON 비교 순서에 따라 순위가 지정됩니다.
중복 값, Null 또는 누락된 데이터가 포함된 파티션 순위 지정의 예시를 참조하세요.
예시
캘리포니아주(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 } ] )
정수 필드로 파티션 순위 지정
이 예시에서는 $setWindowFields 단계에서 $rank를 사용하여 각 state에 대해 케이크 판매의 quantity 순위를 출력합니다.
db.cakeSales.aggregate( [ { $setWindowFields: { partitionBy: "$state", sortBy: { quantity: -1 }, output: { rankQuantityForState: { $rank: {} } } } } ] )
예시:
partitionBy: "$state"는 collection의 문서를state로 파티셔닝합니다.CA및WA에 대한 파티션이 있습니다.sortBy: { quantity: -1 }각 파티션의 문서를quantity별로 내림차순(-1)으로 정렬하므로 가장 높은quantity이(가) 첫 번째입니다.
output다음 결과와 같이$rank를 사용하여rankQuantityForState필드를quantity순위로 설정합니다.
{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"), "state" : "CA", "price" : 41, "quantity" : 162, "rankQuantityForState" : 1 } { "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"), "state" : "CA", "price" : 12, "quantity" : 145, "rankQuantityForState" : 2 } { "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"), "state" : "CA", "price" : 13, "quantity" : 120, "rankQuantityForState" : 3 } { "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"), "state" : "WA", "price" : 14, "quantity" : 140, "rankQuantityForState" : 1 } { "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"), "state" : "WA", "price" : 43, "quantity" : 134, "rankQuantityForState" : 2 } { "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"), "state" : "WA", "price" : 13, "quantity" : 104, "rankQuantityForState" : 3 }
날짜 필드별 파티션 순위 지정
이 예시에서는 $setWindowFields 단계에서 날짜와 함께 $rank를 사용하여 각 state에 대해 케이크 판매의 orderDate 순위를 출력하는 방법을 보여줍니다.
db.cakeSales.aggregate( [ { $setWindowFields: { partitionBy: "$state", sortBy: { orderDate: 1 }, output: { rankOrderDateForState: { $rank: {} } } } } ] )
예시:
partitionBy: "$state"는 collection의 문서를state로 파티셔닝합니다.CA및WA에 대한 파티션이 있습니다.sortBy: { orderDate: 1 }각 파티션의 문서를orderDate을 기준으로 오름차순(1)으로 정렬하므로, 가장 이른orderDate이 첫 번째가 됩니다.
output다음 결과와 같이$rank를 사용하여rankOrderDateForState필드를orderDate순위로 설정합니다.
{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"), "state" : "CA", "price" : 41, "quantity" : 162, "rankOrderDateForState" : 1 } { "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"), "state" : "CA", "price" : 13, "quantity" : 120, "rankOrderDateForState" : 2 } { "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"), "state" : "CA", "price" : 12, "quantity" : 145, "rankOrderDateForState" : 3 } { "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"), "state" : "WA", "price" : 43, "quantity" : 134, "rankOrderDateForState" : 1 } { "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"), "state" : "WA", "price" : 13, "quantity" : 104, "rankOrderDateForState" : 2 } { "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"), "state" : "WA", "price" : 14, "quantity" : 140, "rankOrderDateForState" : 3 }
중복된 값, Null 또는 누락된 데이터를 포함하는 순위 파티션
다음에서 cakeSalesWithDuplicates 컬렉션을 만듭니다.
케이크 판매는 캘리포니아주(
CA)와 워싱턴주(WA)에서 이루어집니다.문서 6~8은 문서 5와 동일한
quantity및state을(를) 갖습니다.문서 9에는 문서 4와 동일한
quantity및state이(가) 있습니다.문서 10에는
nullquantity이(가) 있습니다.문서 11에
quantity이(가) 누락되었습니다.
db.cakeSalesWithDuplicates.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 }, { _id: 6, type: "strawberry", orderDate: new Date("2020-01-08T06:12:03Z"), state: "WA", price: 41, quantity: 134 }, { _id: 7, type: "strawberry", orderDate: new Date("2020-01-01T06:12:03Z"), state: "WA", price: 34, quantity: 134 }, { _id: 8, type: "strawberry", orderDate: new Date("2020-01-02T06:12:03Z"), state: "WA", price: 40, quantity: 134 }, { _id: 9, type: "strawberry", orderDate: new Date("2020-05-11T16:09:01Z"), state: "CA", price: 39, quantity: 162 }, { _id: 10, type: "strawberry", orderDate: new Date("2020-05-11T16:09:01Z"), state: "CA", price: 39, quantity: null }, { _id: 11, type: "strawberry", orderDate: new Date("2020-05-11T16:09:01Z"), state: "CA", price: 39 } ] )
이 예시에서는 $setWindowFields단계에서 $rank를 사용하여 각 state의 cakeSalesWithDuplicates 컬렉션에서 quantity순위를 출력합니다.
db.cakeSalesWithDuplicates.aggregate( [ { $setWindowFields: { partitionBy: "$state", sortBy: { quantity: -1 }, output: { rankQuantityForState: { $rank: {} } } } } ] )
예시:
partitionBy: "$state"는 collection의 문서를state로 파티셔닝합니다.CA및WA에 대한 파티션이 있습니다.sortBy: { quantity: -1 }각 파티션의 문서를quantity별로 내림차순(-1)으로 정렬하므로 가장 높은quantity이(가) 첫 번째입니다.
output$rank를 사용하여rankOrderDateForState필드를quantity순위로 설정합니다.
다음 예시 출력은 다음과 같습니다.
동일한
quantity및state을(를) 가진 문서는 순위가 동일합니다. 문서의 순위가 동일하면 해당 순위와 다음 순위 사이에 간격이 있습니다.nullquantity이(가) 있는 문서와 누락된quantity이(가) 있는 문서가CA파티션의 출력에서 가장 낮은 순위로 평가됩니다. 이 정렬은 BSON 비교 순서의 결과로 이 예시에서는 숫자 값 다음에null및 누락된 값을 정렬합니다.
{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"), "state" : "CA", "price" : 41, "quantity" : 162, "rankQuantityForState" : 1 } { "_id" : 9, "type" : "strawberry", "orderDate" : ISODate("2020-05-11T16:09:01Z"), "state" : "CA", "price" : 39, "quantity" : 162, "rankQuantityForState" : 1 } { "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"), "state" : "CA", "price" : 12, "quantity" : 145, "rankQuantityForState" : 3 } { "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"), "state" : "CA", "price" : 13, "quantity" : 120, "rankQuantityForState" : 4 } { "_id" : 10, "type" : "strawberry", "orderDate" : ISODate("2020-05-11T16:09:01Z"), "state" : "CA", "price" : 39, "quantity" : null, "rankQuantityForState" : 5 } { "_id" : 11, "type" : "strawberry", "orderDate" : ISODate("2020-05-11T16:09:01Z"), "state" : "CA", "price" : 39, "rankQuantityForState" : 6 } { "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"), "state" : "WA", "price" : 14, "quantity" : 140, "rankQuantityForState" : 1 } { "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"), "state" : "WA", "price" : 43, "quantity" : 134, "rankQuantityForState" : 2 } { "_id" : 6, "type" : "strawberry", "orderDate" : ISODate("2020-01-08T06:12:03Z"), "state" : "WA", "price" : 41, "quantity" : 134, "rankQuantityForState" : 2 } { "_id" : 7, "type" : "strawberry", "orderDate" : ISODate("2020-01-01T06:12:03Z"), "state" : "WA", "price" : 34, "quantity" : 134, "rankQuantityForState" : 2 } { "_id" : 8, "type" : "strawberry", "orderDate" : ISODate("2020-01-02T06:12:03Z"), "state" : "WA", "price" : 40, "quantity" : 134, "rankQuantityForState" : 2 } { "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"), "state" : "WA", "price" : 13, "quantity" : 104, "rankQuantityForState" : 6 }