업데이트 (데이터베이스 명령)

업데이트 문

updates 배열의 각 요소는 업데이트 문 문서입니다. 각 문서에는 다음과 같은 필드가 포함되어 있습니다.

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

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

// INVALID
[
  { "x.a": { $gt: 85 } },
  { "x.b": { $gt: 80 } }
]

// Example 1
[
  { $or: [{"x.a": {$gt: 85}}, {"x.b": {$gt: 80}}] }
]
// Example 2
[
  { $and: [{"x.a": {$gt: 85}}, {"x.b": {$gt: 80}}] }
]
// Example 3
[
  { "x.a": { $gt: 85 }, "x.b": { $gt: 80 } }
]

반환

이 명령은 작업 상태가 포함된 문서를 반환합니다. 예시:

{
   "ok" : 1,
   "nModified" : 0,
   "n" : 1,
   "upserted" : [
      {
         "index" : 0,
         "_id" : ObjectId("52ccb2118908ccd753d65882")
      }
   ]
}

출력 필드에 대한 자세한 내용은 출력을 참조하세요.

제한 사항

multi: true를 설정한 경우 update 명령은 멱등 작업에만 사용하세요.

업데이트 연산자 표현식 문서가 포함된 업데이트

업데이트 문 필드 u는 업데이트 연산자 표현식만 포함된 문서를 허용할 수 있습니다. 예시:

updates: [
   {
     q: <query>,
     u: { $set: { status: "D" }, $inc: { quantity: 2 } },
      ...
   },
   ...
]

그런 다음 update 명령은 문서에서 해당 필드만 업데이트합니다.

대체 문서로 업데이트

업데이트 문 필드 u 필드는 교체 문서(예시: 문서에 field:value 표현식만 포함된 문서)를 허용할 수 있습니다. 예를 들면 다음과 같습니다.

updates: [
   {
      q: <query>,
      u: { status: "D", quantity: 4 },
      ...
   },
   ...
]

그런 다음 update 명령은 일치하는 문서를 업데이트 문서로 바꿉니다. update 명령은 일치하는 단일 문서만 바꿀 수 있습니다. 즉, multi 필드는 true 일 수 없습니다. update 명령은 _id 값을 대체하지 않습니다.

다중 업데이트 실패

multi 매개변수가 true로 설정된 업데이트 명령에서 단일 문서가 업데이트되지 않으면 해당 명령의 일부로 추가 문서가 업데이트되지 않습니다.

sample_mflix.movies 예시 들어 imdb.rating 컬렉션 필드가 있는 영화가 movies 포함되어 있습니다.imdb.rating 값이 보다 작거나 같아야 한다는 규칙을 사용하여 컬렉션 에 문서 유효성 검사기를 만듭니다.10

db.runCommand( 
   { 
      update: "movies",
      updates: [
      {
         q: { 
            year: { $gte: 2000, $lte: 2005 },
            "imdb.rating": { $type: "number" }
         }, 
         u: { $inc: { "imdb.rating": 1 } },
         multi: true
      }
      ]
   }
)

이미 평점이 10인 영화가 있는 경우, 평점을 높이면 유효성 검사기 규칙(평점 > 10)을 위반하게 됩니다. 이 경우 수천 개의 문서가 쿼리 와 일치하더라도 업데이트 가 중지되고 추가 문서가 업데이트되지 않습니다.

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

업데이트 문 필드 u 필드는 수행할 수정 사항을 지정하는 집계 파이프라인 [ <stage1>, <stage2>, ... ]를 수락할 수 있습니다. 파이프라인은 다음 단계로 구성될 수 있습니다.

• $addFields 및 그 별칭 $set

• $project 및 그 별칭 $unset

• $replaceRoot 및 그 별칭 $replaceWith

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

예를 들면 다음과 같습니다.

updates: [
   {
      q: <query>,
      u: [
        { $set: { status: "Modified", comments: [ "$misc1", "$misc2" ] } },
        { $unset: [ "misc1", "misc2" ] }
      ],
      ...
   },
   ...
]

