/ /

문서 삭제

개요

이 가이드 에서는 C++ 운전자 를 사용하여 삭제 작업 을 수행하여 MongoDB 컬렉션 에서 문서를 제거 하는 방법을 학습 수 있습니다.

삭제 작업은 MongoDB 컬렉션에서 하나 이상의 문서를 제거합니다. delete_one() 또는 delete_many() 메서드를 사용하여 삭제 작업을 수행할 수 있습니다.

샘플 데이터

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

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

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

삭제 작업

다음 방법을 사용하여 삭제 작업을 수행할 수 있습니다.

delete_one()Atlas Search 기준과 일치 하는 첫 번째 문서를 삭제합니다.
delete_many()Atlas Search 기준과 일치하는 모든 문서 를 삭제합니다.

각 삭제 메서드에는 제거할 문서를 결정하기 위한 검색 기준을 지정하는 쿼리 필터하다 문서 가 필요합니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션 을 참조하세요.

문서 하나 삭제

다음 예시 에서는 delete_one() 메서드를 사용하여 restaurants 컬렉션 에서 name 값이 "Ready Penny Inn" 인 문서 를 제거 합니다.

auto result = collection.delete_one(make_document(kvp("name", "Ready Penny Inn")));

여러 문서 삭제

다음 예시 에서는 delete_many() 메서드를 사용하여 restaurants 컬렉션 에서 borough 값이 "Brooklyn" 인 모든 문서를 제거 합니다.

auto result = collection.delete_many(make_document(kvp("borough", "Brooklyn")));

삭제 작업 사용자 지정

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

필드	설명
`collation`	결과를 정렬할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 을 참조하세요.
`write_concern`	작업에 대한 쓰기 고려 (write concern) 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 쓰기 고려를 참조하세요.
`hint`	문서를 스캔할 인덱스를 가져오거나 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 설명 을 참조하세요.
`let`	작업 가독성을 높이기 위해 값 목록이 포함된 문서 지정합니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 자세한 내용은 MongoDB Server 매뉴얼의 let 성명서 참조하세요.
`comment`	작업에 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 삭제 명령 필드 가이드 참조하세요.

다음 예시 에서는 delete_many() 메서드를 호출하여 restaurants 컬렉션 에서 "Mongo" string 이 포함된 name 값이 있는 모든 문서를 삭제 합니다. 또한 mongocxx::options::delete_options 인스턴스 의 comment 필드 를 설정하여 작업에 주석을 추가합니다.

mongocxx::options::delete_options opts{};
opts.comment(bsoncxx::types::bson_value::view_or_value{"Deleting Mongo restaurants"});
auto query_filter = make_document(kvp("name", make_document(kvp("$regex", "Mongo"))));
auto result = collection.delete_many(query_filter.view(), opts);

팁

앞의 예시 에서 delete_many() 대신 delete_one() 메서드를 사용한 경우 운전자 는 "Mongo" 을 포함하는 name 값이 있는 첫 번째 문서 만 삭제 합니다.

반환 값

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

result(), 원시 대량 쓰기 (write) 결과를 반환합니다.
deleted_count()삭제된 문서 수를 반환합니다.

쿼리 필터가 어떤 문서와도 일치하지 않으면 드라이버는 어떤 문서도 삭제하지 않으며 deleted_count 은 0 됩니다.

다음 예시 에서는 delete_many() 메서드를 호출하여 cuisine 값이 "Greek" 인 문서를 삭제 합니다. 그런 다음 deleted_count() 멤버 함수를 호출하여 삭제된 문서 수를 출력합니다.

auto result = collection.delete_many(make_document(kvp("cuisine", "Greek")));
std::cout << result->deleted_count() << std::endl;

Deleted documents: 111

API 문서

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

돌아가기

바꾸기

대량 쓰기