db. 컬렉션. 업데이트() (mongosh 메서드)

매개변수

db.collection.update() 메서드는 다음 매개변수를 사용합니다.

{
  <variable_name_1>: <expression_1>,
  ...,
  <variable_name_n>: <expression_n>
}

반환

이 메서드는 작업 상태가 포함된 WriteResult 문서를 반환합니다.

제한 사항

multi: true를 설정한 경우 update() 메서드는 멱등 연산에만 사용하세요.

업데이트에서 $expr 사용 Upsert

$expr 연산자를 사용하려고 하면 업서트 플래그가 true로 설정된 상태에서 오류가 발생합니다.

샤드 컬렉션

샤딩된 컬렉션에서 db.collection.update()를 multi: false와 함께 사용하려면 _id 필드에 정확히 일치하는 항목을 포함하거나 단일 샤드를 대상으로 지정해야 합니다(예: 샤드 키 포함).

db.collection.update()가 업데이트 작업을 수행할 때(문서 교체 작업은 아님) db.collection.update()는 여러 샤드를 대상으로 할 수 있습니다.

{ _id: <value>, <shardkeyfield>: null } // _id of the document missing shard key

트랜잭션

db.collection.update()는 분산 트랜잭션 내에서 사용할 수 있습니다.

oplog 항목

db.collection.update() 작업이 문서를 한 개 이상 성공적으로 업데이트하는 경우 작업은 업데이트된 문서마다 oplog(작업 로그)에 항목을 추가합니다. 작업이 실패하거나 업데이트할 문서를 찾지 못하면 작업은 oplog에 항목을 추가하지 않습니다.

점으로 구분된 _id 쿼리로 업서트

upsert: true 로 update()를 실행할 때 쿼리와 일치하는 기존 문서가 없는 경우, 쿼리가 점 표기법을 사용하여 _id 필드에 조건을 지정하면 MongoDB는 새 문서 삽입을 거부합니다.

이 제한은 _id 문서에 포함된 필드 순서가 잘 정의되고 쿼리에 지정된 순서에 바인딩되지 않도록 합니다.

이러한 방식으로 문서 삽입하려고 하면 MongoDB 오류가 발생합니다.

중복 값이 포함된 업서트

중복을 방지하는 고유 인덱스 가 없는 경우 업서트는 중복 문서를 생성할 수 있습니다.

클라이언트가 데이터를 성공적으로 삽입하기 전에 모든 db.collection.update() 작업이 쿼리 단계를 완료하고, 그리고 name 필드에 고유 인덱스가 없는 경우 각 db.collection.update() 작업에서 삽입이 발생하여 name: Andy(으)로 여러 문서가 생성될 수 있습니다.

name 필드 의 고유 인덱스 하나의 문서 만 생성되도록 합니다. 고유 인덱스 적용되면 이제 여러 db.collection.update() 작업이 다음과 같은 동작을 나타냅니다.

• 정확히 하나의 db.collection.update() 작업으로 새 항목이 성공적으로 삽입됩니다.

  문서.

• 다른 db.collection.update() 작업은 새로 삽입 업데이트

  문서 또는 고유 키 충돌로 인해 실패합니다.

  다른 db.collection.update() 작업에서 새로 삽입된 문서 업데이트 하려면 다음 조건을 모두 충족해야 합니다.

  • 대상 컬렉션 다음을 유발하는 고유 인덱스 가 있습니다.

    중복 키 오류.

  • 업데이트 작업이 updateMany 이 아니거나 multi 이(가)

    false.

  • 업데이트 일치 조건은 둘 중 하나입니다:

    • 단일 동등성 조건자. 예를 들면 다음과 같습니다. { "fieldA" : "valueA" }

    • 동등성 조건자의 논리적 AND. 예를 들면 다음과 같습니다. { "fieldA" : "valueA", "fieldB" : "valueB" }

  • 등호 조건자의 필드는 다음 필드와 일치합니다.

    고유 인덱스 키 패턴.

  • 업데이트 작업은 다음의 어떤 필드도 수정하지 않습니다.

    고유 인덱스 키 패턴.

배열 업데이트 작업

업데이트 문서에서 $[<identifier>] 필터링된 위치 연산자를 사용하여 식별자를 정의한 다음 배열 필터 문서에서 이를 참조합니다. 식별자가 업데이트 문서에 포함되어 있지 않으면 식별자에 대한 배열 필터 문서를 가질 수 없습니다.

<identifier>는 소문자로 시작해야 하며 영숫자만 포함할 수 있습니다.

업데이트 문서에 동일한 식별자를 여러 번 포함할 수 있습니다. 그러나 업데이트 문서의 각 고유 식별자($[identifier])에 대해 해당 정확히 하나 만 배열 필터 문서를 지정해야 합니다. 즉, 동일한 식별자에 대해 여러 배열 필터 문서를 지정할 수 없습니다. 그러나 단일 필터 문서에서 동일한 식별자에 복합 조건을 지정할 수 있습니다.

성공적인 결과