예시는 집계 파이프라인으로 업데이트를 참조하세요.

고유 인덱스가 포함된 업서트

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

이름이 Andy인 문서가 없고 여러 클라이언트가 대략 동시에 다음 명령을 실행하는 예시를 가정해 보겠습니다.

db.runCommand(
   {
     update: "people",
     updates: [
       { q: { name: "Andy" }, u: { $inc: { score: 1 } }, multi: true, upsert: true }
     ]
   }
)

클라이언트가 데이터를 성공적으로 삽입하기 전에 모든 update 연산에서 쿼리 단계가 완료되었으며 name 필드에 고유 인덱스가 없는 경우 각 update 연산에서 삽입이 발생하여 name: Andy가 포함된 문서가 여러 개 생성될 수 있습니다.

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

• 정확히 하나의 update 작업으로 새 문서가 성공적으로 삽입됩니다.

• 다른 update 작업은 새로 삽입된 문서를 업데이트하거나 고유 키 충돌로 인해 실패합니다.

  다른 update 작업을 통해 새로 삽입한 문서를 업데이트하려면 다음 조건을 모두 충족해야 합니다.

  • target collection에 중복 키 오류를 일으킬 수 있는 고유 인덱스가 있습니다.

  • 업데이트 작업이 updateMany 이 아니거나 multi 이 false 입니다.

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

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

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

  • 동등성 조건자의 필드는 고유 인덱스 키 패턴의 필드와 일치합니다.

  • 업데이트 작업은 고유 인덱스 키 패턴의 필드를 수정하지 않습니다.

다음 표는 키 충돌이 발생하면 업데이트를 초래하거나 실패하는 upsert 작업의 예를 보여줍니다.

{ name : 1 }

db.people.updateOne(
   { name: "Andy" },
   { $inc: { score: 1 } },
   { upsert: true }
)

{ name : 1 }

db.people.updateOne(
   { name: { $ne: "Joe" } },
   { $set: { name: "Andy" } },
   { upsert: true }
 )

{ name : 1 }

db.people.updateOne(
  { name: "Andy", email: "andy@xyz.com" },
  { $set: { active: false } },
  { upsert: true }
)

제한

updates 배열의 각 update 요소에 대해 쿼리와 업데이트 크기의 합계(즉, q 및 u)는 최대 BSON 문서 크기보다 작거나 같아야 합니다.

updates 배열의 총 업데이트 문 수는 최대 대량 크기 이하여야 합니다.

스키마 유효성 검사

update 명령은 유효성 검사 규칙이 있는 컬렉션에 문서를 삽입하거나 업데이트할 때 스키마 유효성 검사를 우회할 수 있는 bypassDocumentValidation 옵션에 대한 지원을 추가합니다.

샤드 컬렉션

트랜잭션

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

한 문서의 특정 필드 업데이트

업데이트 연산자를 사용하여 문서의 지정된 필드만 업데이트합니다.

예시 들어 sample_mflix 데이터베이스 의 movies 컬렉션 에 있는 문서에는 title, year, num_mflix_comments 등의 필드가 포함되어 있습니다.

다음 명령은 $set 및 $inc 업데이트 연산자를 사용하여 title가 "The Godfather"과 같은 문서의 year 및 num_mflix_comments 필드를 업데이트합니다.

