$replaceRoot (집계)
정의
$replaceRoot
입력 문서를 지정된 문서로 바꿉니다. 이 작업은
_id
필드를 포함하여 입력 문서의 모든 기존 필드를 대체합니다. 기존 내장된 문서를 최상위 레벨로 승격하거나 승격할 새 문서를 생성할 수 있습니다(예시 참조).참고
$replaceWith
단계를 사용할 수도 있습니다.$replaceWith
단계는$replaceRoot
단계와 동일한 작업을 수행하지만 단계의 형태가 다릅니다.$replaceRoot
단계의 형식은 다음과 같습니다.{ $replaceRoot: { newRoot: <replacementDocument> } } 대체 문서는 문서로 해석되는 모든 유효한 표현식일 수 있습니다.
<replacementDocument>
이(가) 문서가 아닌 경우 스테이지 오류가 발생하고 실패합니다. 표현식에 대한 자세한 내용은 표현식 연산자를 참조하세요.
행동
<replacementDocument>
가 문서가 아닌 경우 $replaceRoot
오류가 발생하여 실패합니다.
<replacementDocument>
가 누락된 문서(즉, 문서가 존재하지 않음)로 확인되면 $replaceRoot
오류가 발생하고 실패합니다. 예를 들어, 다음 문서를 사용하여 컬렉션을 만듭니다.
db.collection.insertMany([ { "_id": 1, "name" : { "first" : "John", "last" : "Backus" } }, { "_id": 2, "name" : { "first" : "John", "last" : "McCarthy" } }, { "_id": 3, "name": { "first" : "Grace", "last" : "Hopper" } }, { "_id": 4, "firstname": "Ole-Johan", "lastname" : "Dahl" }, ])
그러면 문서 중 하나에 name
필드가 없기 때문에 다음 $replaceRoot
작업이 실패합니다.
db.collection.aggregate([ { $replaceRoot: { newRoot: "$name" } } ])
이 오류를 방지하려면 $mergeObjects
를 사용하여 name
문서를 일부 기본 문서와 병합하면 됩니다.
db.collection.aggregate([ { $replaceRoot: { newRoot: { $mergeObjects: [ { _id: "$_id", first: "", last: "" }, "$name" ] } } } ])
또한, $match
단계를 포함해 $replaceRoot
단계로 문서를 전달하기 전에 문서 필드의 존재 여부를 확인하여 name
필드가 누락된 문서를 건너뛸 수 있습니다.
db.collection.aggregate([ { $match: { name : { $exists: true, $not: { $type: "array" }, $type: "object" } } }, { $replaceRoot: { newRoot: "$name" } } ])
또는 $ifNull
표현식을 사용하여 다른 문서를 루트로 지정할 수 있습니다. 예시:
db.collection.aggregate([ { $replaceRoot: { newRoot: { $ifNull: [ "$name", { _id: "$_id", missingName: true} ] } } } ])
예시
$replaceRoot
내장된 문서 필드
people
라는 이름의 컬렉션에 다음 문서가 포함되어 있습니다.
{ "_id" : 1, "name" : "Arlene", "age" : 34, "pets" : { "dogs" : 2, "cats" : 1 } } { "_id" : 2, "name" : "Sam", "age" : 41, "pets" : { "cats" : 1, "fish" : 3 } } { "_id" : 3, "name" : "Maria", "age" : 25 }
다음 작업은 $replaceRoot
단계를 사용하여 각 입력 문서를 $mergeObjects
작업의 결과로 바꿉니다. $mergeObjects
표현식은 지정된 기본 문서를 pets
문서와 병합합니다.
db.people.aggregate( [ { $replaceRoot: { newRoot: { $mergeObjects: [ { dogs: 0, cats: 0, birds: 0, fish: 0 }, "$pets" ] }} } ] )
이 연산은 다음과 같은 결과를 반환합니다.
{ "dogs" : 2, "cats" : 1, "birds" : 0, "fish" : 0 } { "dogs" : 0, "cats" : 1, "birds" : 0, "fish" : 3 } { "dogs" : 0, "cats" : 0, "birds" : 0, "fish" : 0 }
$replaceRoot
배열에 중첩된 문서가 있는 경우
students
라는 이름의 컬렉션에 다음 문서가 포함되어 있습니다.
db.students.insertMany([ { "_id" : 1, "grades" : [ { "test": 1, "grade" : 80, "mean" : 75, "std" : 6 }, { "test": 2, "grade" : 85, "mean" : 90, "std" : 4 }, { "test": 3, "grade" : 95, "mean" : 85, "std" : 6 } ] }, { "_id" : 2, "grades" : [ { "test": 1, "grade" : 90, "mean" : 75, "std" : 6 }, { "test": 2, "grade" : 87, "mean" : 90, "std" : 3 }, { "test": 3, "grade" : 91, "mean" : 85, "std" : 4 } ] } ])
다음 작업은 grade
필드가 90
보다 크거나 같은 내장된 문서를 최상위 수준으로 승격합니다.
db.students.aggregate( [ { $unwind: "$grades" }, { $match: { "grades.grade" : { $gte: 90 } } }, { $replaceRoot: { newRoot: "$grades" } } ] )
이 연산은 다음과 같은 결과를 반환합니다.
{ "test" : 3, "grade" : 95, "mean" : 85, "std" : 6 } { "test" : 1, "grade" : 90, "mean" : 75, "std" : 6 } { "test" : 3, "grade" : 91, "mean" : 85, "std" : 4 }
$replaceRoot
에 포함된 새로 만든 문서
$replaceRoot
단계의 일환으로 새 문서를 생성하고 이를 사용해 다른 모든 필드를 대체할 수도 있습니다.
contacts
라는 이름의 컬렉션에 다음 문서가 포함되어 있습니다.
{ "_id" : 1, "first_name" : "Gary", "last_name" : "Sheffield", "city" : "New York" } { "_id" : 2, "first_name" : "Nancy", "last_name" : "Walker", "city" : "Anaheim" } { "_id" : 3, "first_name" : "Peter", "last_name" : "Sumner", "city" : "Toledo" }
다음 작업은 first_name
및 last_name
필드에서 새 문서를 만듭니다.
db.contacts.aggregate( [ { $replaceRoot: { newRoot: { full_name: { $concat : [ "$first_name", " ", "$last_name" ] } } } } ] )
이 연산은 다음과 같은 결과를 반환합니다.
{ "full_name" : "Gary Sheffield" } { "full_name" : "Nancy Walker" } { "full_name" : "Peter Sumner" }
$replaceRoot
에서 생성된 새 문서와 기본 문서가 포함됨<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path $$ROOT
fill=\" \" d=\" \"> <path fill=\" \" d=\" \">
다음 문서를 사용하여 contacts
라는 이름의 샘플 collection을 생성합니다.
db.contacts.insertMany( [ { "_id" : 1, name: "Fred", email: "fred@example.net" }, { "_id" : 2, name: "Frank N. Stine", cell: "012-345-9999" }, { "_id" : 3, name: "Gren Dell", home: "987-654-3210", email: "beo@example.net" } ] )
다음 연산은 $replaceRoot
와 $mergeObjects
를 사용하여 누락된 필드에 대한 기본값이 있는 현재 문서를 출력합니다.
db.contacts.aggregate( [ { $replaceRoot: { newRoot: { $mergeObjects: [ { _id: "", name: "", email: "", cell: "", home: "" }, "$$ROOT" ] } } } ] )
집계는 다음 문서를 반환합니다.
{ _id: 1, name: 'Fred', email: 'fred@example.net', cell: '', home: '' }, { _id: 2, name: 'Frank N. Stine', email: '', cell: '012-345-9999', home: '' }, { _id: 3, name: 'Gren Dell', email: 'beo@example.net', cell: '', home: '987-654-3210' }