db.collection.update() 메서드는 작업 상태가 포함된 WriteResult() 객체 반환합니다. 성공 하면 WriteResult() 객체 에는 쿼리 조건과 일치하는 문서 수, 업데이트 로 삽입된 문서 수, 수정된 문서 수가 포함됩니다.

우려 사항 오류 쓰기

db.collection.update() 메서드에서 쓰기 고려 (write concern) 오류가 발생하면 결과에 WriteResult.writeConcernError 필드 포함됩니다.

다음 표에서는 WriteResult.writeConcernError.provenance의 가능한 값에 대해 설명합니다.

쓰기 우려와 관련이 없는 오류

db.collection.update() 메서드에서 비 쓰기 고려 (write concern) 오류가 발생하면 결과에 WriteResult.writeError 필드 포함됩니다.

일치하는 항목이 없는 경우 새 문서 삽입(Upsert)

upsert: true옵션을 지정하는 경우:

• 문서가 쿼리 기준과 일치하면 db.collection.update()가 업데이트를 수행합니다.

• 쿼리 기준과 일치하는 문서가 없는 경우 db.collection.update()(은)는 단일 문서를 삽입합니다.

  참고

  동일한 업서트가 거의 동시에 여러 개 발급되는 경우 update()를 upsert: true와 함께 사용하여 중복 문서를 만들 수 있습니다. 자세한 내용은 중복 값으로 업서트를 참조하십시오.

샤딩된 컬렉션에 upsert: true를 지정하는 경우 filter에 전체 샤드 키를 포함해야 합니다. 샤딩된 컬렉션에 대한 추가 db.collection.update() 동작은 샤딩된 컬렉션을 참조하세요.

다음 탭에서는 update()와 함께 upsert 수정자를 다양하게 사용하는 방법을 보여 줍니다.

db.movies.update(
   { title: "Test Movie 12345" },
   { 
      $set: {
         title: "Test Movie 12345", 
         year: 2024, 
         genres: [ "Documentary" ],
         rated: "NR"
      }
   },
   { upsert: true }
)

db.movies.update(
   { title: "Test Movie 67890" },   // Query parameter
   {                                // Update document
      $set: { rated: "PG" },
      $setOnInsert: { year: 2024, type: "movie" }
   },
   { upsert: true }                 // Options
)

db.movies.update(
   { title: "Test Movie ABC123" },  // Query parameter
   [                                // Aggregation pipeline
      { $set: { 
         year: 2024, 
         type: "movie",
         rated: "NR",
         lastModified: "$$NOW" 
      } }
   ],
   { upsert: true }   // Options
)

db.movies.update(
   { title: { $in: ["The Godfather", "The Matrix"] } },
   { $set: { test_upsert_field: true } },
   { upsert: true, multi: true }
)

db.movies.update(
   { "title": "Test Movie Unique789" },
   { $set: { year: 2024, type: "movie" } },
   { upsert: true, multi: true }
)

집계 파이프라인으로 업데이트하기

db.collection.update() 메서드는 수행할 수정 사항을 지정하는 집계 파이프라인 [ <stage1>, <stage2>, ... ]을(를) 허용할 수 있습니다. 파이프라인은 다음 단계로 구성될 수 있습니다.

• $addFields 및 그 별칭 $set

• $project 및 그 별칭 $unset

• $replaceRoot 및 그 별칭 $replaceWith

집계 파이프라인e을 사용하면 현재 필드 값을 기반으로 조건부 업데이트를 표현하거나 다른 필드의 값을 사용하여 한 필드를 업데이트하는 등 보다 표현력이 풍부한 업데이트 구문을 작성할 수 있습니다.

db.movies.update(
   { title: "The Godfather" },
   [
      { $set: { 
            displayTitle: { $concat: [ "$title", " (", { $toString: "$year" }, ")" ] },
            lastModified: "$$NOW" 
         } 
      }
   ]
)

db.movies.update(
   { 
      year: 2015,
      "imdb.rating": { $type: "number" },
      "tomatoes.viewer.rating": { $type: "number" }
   },
   [
      { $set: { 
         combinedScore: { 
            $round: [ 
               { $avg: [ 
               { $multiply: [ "$imdb.rating", 10 ] }, 
               { $multiply: [ "$tomatoes.viewer.rating", 10 ] } 
               ] }, 
               1 
            ] 
         }, 
         lastUpdate: "$$NOW" 
         } 
      },
      { $set: { 
         grade: { 
            $switch: {
               branches: [
               { case: { $gte: [ "$combinedScore", 80 ] }, then: "A" },
               { case: { $gte: [ "$combinedScore", 70 ] }, then: "B" },
               { case: { $gte: [ "$combinedScore", 60 ] }, then: "C" },
               { case: { $gte: [ "$combinedScore", 50 ] }, then: "D" }
               ],
               default: "F"
            } 
         } 
         } 
      }
   ],
   { multi: true }
)

배열 업데이트 작업에 arrayFilters 지정

db.movies.update(
   { languages: "English" },
   { $set: { "languages.$[element]" : "EN" } },
   {
      arrayFilters: [ { "element": "English" } ],
      multi: true
   }
)

