문서 삭제

이 페이지의 내용

개요

샘플 데이터
삭제 작업
문서 하나 삭제
여러 문서 삭제
삭제 작업 사용자 지정
API 문서

개요

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

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

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.

삭제 작업

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

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

각 삭제 함수는 다음 매개변수를 허용합니다.

Collection: 수정할 컬렉션 을 지정합니다.
쿼리 필터하다 문서 : 삭제 컬렉션 문서를 지정합니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션을 참조하세요.
결과 위치: 작업 결과를 포함할 덮어쓸 수 있는 저장 에 대한 포인터 또는 NULL 을 지정합니다.
오류 위치: 오류 값 또는 NULL 의 위치 를 지정합니다.

문서 하나 삭제

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

bson_t *filter = BCON_NEW ("name", BCON_UTF8 ("Ready Penny Inn"));
bson_error_t error;
if (!mongoc_collection_delete_one (collection, filter, NULL, NULL, &error)) {
    printf ("Delete error: %s\n", error.message);
}
bson_destroy (filter);

여러 문서 삭제

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

bson_t *filter = BCON_NEW ("borough", BCON_UTF8 ("Brooklyn"));
bson_error_t error;
if (!mongoc_collection_delete_many (collection, filter, NULL, NULL, &error)) {
    printf ("Delete error: %s\n", error.message);
}
bson_destroy (filter);

삭제 작업 사용자 지정

옵션 값을 지정하는 BSON 문서 를 전달하여 mongoc_collection_delete_one() 및 mongoc_collection_delete_many() 함수의 동작을 수정할 수 있습니다. 다음 표에서는 문서 에서 설정하다 수 있는 몇 가지 옵션을 설명합니다.

필드	설명
`collation`	Specifies the kind of language collation to use when comparing text. For more information, see Collation in the MongoDB Server manual. Type: `bson_t`
`writeConcern`	Sets the write concern for the operation. Defaults to the write concern of the namespace. Type: `mongoc_write_concern_t`
`let`	Specifies a document with a list of values to improve operation readability. Values must be constant or closed expressions that don't reference document fields. For more information, see the let statement in the MongoDB Server manual. Type: `bson_t`
`comment`	A comment to attach to the operation. For more information, see the insert command fields guide in the MongoDB Server manual. Type: `bson_value_t`

다음 예시 에서는 mongoc_collection_delete_many() 함수를 호출하여 "Mongo" 문자열이 포함된 name 값이 있는 restaurants 컬렉션 의 모든 문서를 삭제 합니다. 또한 comment 옵션을 설정하여 작업에 주석을 추가합니다.

bson_t *filter = BCON_NEW ("name", "{", "$regex", BCON_UTF8 ("Mongo"), "}");
bson_error_t error;
bson_t opts;
bson_init(&opts);
BCON_APPEND (&opts, "comment", BCON_UTF8 ("Deleting Mongo restaurants"));
if (!mongoc_collection_delete_many (collection, filter, &opts, NULL, &error)) {
    printf ("Delete error: %s\n", error.message);
}
bson_destroy (filter);
bson_destroy (&opts);

팁

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

API 문서

이 가이드 에서 설명하는 함수에 학습 보려면 다음 API 문서를 참조하세요.

돌아가기

문서 업데이트

대량 쓰기 작업