문서 삭제

개요

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

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

샘플 데이터

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

삭제 작업

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

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

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

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

문서 하나 삭제

문서 삭제 하려면 다음 구문을 사용합니다.

bson_t *filter = BCON_NEW("<field name>", BCON_UTF8("<value>"));
bson_error_t error;
if (!mongoc_collection_delete_one(collection, filter, NULL, NULL, &error)) {
    fprintf(stderr, "Delete error: %s\n", error.message);
}
bson_destroy(filter);

다음 예시 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);

여러 문서 삭제

여러 문서를 삭제 하려면 다음 구문을 사용합니다.

bson_t *filter = BCON_NEW("<field name>", BCON_UTF8("<value>"));
bson_error_t error;
if (!mongoc_collection_delete_many(collection, filter, NULL, NULL, &error)) {
    fprintf(stderr, "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`	텍스트를 비교할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 MongoDB Server 서버 수동의 데이터 정렬 을 참조하십시오. 유형: `bson_t`
`writeConcern`	작업에 대한 쓰기 고려(write concern)를 설정합니다. 기본값은 네임스페이스의 쓰기 고려(write concern)입니다. 유형: `mongoc_write_concern_t`
`let`	작업 가독성을 향상시키기 위한 값 목록이 포함된 문서를 지정합니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 자세한 내용은 MongoDB Server 수동의 let 성명서 를 참조하십시오. 유형: `bson_t`
`comment`	작업에 첨부할 주석입니다. 자세한 내용은 MongoDB Server 수동의 삽입 명령 필드 가이드를 참조하세요. 유형: `bson_value_t`

다음 예시 mongoc_collection_delete_many() 함수를 호출하여 restaurants 컬렉션 에서 "Mongo" 문자열이 포함된 name 값이 있는 모든 문서를 삭제 . 또한 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 문서를 참조하세요.

돌아가기

Update

대량 쓰기 작업