문서 교체

이 페이지의 내용

개요

샘플 데이터
대체 작업
필수 매개변수
예시
바꾸기 작업 수정
대체 옵션 예시
추가 정보
API 문서

개요

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

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

샘플 데이터

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

대체 작업

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`	Specifies whether the replace operation performs an upsert operation if no documents match the query filter. For more information, see the upsert statement in the MongoDB Server manual. Defaults to `false`.
`bypassDocumentValidation`	Specifies whether the replace operation bypasses document validation. This lets you replace documents that don't meet the schema validation requirements, if any exist. For more information about schema validation, see Schema Validation in the MongoDB Server manual. Defaults to `false`.
`collation`	Specifies the kind of language collation to use when comparing text. For more information, see Collation in the MongoDB Server manual.
`hint`	Gets or sets the index to scan for documents. For more information, see the hint statement in the MongoDB Server manual.
`comment`	Attaches a comment to the operation. For more information, see the insert command fields guide in the MongoDB Server manual.

대체 옵션 예시

다음 코드는 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 문서

mongoc_collection_replace_one() 함수에 학습 보려면 API 설명서를 참조하세요.

돌아가기

Insert

Update