문서 수정

문서 패턴 업데이트

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>},
    ...
}

See the MongoDB server manual for a complete list of update operators and descriptions.

Update operations also take an UpdateOptions parameter. To learn about modifying the behavior of the update methods, see the Modify Update and Replace Behavior section of this guide.

반환 값

작업이 성공하면 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>, ... }

Replace operations also take an UpdateOptions parameter. To learn about modifying the behavior of the replace_one() method, see the Modify Update and Replace Behavior section of this guide.

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