선형 채우기(집계)
정의
$linearFill
버전 5.3에 추가.
선형 보간 을
null
사용하여 창 에서 및 누락된 필드를 채웁니다. 주변 필드 값을 기반으로 합니다.$linearFill
는$setWindowFields
스테이지에서만 사용할 수 있습니다.
구문
$linearFill
표현식의 구문은 다음과 같습니다.
{ $linearFill: <expression> }
표현식에 대한 자세한 내용은 표현식을 참조하세요 .
행동
이 선형 보간 을 사용하여 및 누락된 필드를 채웁니다.$linearFill
주변의 비 null
null
필드 값을 기반으로 합니다. 주변 필드 값은 $setWindowFields
에 지정된 정렬 순서에 따라 결정됩니다.
$linearFill
은null
가 아닌 주변 값 사이의 값 범위에 걸쳐null
및 누락된 값을 비례적으로 채웁니다. 누락된 필드의 값을 확인하기 위해$linearFill
는 다음을 사용합니다.null
이 아닌 주변 값의 차이입니다.주변 값 사이를 채울
null
필드의 수입니다.
$linearFill
는$setWindowFields
에 지정된 정렬 순서에 따라null
이 아닌 값이 앞뒤에 있는 경우 여러 개의 연속null
값을 채울 수 있습니다예시
컬렉션에 다음과 같은 문서가 포함된 경우:
{ index: 0, value: 0 }, { index: 1, value: null }, { index: 2, value: null }, { index: 3, value: null }, { index: 4, value: 10 } $linearFill
를 사용하여null
값을 채우면 문서는 다음과 같습니다.{ index: 0, value: 0 }, { index: 1, value: 2.5 }, { index: 2, value: 5 }, { index: 3, value: 7.5 }, { index: 4, value: 10 } 전체 예시는 예시를 참조하세요 .
null
앞뒤에null
이 아닌 값이 오지 않는 값은null
로 유지됩니다.
와 의 $fill
$linearFill
비교
선형 보간 을 사용하여 누락된 필드 값을 채우려면 , 다음을 사용할 수 있습니다.
{ method: "linear" }
이 있는$fill
단계.$fill
단계를 사용하는 경우 출력에 지정하는 필드는 소스 데이터로 사용되는 필드와 동일한 필드입니다. 선형 보간으로 누락된 필드 값 채우기를 참조하세요.단계
$linearFill
$setWindowFields
내의 연산자입니다.$linearFill
연산자를 사용하면 소스 데이터로 사용된 필드와 다른 필드의 값을 설정할 수 있습니다. 단일 단계에서 여러 채우기 메서드 사용을 참조하세요.
예시
이 페이지의 예제에서는 시간 간격으로 단일 회사의 주가를 추적하는 stock
컬렉션을 사용합니다.
db.stock.insertMany( [ { time: ISODate("2021-03-08T09:00:00.000Z"), price: 500 }, { time: ISODate("2021-03-08T10:00:00.000Z"), }, { time: ISODate("2021-03-08T11:00:00.000Z"), price: 515 }, { time: ISODate("2021-03-08T12:00:00.000Z") }, { time: ISODate("2021-03-08T13:00:00.000Z") }, { time: ISODate("2021-03-08T14:00:00.000Z"), price: 485 } ] )
컬렉션의 일부 문서에 대한 price
필드가 누락되었습니다.
선형 보간으로 누락된 값 채우기
선형 보간 을 사용하여 누락된 price
값을 $linearFill
$setWindowFields
채우려면 단계 내에서 를 사용합니다.
db.stock.aggregate( [ { $setWindowFields: { sortBy: { time: 1 }, output: { price: { $linearFill: "$price" } } } } ] )
예시:
sortBy: { time: 1 }
는time
필드를 기준으로 문서를 가장 오래된 것부터 최근 것까지 오름차순으로 정렬합니다.출력 은 다음을 지정합니다.
price
를 누락된 값을 채울 필드로 지정합니다.{ $linearFill: "$price" }
를 누락된 필드의 값으로 지정합니다.$linearFill
은price
선형 보간 을 사용하여 누락된 값을price
채웁니다. 시퀀스의 주변 값을 기반으로 합니다.
출력 예시:
[ { _id: ObjectId("620ad555394d47411658b5ef"), time: ISODate("2021-03-08T09:00:00.000Z"), price: 500 }, { _id: ObjectId("620ad555394d47411658b5f0"), time: ISODate("2021-03-08T10:00:00.000Z"), price: 507.5 }, { _id: ObjectId("620ad555394d47411658b5f1"), time: ISODate("2021-03-08T11:00:00.000Z"), price: 515 }, { _id: ObjectId("620ad555394d47411658b5f2"), time: ISODate("2021-03-08T12:00:00.000Z"), price: 505 }, { _id: ObjectId("620ad555394d47411658b5f3"), time: ISODate("2021-03-08T13:00:00.000Z"), price: 495 }, { _id: ObjectId("620ad555394d47411658b5f4"), time: ISODate("2021-03-08T14:00:00.000Z"), price: 485 } ]
단일 단계에서 여러 채우기 메서드 사용
$setWindowFields
단계를 사용하여 누락된 값을 채우는 경우 채우는 필드와 다른 필드의 값을 설정할 수 있습니다. 따라서 단일 $setWindowFields
단계에서 여러 채우기 메서드를 사용하고 결과를 개별 필드에 출력할 수 있습니다.
다음 파이프라인은 선형 보간과 마지막 관측값 전달 방법을 사용하여 누락된 price
필드를 채웁니다.
db.stock.aggregate( [ { $setWindowFields: { sortBy: { time: 1 }, output: { linearFillPrice: { $linearFill: "$price" }, locfPrice: { $locf: "$price" } } } } ] )
예시:
sortBy: { time: 1 }
는time
필드를 기준으로 문서를 가장 오래된 것부터 최근 것까지 오름차순으로 정렬합니다.출력 은 다음을 지정합니다.
linearFillPrice
를 채울 대상 필드로 지정합니다.{ $linearFill: "$price" }
linearFillPrice
필드의 값입니다.$linearFill
는price
선형 보간 을 사용하여 누락된 값을price
채웁니다. 시퀀스의 주변 값을 기반으로 합니다.
locfPrice
를 채울 대상 필드로 지정합니다.{ $locf: "$price" }
locfPrice
필드의 값입니다.locf
은 마지막으로 이월된 관찰을 나타냅니다.$locf
는 누락된price
값을 시퀀스의 이전 문서의 값으로 채웁니다.
출력 예시:
[ { _id: ObjectId("620ad555394d47411658b5ef"), time: ISODate("2021-03-08T09:00:00.000Z"), price: 500, linearFillPrice: 500, locfPrice: 500 }, { _id: ObjectId("620ad555394d47411658b5f0"), time: ISODate("2021-03-08T10:00:00.000Z"), linearFillPrice: 507.5, locfPrice: 500 }, { _id: ObjectId("620ad555394d47411658b5f1"), time: ISODate("2021-03-08T11:00:00.000Z"), price: 515, linearFillPrice: 515, locfPrice: 515 }, { _id: ObjectId("620ad555394d47411658b5f2"), time: ISODate("2021-03-08T12:00:00.000Z"), linearFillPrice: 505, locfPrice: 515 }, { _id: ObjectId("620ad555394d47411658b5f3"), time: ISODate("2021-03-08T13:00:00.000Z"), linearFillPrice: 495, locfPrice: 515 }, { _id: ObjectId("620ad555394d47411658b5f4"), time: ISODate("2021-03-08T14:00:00.000Z"), price: 485, linearFillPrice: 485, locfPrice: 485 } ]
제한 사항
$linearFill
을 사용하려면 sortBy 필드를 사용하여 데이터를 정렬해야 합니다.창 함수를
$linearFill
사용할 때 는 단일$setWindowFields
파티션 의 sortBy 필드에 반복되는 값이 있는 경우 오류를 반환합니다.