db.runCommand(
   {
      update: "movies",
      updates: [
         {
            q: { title: "The Godfather" }, u: { $set: { year: 1972 }, $inc: { num_mflix_comments: 1 } }
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

<update> 문서는 선택적 multi 필드를 지정하지 않기 때문에 둘 이상의 문서가 q 일치 조건과 일치하더라도 업데이트는 하나의 문서만 수정합니다.

자세한 내용은 출력을 참조하세요.

여러 문서의 특정 필드 업데이트

업데이트 연산자를 사용하여 문서의 지정된 필드만 업데이트하고 true로 설정된 multi 필드를 업데이트 문에 포함합니다.

예시 들어 sample_mflix 데이터베이스 의 movies 컬렉션 에 있는 문서에는 year 및 num_mflix_comments와 같은 필드가 포함되어 있습니다.

다음 명령은 $inc 업데이트 연산자 사용하여 num_mflix_comments 에 개봉된 모든 영화에 대해 필드 1924 증가시킵니다.

db.runCommand(
   {
      update: "movies",
      updates: [
         { 
            q: { year: 1924 }, 
            u: { $inc: { num_mflix_comments: 1 }, $set: { classic: true, era: "silent" } }, 
            multi: true 
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

multi 필드 true로 설정하다 있으므로 업데이트 q 필드 에 지정된 쿼리 와 일치하는 모든 6 문서를 수정하고 다음 출력을 반환합니다.

{ n: 6, nModified: 6, ok: 1 }

자세한 내용은 출력을 참조하세요.

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

update 명령은 업데이트에 집계 파이프라인을 사용할 수 있습니다. 파이프라인은 다음 단계로 구성될 수 있습니다.

• $addFields 및 그 별칭 $set

• $project 및 그 별칭 $unset

• $replaceRoot 및 그 별칭 $replaceWith

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

db.runCommand(
   {
      update: "users",
      updates: [
         { 
            q: { name: "Robert Baratheon" },  
            u: [ 
               { $set: { full_info: { $concat: [ "$name", " - ", "$email" ] } } },
               { $set: { status: "active" } }
            ], 
            multi: false
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

db.runCommand(
   {
      update: "movies",
      updates: [
         { 
            q: { title: "The Great Train Robbery" },  
            u: [ 
                  { $set: { age: { $subtract: [ 2026, "$year" ] } } },
                  { $set: { era: { $switch: { 
                                       branches: [
                                             { case: { $lt: [ "$year", 1960 ] }, then: "Classic" },
                                             { case: { $lt: [ "$year", 1980 ] }, then: "Golden Age" },
                                             { case: { $lt: [ "$year", 2000 ] }, then: "Modern" },                                                   
                                             { case: { $gte: [ "$year", 2000 ] }, then: "Contemporary" }
                                       ],
                                       default: "Unknown" 
                  } } } } 
            ], 
            multi: false
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

대량 업데이트

다음 예시 단일 명령으로 여러 업데이트 작업을 수행하여 기존 문서를 업데이트 하고 새 문서를 삽입합니다. 작업:

• 2015 의 높은 평점을 받은 공포 영화를 다음으로 표시합니다. featured

• 2012 의 단편 드라마 및 로맨스 영화를 다음과 같이 분류합니다. melodrama

• 2024 의 새 공상 과학 영화가 없는 경우 업서트

db.runCommand(
   {
      update: "movies",
      updates: [
         // Update highly-rated Horror movies from 2015
         { 
            q: { year: 2015, genres: "Horror", "imdb.rating": { $gte: 7 } }, 
            u: { $set: { featured: true } },
            multi: true
         },
         // Update short Drama/Romance movies from 2012
         { 
            q: { year: 2012, genres: { $all: ["Drama", "Romance"] }, runtime: { $lt: 90 } }, 
            u: { $set: { category: "melodrama" } },
            multi: true
         },
         // Upsert a new movie from 2026
         { 
            q: { title: "A New Movie", year: 2026 }, 
            u: { 
               $set: { 
                  genres: ["Sci-Fi", "Adventure"],
                  runtime: 142,
                  "imdb.rating": 8.5,
                  featured: true
               }
            },
            upsert: true
         }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

반환된 문서 는 명령이 기존 문서를 수정하고 업서트 통해 새 문서 삽입했음을 보여줍니다.자세한 내용은 출력을 참조하세요.

{
  n: 16,
  upserted: [
    {
      index: 2,
      _id: ObjectId('69861e680e6ea1f51160fe1c')
    }
  ],
  nModified: 15,
  ok: 1,
  '...': '...'
}

데이터 정렬 지정

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

sample_mflix 데이터베이스 의 movies 컬렉션 에 있는 문서에는 title 및 year와 같은 필드가 있습니다.

다음 작업은 데이터 정렬을 사용하여 대소문자를 구분하지 않는 검색 수행합니다. 쿼리 소문자로 "the godfather" 를 검색하지만 strength: 1 데이터 정렬을 사용하면 쿼리 문자에 관계없이 "The Godfather" 와 일치합니다.

db.runCommand({
  update: "movies",
  updates: [
    {
      q: { title: "the godfather" },
      u: { $set: { featured: true } },
      collation: { locale: "en", strength: 1 }
    }
  ]
})

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

배열 필드를 업데이트할 때 업데이트할 배열 요소를 결정하는 arrayFilters를 지정할 수 있습니다.

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

db.runCommand({
   update: "movies",
   updates: [
      { q: { cast: "Al Pacino" }, u: { $set: { "cast.$[elem]" : "REDACTED" } }, arrayFilters: [ { "elem": "Al Pacino" } ], multi: true }
   ]
})

업데이트 hint 작업에 지정

sample_mflix 데이터베이스 의 movies 컬렉션 에 있는 문서에는 year 및 num_mflix_comments와 같은 필드가 있습니다.

컬렉션에 다음 인덱스를 만듭니다.

[
   db.movies.createIndex( { year: 1 } ),
   db.movies.createIndex( { num_mflix_comments: 1 } )
]

다음 업데이트 작업은 '대열차 강도'에 대한 num_mflix_comments 필드 증가시키고 인덱스 { year: 1 }을 사용하도록 명시적으로 힌트합니다.

db.runCommand({
   update: "movies",
   updates: [
      { q: { title: "The Great Train Robbery" }, u: { $inc: { "num_mflix_comments": 1 } }, hint: { year: 1 }, multi: false }
   ]
})

사용된 인덱스 확인하려면 업데이트 작업에서 를 실행 됩니다. 예시 를 들어 이후에 출시된 explain 댓글이 num_mflix_comments 개 이하인 영화에 대해 를 증가시키는 업데이트 에 대한 설명입니다.5 2000

db.runCommand(
   {
      explain: {
         update: "movies",
         updates: [ 
         { q: { "num_mflix_comments": { $lte: 5 }, "year": { $gte: 2000 } }, u: { $inc: { "num_mflix_comments": 1 } }, hint: { year: 1 }, multi: true }
         ]
      },
      verbosity: "queryPlanner"
   }
)

explain은 문서를 수정하지 않습니다.

옵션 let 또는 필드에서 변수 사용 c

변수는 let 옵션 또는 c 필드에서 정의하고 updates 배열에서 액세스할 수 있습니다.

sample_mflix 데이터베이스 의 movies 컬렉션 에 있는 문서에는 title 및 year와 같은 필드가 있습니다.

다음 예시 let 옵션을 사용하여 영화에 새 필드 찾고 추가하기 위한 변수를 정의합니다.

db.runCommand( {
   update: "movies",
   updates: [
      { q: { $expr: { $eq: [ "$title", "$$movieTitle" ] } },
         u: [ { $set: { franchise: "$$franchiseName" } } ] }
   ],
   let : { movieTitle: "The Godfather", franchiseName: "The Godfather Trilogy" }
} )

다음 예시 c 에서 movieTitle 및 franchiseName 변수를 정의하고 변수를 사용하여 franchise 필드 추가합니다.

db.runCommand( {
   update: "movies",
   updates: [
      { q: { $expr: { $eq: [ "$title", "$$movieTitle" ] } },
         u: [ { $set: { franchise: "$$franchiseName" } } ],
         c: { movieTitle: "The Godfather", franchiseName: "The Godfather Trilogy" } }
      ]
} )