데이터베이스 및 컬렉션

개요

이 가이드 에서는 C 운전자 를 사용하여 MongoDB 데이터베이스 및 컬렉션과 상호 작용 하는 방법을 학습 수 있습니다.

MongoDB는 데이터를 다음 수준의 계층 구조로 구성합니다.

• 데이터베이스: 컬렉션을 저장 하는 MongoDB deployment 의 최상위 데이터 구조입니다.

• 컬렉션: MongoDB 문서 그룹입니다. 관계형 데이터베이스의 테이블과 유사합니다.

• 문서: string, 숫자, 날짜 및 기타 내장된 문서와 같은 리터럴 데이터를 저장 하는 단위입니다. 문서 필드 유형 및 구조에 대한 자세한 내용은 MongoDB Server 매뉴얼의 문서 가이드 를 참조하세요.

데이터베이스에 액세스

mongoc_client_get_database() 함수를 사용하여 데이터베이스 에 액세스합니다.

다음 예제에서는 "test_database" 데이터베이스에 액세스합니다.

mongoc_database_t *database = mongoc_client_get_database (client, "test_database");

컬렉션에 액세스

mongoc_client_get_collection() 또는 mongoc_database_get_collection() 함수를 사용하여 컬렉션 에 액세스합니다.

다음 예시 에서는 mongoc_database_get_collection() 함수를 사용하여 "test_collection" 라는 컬렉션 에 액세스합니다.

mongoc_collection_t *collection = mongoc_database_get_collection (database, "test_collection");

컬렉션 생성

mongoc_database_create_collection() 함수를 사용하여 MongoDB database 에 컬렉션 을 명시적으로 생성합니다.

다음 예에서는 "example_collection" 이라는 collection을 만듭니다.

mongoc_collection_t *new_collection = mongoc_database_create_collection (database, "example_collection", NULL, &error);

최대 크기 및 문서 유효성 검사 규칙과 같은 컬렉션 옵션을 구조 내에서 함수의 bson_t 세 번째 매개변수로 전달하여 지정할 mongoc_database_create_collection() 수 있습니다. 선택적 매개변수의 전체 목록은 MongoDB Server 매뉴얼의 create 명령 문서를 참조하세요.

컬렉션 목록 가져오기

mongoc_database_find_collections_with_opts() 함수를 호출하여 데이터베이스 의 컬렉션 목록을 쿼리 할 수 있습니다. 이 함수는 데이터베이스 의 모든 컬렉션과 관련 메타데이터 가 포함된 커서 를 반환합니다.

다음 예시 에서는 mongoc_database_find_collections_with_opts() 함수를 호출하고 커서 를 반복하여 결과를 인쇄합니다.

mongoc_cursor_t *cursor = mongoc_database_find_collections_with_opts (database, NULL);
const bson_t *doc;
while (mongoc_cursor_next (cursor, &doc))
{
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("Collection: %s\n", str);
    bson_free (str);
}

Collection: { "name" : "test_collection", "type" : "collection", ...}
Collection: { "name" : "example_collection", "type" : "collection", ... }

데이터베이스 에서 컬렉션 이름만 쿼리 하려면 다음과 같이 mongoc_database_get_collection_names_with_opts() 함수를 호출합니다.

char **strv;
unsigned i;
if ((strv = mongoc_database_get_collection_names_with_opts (database, NULL, &error)))
{
    for (i = 0; strv[i]; i++)
        printf ("%s\n", strv[i]);
    bson_strfreev (strv);
}
else
{
    fprintf (stderr, "Command failed: %s\n", error.message);
}

test_collection
example_collection

커서 반복에 대한 자세한 내용은 커서에서 데이터 액세스를 참조하세요.

컬렉션 삭제

mongoc_collection_drop() 함수를 사용하여 데이터베이스 에서 컬렉션 을 삭제 수 있습니다.

다음 예시에서는 "test_collection" 컬렉션을 삭제합니다.

mongoc_collection_t *collection = mongoc_database_get_collection (database, "test_collection");
mongoc_collection_drop (collection, NULL);

읽기 및 쓰기 작업 구성

읽기 설정( read preference)을 설정하여 드라이버가 읽기 작업을 라우팅하는 방법을 제어할 수 있습니다. 또한 읽기 고려 및 쓰기 고려를 설정하여 드라이버가 복제본 세트에 대한 읽기 및 쓰기 작업의 승인을 기다리는 방법에 대한 옵션을 제어할 수도 있습니다.

기본값 으로 데이터베이스는 mongoc_client_t 인스턴스 에서 이러한 설정을 상속하고 컬렉션은 데이터베이스 에서 이러한 설정을 상속합니다. 그러나 다음 기능 중 하나를 사용하여 데이터베이스 에서 이러한 설정을 변경할 수 있습니다.

• mongoc_database_set_read_prefs()

• mongoc_database_set_read_concern()

• mongoc_database_set_write_concern()

다음 예시 에서는 mongoc_database_set_read_prefs() 함수를 사용하여 데이터베이스 의 읽기 설정 (read preference) 을 변경하는 방법을 보여 줍니다.

mongoc_read_prefs_t *read_prefs = mongoc_read_prefs_new (MONGOC_READ_PRIMARY_PREFERRED);
mongoc_database_set_read_prefs (database, read_prefs);

다음 함수 중 하나를 사용하여 컬렉션의 읽기 및 쓰기 (write) 설정을 변경할 수 있습니다.

• mongoc_collection_set_read_prefs()

• mongoc_collection_set_read_concern()

• mongoc_collection_set_write_concern()

다음 예시 에서는 mongoc_collection_set_read_prefs() 함수를 사용하여 컬렉션 의 읽기 설정 (read preference) 을 변경하는 방법을 보여 줍니다.

mongoc_read_prefs_t *read_prefs = mongoc_read_prefs_new (MONGOC_READ_PRIMARY_PREFERRED);
mongoc_collection_set_read_prefs(collection, read_prefs);

읽기 및 쓰기 설정에 대해 자세히 알아보려면 MongoDB Server 매뉴얼에서 다음 가이드를 참조하세요.

• 읽기 설정

• readConcern

• 쓰기 고려

mongoc_read_prefs_t *read_prefs = mongoc_read_prefs_new (MONGOC_READ_SECONDARY_PREFERRED);
bson_t *tags = BCON_NEW ("DC", BCON_UTF8("ny"), "DC", BCON_UTF8("sf"));

const char *uri_string = "mongodb://localhost:27017/?localThresholdMS=35";
mongoc_client_t *client = mongoc_client_new (uri_string);

API 문서

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

• mongoc_database_create_collection()

• mongoc_database_find_collections_with_opts()

• mongoc_database_get_collection_names_with_opts()

• mongoc_client_get_database()

• mongoc_client_get_collection()

• mongoc_database_get_collection()

• mongoc_collection_drop()

• mongoc_database_set_read_prefs()

• mongoc_database_set_read_concern()

• mongoc_database_set_write_concern()

• mongoc_collection_set_read_prefs()

• mongoc_collection_set_read_concern()

• mongoc_collection_set_write_concern()

• mongoc_read_prefs_set_tags()