문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

$replaceRoot (aggregation)

이 페이지의 내용

  • 정의
  • 행동
  • 예제

정의

$replaceRoot

입력 문서를 지정된 문서로 바꿉니다. 이 작업은 _id 필드를 포함하여 입력 문서의 모든 기존 필드를 대체합니다. 기존 내장된 문서를 최상위 수준으로 승격하거나 승격을 위해 새 문서를 만들 수 있습니다( 예제 참조).

참고

버전 4 부터 시작됩니다.2, MongoDB는 새로운 집계 파이프라인 단계인 $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 $$ROOT 에서 생성된 새 문서와 기본 문서 사용

다음 문서를 사용하여 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'
}
← $redact (aggregation)
$replaceWith (aggregation) →

이 페이지의 내용