문서 수정

문서 패턴 업데이트

MongoDB에서 문서를 변경하는 모든 메서드는 동일한 패턴을 따릅니다.

이러한 메서드는 다음 매개 변수를 사용합니다:

• 변경할 하나 이상의 문서를 일치시키는 쿼리 필터

• 필드 및 값 변경 사항을 지정하는 업데이트 문서

• (선택 사항) 메서드의 기본 동작을 수정하는 옵션 유형입니다.

Rust 드라이버는 다음과 같은 방법으로 문서를 변경할 수 있습니다:

• update_one()

• update_many()

• replace_one()

복합 작업을 사용하여 한 번의 조치로 데이터를 검색하고 수정할 수 있습니다. 자세한 내용은 복합 연산 가이드를 참조하세요.

_id 필드

MongoDB collection의 각 문서에는 고유하고 변경할 수 없는 _id 필드가 있습니다. 업데이트 또는 교체 작업을 통해 _id 필드를 변경하려고 하면 드라이버는 WriteError 를 발생시키고 업데이트를 수행하지 않습니다.

매개변수

각 메서드는 쿼리 필터와 함께 업데이트 연산자 를 한 개 이상 포함하는 업데이트 문서 를 사용합니다. 업데이트 연산자는 수행할 업데이트 유형을 지정하고 변경 사항을 설명하는 필드와 값을 포함합니다. 업데이트 문서는 다음과 같은 포맷을 사용합니다.

doc! { "<update operator>": doc! { "<field>": <value> } }

하나의 업데이트 문서에 여러 업데이트를 지정하려면 다음 형식을 사용하세요.

doc! {
    "<update operator>": doc!{"<field>": <value>},
    "<update operator>": doc!{"<field>": <value>},
    ...
}

업데이트 연산자 및 설명의 전체 목록은 MongoDB 서버 매뉴얼을 참조하세요.

업데이트 작업에는 UpdateOptions 매개 변수도 사용됩니다. 업데이트 메서드의 동작 수정에 대해 자세히 알아보려면 이 가이드의 업데이트 및 동작 바꾸기 수정 섹션을 참조하세요.

반환 값

작업이 성공하면 update_one() 및 update_many() 메서드는 UpdateResult 유형을 반환합니다. UpdateResult 유형에는 작업을 설명하는 다음과 같은 속성이 포함되어 있습니다.

UpdateOne() 에 전달한 쿼리 필터와 일치하는 문서가 여러 개 있는 경우 메서드는 첫 번째로 일치하는 문서를 선택하고 업데이트합니다. 쿼리 필터와 일치하는 문서가 없는 경우 업데이트 작업은 변경되지 않습니다.

업데이트 예시

다음 문서는 회사 직원에 대해 설명합니다.

{
  "_id": ObjectId('4337'),
  "name": "Shelley Olson",
  "department": "Marketing",
  "role": "Director",
  "bonus": 3000
},
{
  "_id": ObjectId('4902'),
  "name": "Remi Ibrahim",
  "department": "Marketing",
  "role": "Consultant",
  "bonus": 1800
}

이 예에서는 update_many() 메서드를 사용하여 업데이트 작업을 수행합니다. update_many() 메서드는 다음 매개 변수를 사용합니다.

• department 필드의 값이 "Marketing"인 문서를 일치시키는 쿼리 필터

• 다음 업데이트가 포함된 업데이트 문서입니다.

  • 의 값을 로, 의 $set 값을 로 변경하는 연산자 department "Business Operations" role "Analytics Specialist"

  • 의 $inc 값을 만큼 증가시키는 연산자 bonus 500

let update_doc = doc! {
        "$set": doc! { "department": "Business Operations",
                      "role": "Analytics Specialist" },
        "$inc": doc! { "bonus": 500 }
};
let res = my_coll
    .update_many(doc! { "department": "Marketing" }, update_doc, None)
    .await?;
println!("Modified documents: {}", res.modified_count);

Modified documents: 2

다음 문서에는 이전 업데이트 작업의 변경 사항이 반영되어 있습니다.

