문서 교체

개요

이 가이드 에서는 C 운전자 사용하여 MongoDB 컬렉션 에서 대체 작업을 실행 방법을 학습 수 있습니다. 바꾸기 작업은 업데이트 작업과 다르게 수행됩니다. 업데이트 작업은 대상 문서 에서 지정된 필드만 수정합니다. 바꾸기 작업은 대상 문서 의 모든 필드를 제거하고 새 필드로 바꿉니다.

문서 바꾸려면 mongoc_collection_replace_one() 함수를 사용합니다.

샘플 데이터

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

대체 작업

mongoc_collection_replace_one()을(를) 사용하여 바꾸기 작업을 수행할 수 있습니다. 이 함수는 검색 기준과 일치하는 첫 번째 문서 에서 _id 필드 제외한 모든 필드를 제거합니다. 그런 다음 지정한 필드와 값이 문서 에 삽입됩니다.

필수 매개변수

mongoc_collection_replace_one() 함수에는 다음 매개 변수가 필요합니다.

컬렉션: 바꾸기 작업을 수행할 컬렉션 지정합니다.
쿼리 필터하다 문서: 일치시킬 컬렉션 문서를 지정합니다. 이 함수는 교체할 첫 번째 일치 문서 선택합니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션을 참조하세요.
대체 문서: 새 문서 에 삽입할 필드와 값을 지정합니다.
옵션 문서: 작업 또는 NULL을 사용자 지정하는 옵션을 지정합니다.
결과 위치: 작업 결과를 포함할 덮어쓸 수 있는 저장 에 대한 포인터 또는 NULL을 지정합니다.
오류 위치: 오류 값 또는 NULL의 위치 지정합니다.

예시

다음 예시 mongoc_collection_replace_one() 함수를 사용하여 name 필드 값이 "Pizza Town" 인 문서 의 필드와 값을 name 필드 값이 "Mongo's Pizza"인 문서 로 바꿉니다.

bson_t *query = BCON_NEW("name", "Pizza Town");
bson_t *replace = BCON_NEW(
    "name", "Mongo's Pizza",
    "cuisine", "Pizza",
    "address", "{",
    "street", "123 Pizza St",
    "zipCode", "10003",
    "}",
    "borough", "Manhattan"
);
bson_error_t error;
if (!mongoc_collection_replace_one(collection, query, replace, NULL, NULL, &error)) {
    fprintf(stderr, "Replace operation failed: %s\n", error.message);
}
bson_destroy(query);
bson_destroy(replace);

중요

_id 필드의 값은 변경할 수 없습니다. 대체 문서 _id 필드 의 값을 지정하는 경우 기존 문서 의 _id 값과 동일해야 합니다.

바꾸기 작업 수정

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

옵션	설명
`upsert`	쿼리 필터와 일치하는 문서가 없는 경우 대체 작업이 업서트 작업을 수행할지 여부를 지정합니다. 자세한 내용은 MongoDB Server 수동의 업서트 성명서 를 참조하세요. 기본값은 `false`입니다.
`bypassDocumentValidation`	대체 작업이 문서 유효성 검사를 우회하는지 여부를 지정합니다. 이를 통해 스키마 유효성 검사 요구 사항을 충족하지 못하는 문서가 있는 경우 대체할 수 있습니다. 스키마 유효성 검사에 대한 자세한 내용은 MongoDB Server 수동의 스키마 유효성 검사 를 참조하십시오. 기본값은 `false`입니다.
`collation`	텍스트를 비교할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 MongoDB Server 수동의 데이터 정렬 을 참조하십시오.
`hint`	문서를 스캔할 인덱스를 가져오거나 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 설명 을 참조하세요.
`comment`	작업에 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드 참조하세요.

대체 옵션 예시

다음 코드는 mongoc_collection_replace_one() 함수를 사용하여 name 필드 값이 "Food Town"인 첫 번째 문서 찾은 다음 이 문서 name 값이 "Food World"인 새 문서 로 바꿉니다. upsert 옵션이 true로 설정하다 있으므로 쿼리 필터하다 기존 문서와 일치하지 않는 경우 운전자 새 문서 삽입합니다.

bson_t *query = BCON_NEW("name", "Food Town");
bson_t *replace = BCON_NEW(
    "name", "Food World",
    "cuisine", "Mixed",
    "address", "{",
    "street", "123 Food St",
    "zipCode", "10003",
    "}",
    "borough", "Manhattan"
);
bson_error_t error;
bson_t opts;
bson_init(&opts);
bson_append_bool(&opts, "upsert", -1, true);
if (!mongoc_collection_replace_one(collection, query, replace, &opts, NULL, &error)) {
    fprintf(stderr, "Replace operation failed: %s\n", error.message);
} 
bson_destroy(query);
bson_destroy(replace);
bson_destroy(&opts);

추가 정보

업데이트 작업에 학습 보려면 문서 업데이트 가이드 를 참조하세요.

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

API 문서

함수에 대해 자세히 학습 API mongoc_collection_replace_one() 설명서를 참조하세요.

돌아가기

커서에서 데이터 액세스

Update