문서 삽입

개요

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

삽입 작업은 하나 이상의 문서를 MongoDB 컬렉션 에 삽입합니다. 다음 함수를 사용하여 삽입 작업을 수행할 수 있습니다.

• mongoc_collection_insert_one() 단일 문서 삽입하는 함수

• mongoc_collection_insert_many() 하나 이상의 문서를 삽입하는 함수

_id 필드

MongoDB 컬렉션에서 각 문서에는 고유한 필드 값이 있는 _id 필드가 포함되어야 합니다.

MongoDB를 사용하면 이 필드를 두 가지 방법으로 관리할 수 있습니다.

• 각 문서 의 _id 필드 를 직접 설정하여 각 값이 고유하도록 합니다.

• 운전자 가 각 문서 _id 필드 에 대해 고유한 bson_oid_t 값을 자동으로 생성하도록 합니다.

고유성을 보장할 수 없는 경우 드라이버가 _id 값을 자동으로 생성하도록 하는 것이 좋습니다.

_id 필드에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 고유 인덱스 가이드를 참조하세요.

문서 구조 및 규칙에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 문서 가이드를 참조하세요.

문서 하나 삽입

MongoDB 컬렉션 에 단일 문서 추가하려면 mongoc_collection_insert_one() 함수를 호출하고 다음 매개변수를 전달합니다.

• 문서를 삽입하는 컬렉션

• 삽입할 문서

• 작업을 사용자 지정하는 옵션 또는 NULL

• 작업 결과를 포함할 덮어쓸 수 있는 저장 에 대한 포인터 또는 NULL

• 오류 값의 위치 또는 NULL

다음 구문을 사용하여 문서 삽입합니다.

bson_t *document = BCON_NEW("<field name>", BCON_UTF8("<value>"));
bson_error_t error;
if (!mongoc_collection_insert_one(
    collection, document, NULL, NULL, &error)) {
    fprintf(stderr, "Insert one operation failed: %s\n", error.message);
}
bson_destroy(document);

다음 예시에서는 restaurants 컬렉션에 문서를 삽입합니다.

bson_t *document = BCON_NEW("name", BCON_UTF8("Mongo's Burgers"));
bson_error_t error;
if (!mongoc_collection_insert_one(collection, document, NULL, NULL, &error)) {
    fprintf(stderr, "Insert one operation failed: %s\n", error.message);
}
bson_destroy(document);

여러 문서를 삽입합니다.

MongoDB 컬렉션 에 여러 문서를 추가하려면 mongoc_collection_insert_many() 함수를 호출하고 다음 매개변수를 전달합니다.

• 문서를 삽입하는 컬렉션

• 삽입하려는 문서에 대한 포인터 배열

• 삽입할 문서 수

• 작업을 사용자 지정하는 옵션 또는 NULL

• 작업 결과를 포함할 덮어쓸 수 있는 저장 에 대한 포인터 또는 NULL

• 오류 값의 위치 또는 NULL

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

size_t num_docs = 2;
bson_t *docs[num_docs];
docs[0] = BCON_NEW("<field name>", BCON_UTF8("<value>"));
docs[1] = BCON_NEW("<field name>", BCON_UTF8("<value>"));
bson_error_t error;
if (!mongoc_collection_insert_many(collection, (const bson_t **) docs, num_docs, NULL, NULL, &error)) {
    fprintf(stderr, "Insert many operation failed: %s\n", error.message);
}
bson_destroy(docs[0]);
bson_destroy(docs[1]);

다음 예시 에서는 restaurants 컬렉션 에 두 개의 문서를 삽입합니다.

size_t num_docs = 2;
bson_t *docs[num_docs];
docs[0] = BCON_NEW("name", BCON_UTF8("Mongo's Burgers"));
docs[1] = BCON_NEW("name", BCON_UTF8("Mongo's Pizza"));
bson_error_t error;
if (!mongoc_collection_insert_many(collection, (const bson_t **) docs, num_docs, NULL, NULL, &error)) {
    fprintf(stderr, "Insert many operation failed: %s\n", error.message);
}
bson_destroy(docs[0]);
bson_destroy(docs[1]);

삽입 동작 수정

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

size_t num_docs = 3;
bson_t *docs[num_docs];
docs[0] = BCON_NEW("name", BCON_UTF8("Mongo's Burgers"));
docs[1] = BCON_NEW("name", BCON_UTF8("Mongo's Pizza"));
docs[2] = BCON_NEW("name", BCON_UTF8("Mongo's Tacos"));
bson_t opts;
bson_init(&opts);
bson_append_bool(&opts, "bypassDocumentValidation", -1, true);
bson_error_t error;
if (!mongoc_collection_insert_many(collection, (const bson_t **) docs, num_docs, &opts, NULL, &error)) {
    fprintf(stderr, "Insert many operation failed: %s\n", error.message);
}
bson_destroy(docs[0]);
bson_destroy(docs[1]);
bson_destroy(docs[2]);
bson_destroy(&opts);

추가 정보