db.movies.update(
   { title: "The Godfather" },
   { $set: { "writers.$[elem]" : { $concat: [ "$elem", " - UPDATED" ] } } },
   {
      arrayFilters: [ { "elem": { $regex: /screenplay/ } } ]
   }
)

업데이트 작업에 hint 지정

hint 옵션을 사용하면 MongoDB 업데이트 작업에 사용할 인덱스 지정할 수 있습니다. 이는 여러 문서를 업데이트하고 성능을 위해 특정 인덱스 사용되도록 하려는 경우에 유용합니다. 이 예시 sample_mflix 데이터베이스 의 기존 movies 컬렉션 사용합니다.

먼저 year 필드 에 인덱스 만듭니다.

db.movies.createIndex( { year: 1 } )

다음 업데이트 작업은 { year: 1 } 인덱스를 사용하여 2010-2015의 모든 영화를 업데이트하도록 명시적으로 제안합니다.

db.movies.update(
   { year: { $gte: 2010, $lte: 2015 } },  // Query parameter
   { $set: { decade: "2010s" } },             // Update document
   { multi: true, hint: { year: 1 } }          // Options
)

사용된 인덱스를 보려면 작업에 대해 explain을 실행하세요.

db.movies.explain().update(
   { title: "The Godfather", year: { $gte: 1970 } },
   { $set: { test_hint_field: true } },
   { hint: { year: 1 } }
)

db.collection.explain().update()은 문서를 수정하지 않습니다.

에서 변수 사용 let

명령의 다른 곳에서 액세스할 수 있는 변수를 정의하려면 let 옵션을 사용합니다.

예시입니다:

• let 옵션에서 두 개의 변수를 정의합니다: targetTitle ( "The 매트릭스"로 설정하다 ) 및 newTitle ("매트릭스 리로디드"로 설정하다 )

• 쿼리 필터하다 에서 $expr 을 사용하여 문서의 title 필드 $$targetTitle 변수와 비교합니다.

• $set 과 함께 집계 파이프라인 사용하여 title 필드 $$newTitle값으로 업데이트 .

db.movies.update(
   { $expr: { $eq: [ "$title", "$$targetTitle" ] } },
   [ { $set: { sequel: "$$sequelTitle" } } ],
   { let : { targetTitle: "The Matrix", sequelTitle: "The Matrix Reloaded" } }
)

기본 쓰기 우려 재정의

복제본 집합에 대한 다음 작업은 w: 2 의 쓰기 우려를 5000밀리초의 wtimeout 으로 지정합니다. 이 작업은 쓰기가 운영 서버와 보조 서버 모두에 전파되거나 5초 후에 타임아웃된 후에 반환됩니다.

db.movies.update(
   { num_mflix_comments: { $lte: 10 } },
   { $set: { featured: true } },
   {
      multi: true,
      writeConcern: { w: 2, j: true, wtimeout: 5000 }
   }
)

w: 2에 지정된 대로 프라이머리 와 하나 이상의 세컨더리 에서 쓰기 (write) 확인한 후 작업이 성공적으로 완료됩니다.

샤딩된 클러스터의 쓰기 고려(write concern) 오류

db.collection.update() 이 샤딩된 클러스터의 mongos 에서 실행되면 하나 이상의 다른 오류가 발생하더라도 항상 응답에서 writeConcernError 이 보고됩니다. 이전 릴리스에서는 다른 오류로 인해 db.collection.update() 가 쓰기 고려 (write concern) 오류를 보고하지 않는 경우가 있었습니다.

예시 들어, 문서 유효성 검사 실패하여 DocumentValidationFailed 오류를 트리거하고 쓰기 고려 (write concern) 오류도 발생하면 응답의 최상위 필드 에 DocumentValidationFailed 오류와 writeConcernError 가 모두 반환됩니다.

데이터 정렬 지정

작업에 사용할 데이터 정렬을 지정합니다.

데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다.

데이터 정렬 옵션의 구문은 다음과 같습니다:

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

데이터 정렬을 지정할 때 locale 필드는 필수이고, 다른 데이터 정렬 필드는 모두 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요.

데이터 정렬이 지정되지 않았지만 컬렉션에 기본 데이터 정렬이 있는 경우( db.createCollection() 참조), 작업은 컬렉션에 지정된 데이터 정렬을 사용합니다.

컬렉션 또는 연산에 대한 데이터 정렬이 지정되지 않은 경우, MongoDB는 이전 버전에서 문자열 비교에 사용된 간단한 이진 비교를 사용합니다.

한 연산에 대해 여러 데이터 정렬을 지정할 수 없습니다. 예를 들어 필드별로 서로 다른 데이터 정렬을 지정할 수 없으며 정렬과 함께 찾기를 수행하는 경우 찾기 와 정렬에서 각각 다른 데이터 정렬을 사용하는 것은 허용되지 않습니다.

이 작업은 제목이 night 로 시작하고 대소문자를 구분하지 않는 비교를 위해 strength: 1 을 사용하는 모든 영화를 업데이트합니다.

db.movies.update(
   { title: /^night/i },
   { $set: { updated: true } },
   {
      collation: { locale: "en", strength: 1 },
      multi: true
   }
)