정의
창에서 입력 문서를 병합하여 생성된 문서를 반환합니다.
참고
명확화
이 페이지에서는 창 함수로 사용될 때의 $mergeObjects에 대해 설명합니다.
$mergeObjects를 다른 다음 문맥에서도 사용할 수 있습니다:
$mergeObjects (accumulator), 입력 문서 그룹 전체에서 병합된 문서를 반환합니다.$mergeObjects (expression), 문서 배열을 단일 문서로 병합합니다.
구문
{ $setWindowFields: { output: { <outputField>: { $mergeObjects: <document>, window: { <documents|range>: [ "unbounded", <upper> ] } } } }}참고
sortBy 옵션은 $setWindowFields에서 위쪽 창 범위가 "unbounded" 인 경우 또는 window가 생략된 경우 선택 사항입니다. sortBy는 상위 창 범위가 "unbounded"이 아닌 경우, "current" 등과 같이 필수입니다.
sortBy을 생략하면 $mergeObjects이 충돌되는 필드 이름을 해결하는 순서는 보장되지 않습니다.
명령 필드
필드 | 유형 | 필요성 | 설명 |
|---|---|---|---|
| 표현식 | 필수 사항 | 문서로 평가되는 필드 이름 또는 표현식입니다. |
| 문서 | 옵션 |
|
행동
제거 불가능한 Windows
$mergeObjects 고정 윈도우만 지원합니다. 이는 하한계가 "unbounded"이란 의미입니다. 하한 경계가 "unbounded"이 아닌 창을 지정하는 경우, 작업이 오류를 반환합니다.
널 입력 처리
$mergeObjects null 입력 값을 무시합니다. 모든 입력 값이 null이면 $mergeObjects은 빈 문서 { }을 반환합니다.
필드 덮어쓰기 동작
$mergeObjects 문서를 병합할 때 필드 값을 덮어쓰님다. 여러 입력 문서에 동일한 필드 이름이 포함되어 있는 경우, 출력에는 충돌하는 필드를 포함하는 마지막 입력 문서의 값이 포함됩니다.
예시
productUpdates collection을 만듭니다.
db.productUpdates.insertMany( [ { _id: 1, product: "gadget", date: ISODate("2024-01-01"), specs: { color: "blue" } }, { _id: 2, product: "gadget", date: ISODate("2024-01-02"), specs: { size: "medium" } }, { _id: 3, product: "gadget", date: ISODate("2024-01-03"), specs: { weight: 0.5 } }, { _id: 4, product: "widget", date: ISODate("2024-01-01"), specs: { color: "red" } }, { _id: 5, product: "widget", date: ISODate("2024-01-02"), specs: { material: "plastic" } }] )각 문서는 새로운 사양 필드를 추가하는 제품 업데이트를 나타냅니다. 각 업데이트가 specs 하위 문서에 다른 필드 이름을 제공하기 때문에, $mergeObjects은 창이 확장됨에 따라 완전한 사양 프로필을 축적할 수 있습니다.
다음 파이프라인은 $setWindowFields에서 $mergeObjects을(를) 사용하여 새 사양이 창에 추가될 때마다 누적적으로 업데이트되는 제품 사양 목록을 반환합니다. 각 문서마다, cumulativeSpecs 에는 현재 문서를 포함하여 이전의 모든 업데이트의 병합된 사양이 포함됩니다:
db.productUpdates.aggregate( [ { $setWindowFields: { partitionBy: "$product", sortBy: { date: 1 }, output: { cumulativeSpecs: { $mergeObjects: "$specs", window: { documents: [ "unbounded", "current" ] } } } } }, { $sort: { product: 1, date: 1 } }, { $project: { _id: 0, product: 1, date: 1, specs: 1, cumulativeSpecs: 1 } }] )이전 파이프라인의 경우:
$setWindowFields는product으로 문서를 파티션합니다. 그리고date로 오름차순으로 정렬합니다.$mergeObjectsunbounded개에서current개까지의 창을 사용하여 각 파티션의 시작부리부터 현재 문서까지의 모든specs문서를 병합하여 누적 지정을 생성합니다.$sort는 최종 결과를product및date를 기준으로 오름차순으로 정렬합니다.