{
  "_id": ObjectId('4337'),
  "name": "Shelley Olson",
  "department": "Business Operations",
  "role": "Analytics Specialist",
  "bonus": 3500
},
{
  "_id": ObjectId('4902'),
  "name": "Remi Ibrahim",
  "department": "Business Operations",
  "role": "Analytics Specialist",
  "bonus": 2300
}

ObjectId별 업데이트 예시

다음 문서는 회사 직원에 대해 설명합니다.

{
  "_id": ObjectId('4274'),
  "name": "Jill Millerton",
  "department": "Marketing",
  "role": "Consultant"
}

이 예시에서는 문서의 고유한 _id 값과 일치하는 쿼리 필터를 지정하여 이전 문서를 쿼리합니다. 그런 다음 update_one() 메서드로 업데이트 작업을 수행합니다. update_one() 메서드는 다음 매개 변수를 사용합니다.

• _id 필드의 값이 ObjectId('4274')인 문서와 일치하는 쿼리 필터

• name 의 값을 "Jill Gillison"로 설정하는 지침을 생성하는 문서를 업데이트합니다.

let id = ObjectId::from_str("4274").expect("Could not convert to ObjectId");
let filter_doc = doc! { "_id": id };
let update_doc = doc! {
        "$set": doc! { "name": "Jill Gillison" }
};
let res = my_coll
    .update_one(filter_doc, update_doc, None)
    .await?;
println!("Modified documents: {}", res.modified_count);

Modified documents: 1

다음 문서는 이전 업데이트 작업으로 인한 변경 사항을 반영합니다.

{
  "_id": ObjectId('4274'),
  "name": "Jill Gillison",
  "department": "Marketing",
  "role": "Consultant"
}

매개변수

replace_one() 메서드는 쿼리 필터와 기존 문서를 대체할 필드와 값이 포함된 대체 문서 를 사용합니다. 대체 문서는 다음과 같은 포맷을 사용합니다.

doc! { "<field>": <value>, "<field>": <value>, ... }

바꾸기 작업에는 UpdateOptions 매개 변수도 사용됩니다. replace_one() 메서드의 동작 수정에 학습 보려면 이 가이드 의 업데이트 및 바꾸기 동작 수정 섹션을 참조하세요.

Return Values

작업이 성공하면 replace_one 메서드는 UpdateResult 유형을 반환합니다. UpdateResult 유형에는 작업을 설명하는 다음 속성이 포함되어 있습니다.

replace_one() 에 전달한 쿼리 필터와 일치하는 문서가 여러 개 있는 경우 메서드는 첫 번째로 일치하는 문서를 선택하고 대체합니다. 쿼리 필터와 일치하는 문서가 없는 경우 교체 작업은 변경되지 않습니다.

바꾸기 예시

다음 문서는 회사 직원에 대해 설명합니다.

{
  "_id": ObjectId('4501'),
  "name": "Matt DeGuy",
  "role": "Consultant",
  "team_members": [ "Jill Gillison", "Susan Lee" ]
}

이 예에서는 replace_one() 메서드를 사용하여 앞의 문서를 다음 필드가 있는 문서로 바꿉니다.

• "Susan Lee" 의 name 값

• "Lead Consultant" 의 role 값

• [ "Jill Gillison" ] 의 team_members 값

let replace_doc = doc! {
    "name": "Susan Lee",
    "role": "Lead Consultant",
    "team_members": vec! [ "Jill Gillison" ]
};
let res = my_coll
    .replace_one(doc! { "name": "Matt DeGuy" }, replace_doc, None)
    .await?;
println!(
    "Matched documents: {}\nModified documents: {}",
    res.matched_count, res.modified_count
);

Matched documents: 1
Modified documents: 1

대체된 문서에는 대체 문서의 내용과 변경할 수 없는 _id 필드가 포함되어 있습니다.

{
  "_id": ObjectId('4501'),
  "name": "Susan Lee",
  "role": "Lead Consultant",
  "team_members": [ "Jill Gillison" ]
}

API 문서

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 문서를 참조하세요.

• update_one()

• update_many()

• UpdateResult

• UpdateOptions

• replace_one()

• ReplaceOptions

• WriteError