/ /

문서 업데이트

개요

이 가이드 에서는 C++ 운전자 를 사용하여 MongoDB 컬렉션 의 문서를 업데이트 하는 방법을 학습 수 있습니다. update_one() 메서드를 호출하여 단일 문서 를 업데이트 하거나 update_many() 메서드를 호출하여 여러 문서를 업데이트 할 수 있습니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 을 사용합니다. C++ 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 mongocxx::client 를 인스턴스화하고 db 및 collection 변수에 다음 값을 할당합니다.

auto db = client["sample_restaurants"];
auto collection = db["restaurants"];

무료 MongoDB Atlas 클러스터 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 MongoDB 시작하기 가이드 를 참조하세요.

업데이트 작업

다음 방법을 사용하여 MongoDB에서 업데이트 작업을 수행할 수 있습니다.

update_one()검색 조건과 일치하는 첫 번째 문서가 업데이트됩니다.
update_many()검색 조건과 일치하는 모든 문서가 업데이트됩니다.

각 업데이트 방법에는 다음 매개변수가 필요합니다.

쿼리 필터하다 문서: 업데이트 할 문서를 지정합니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션 을 참조하세요.
문서업데이트 : 업데이트 연산자 또는 수행할 업데이트 의 종류, 변경할 필드 및 값을 지정합니다. 업데이트 연산자 목록 및 사용법은 MongoDB Server 매뉴얼의 필드 업데이트 연산자 가이드 를 참조하세요.

하나의 문서 업데이트

다음 예시 에서는 update_one() 메서드를 사용하여 restaurants 컬렉션 에 있는 문서 의 name 값을 "Bagels N Buns" 에서 "2 Bagels 2 Buns" 로 업데이트 합니다.

auto query_filter = make_document(kvp("name", "Bagels N Buns"));
auto update_doc = make_document(kvp("$set", make_document(kvp("name", "2 Bagels 2 Buns"))));
auto result = collection.update_one(query_filter.view(), update_doc.view());

다수 문서 업데이트

다음 예시 에서는 update_many() 메서드를 사용하여 cuisine 값이 "Pizza" 인 모든 문서를 업데이트 합니다. 업데이트 후 문서의 cuisine 값은 "Pasta" 입니다.

auto query_filter = make_document(kvp("cuisine", "Pizza"));
auto update_doc = make_document(kvp("$set", make_document(kvp("cuisine", "Pasta"))));
auto result = collection.update_many(query_filter.view(), update_doc.view());

업데이트 작업 사용자 지정

mongocxx::options::update 클래스의 인스턴스 를 선택적 매개변수로 전달하여 update_one() 및 update_many() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 mongocxx::options::update 인스턴스 에서 설정하다 수 있는 필드에 대해 설명합니다.

필드	설명
`upsert`	쿼리 필터하다 와 일치하는 문서가 없는 경우 업데이트 작업에서 업서트 작업을 수행할지 여부를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 업서트 성명서 참조하세요. 기본값은 `false` 입니다.
`bypass_document_validation`	업데이트 작업에서 문서 유효성 검사 우회할지 여부를 지정합니다. 이를 통해 스키마 유효성 검사 요구 사항을 충족하지 않는 문서(있는 경우)를 업데이트 수 있습니다. 스키마 유효성 검사 에 대한 자세한 내용은 MongoDB Server 매뉴얼의 스키마 유효성 검사 참조하세요. 기본값은 `false` 입니다.
`collation`	결과를 정렬할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 을 참조하세요.
`array_filters`	작업이 배열 필드를 수정하는 경우 업데이트 를 적용할 배열 요소를 지정합니다.
`hint`	문서를 스캔할 인덱스 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 성명서 참조하세요.
`write_concern`	작업에 대한 쓰기 고려 (write concern) 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 쓰기 고려를 참조하세요.
`let`	작업 가독성을 높이기 위해 값 목록이 포함된 문서 지정합니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 자세한 내용은 MongoDB Server 매뉴얼의 let 성명서 참조하세요.
`comment`	작업에 첨부할 주석입니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드를 참조하세요.

다음 예시 에서는 update_many() 메서드를 사용하여 borough 값이 "Manhattan" 인 모든 문서를 찾습니다. 그런 다음 이러한 문서의 borough 값을 "Manhattan (north)" 로 업데이트합니다. upsert 옵션이 true 로 설정하다 되어 있기 때문에 쿼리 필터하다 가 기존 문서와 일치하지 않는 경우 C++ 운전자 는 새 문서 를 삽입합니다.

mongocxx::options::update opts{};
opts.upsert(true);
auto query_filter = make_document(kvp("borough", "Manhattan"));
auto update_doc = make_document(kvp("$set", make_document(kvp("borough", "Manhattan (north)"))));
auto result = collection.update_many(query_filter.view(), update_doc.view(), opts);

반환 값

update_one() 및 update_many() 메서드는 mongocxx::result::update 클래스의 인스턴스 를 반환합니다. 이 클래스에는 다음과 같은 멤버 함수가 포함되어 있습니다.

기능	설명
`matched_count()`	업데이트된 문서 수에 관계없이 쿼리 필터하다 와 일치하는 문서 수를 반환합니다.
`modified_count()`	업데이트 작업으로 수정된 문서 수를 반환합니다. 업데이트된 문서 원본과 동일한 경우 이 계산에 포함되지 않습니다.
`result()`	작업에 대한 원시 결과 문서 반환합니다.
`upserted_count()`	데이터베이스 에 업서트된 문서 수를 반환합니다.
`upserted_id()`	운전자 업서트 수행한 경우 데이터베이스 에 업서트된 문서 의 ID 반환합니다.

다음 예시 에서는 update_many() 메서드를 사용하여 일치하는 문서의 name 필드 를 "Dunkin' Donuts" 에서 "Dunkin'" 로 업데이트 합니다. modified_count() 멤버 함수를 호출하여 수정된 문서 수를 출력합니다.

auto query_filter = make_document(kvp("name", "Dunkin' Donuts"));
auto update_doc = make_document(kvp("$set", make_document(kvp("name", "Dunkin'"))));
auto result = collection.update_many(query_filter.view(), update_doc.view());
std::cout << "Modified documents: " << result->modified_count() << std::endl;

Modified documents: 206

추가 정보

쿼리 필터 생성에 대해 자세히 알아보려면 쿼리 지정 가이드를 참조하세요.

API 문서

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

돌아가기

Insert

바꾸기