C 드라이버 시작하기

개요

MongoDB C 드라이버 는 MongoDB 에 연결하고 배포서버 에 저장된 데이터와 상호 작용 사용할 수 있는 C 라이브러리입니다. 이 가이드 C 운전자 사용하여 MongoDB Atlas 에서 호스팅되는 MongoDB cluster 에 연결하고 클러스터 의 데이터를 쿼리 애플리케이션 만드는 방법을 보여줍니다.

이 가이드 에 따라 샘플 C 애플리케이션 MongoDB Atlas 배포서버 서버에 연결합니다. 다른 운전자 또는 프로그래밍 언어 사용하여 MongoDB 에 연결하려는 경우 공식 드라이버 목록을 참조하세요.

다운로드 및 설치

sudo dnf info mongo-c-driver-devel

apt-cache policy libmongoc-dev

yum install epel-release

yum install mongo-c-driver-devel

yum install mongo-c-driver

dnf install mongo-c-driver-devel

apt install libmongoc-dev

apt install libmongoc-1.0-0

{
   // ...
   "dependencies": [
     // ...
     "mongo-c-driver"
   ]
}

vcpkg install mongo-c-driver

find_package(mongoc-1.0 CONFIG REQUIRED)
target_link_libraries(my-application
    PRIVATE $<IF:$<TARGET_EXISTS:mongo::mongoc_shared>,mongo::mongoc_shared,mongo::mongoc_static>)

cmake -S . -B _build -D
CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake

brew install mongo-c-driver

MongoDB Deployment 생성

MongoDB Atlas에 프리 티어 MongoDB 배포를 생성하여 데이터를 저장하고 관리할 수 있습니다. MongoDB Atlas는 클라우드에서 MongoDB database를 호스팅하고 관리합니다.

이 단계를 완료하면 Atlas에 새로운 프리 티어 MongoDB 배포서버, 데이터베이스 사용자 자격 증명 및 샘플 데이터가 데이터베이스에 로드됩니다.

연결 문자열 만들기

연결 문자열이라고도 하는 연결 URI을 제공하여 MongoDB 배포서버에 연결할 수 있으며, 이 연결 문자열은 드라이버에 MongoDB 배포서버로 연결하는 방법과 연결된 동안 동작하는 방법을 지시합니다.

연결 문자열에는 배포서버의 호스트 이름 또는 IP 주소와 포트, 인증 메커니즘, 해당되는 경우 사용자 자격 증명, 연결 옵션 등이 포함됩니다.

Atlas 에서 호스팅되지 않는 인스턴스 또는 배포서버 에 연결하려면 연결 대상 선택 가이드 를 참조하세요.

1

MongoDB Atlas 연결 문자열 찾기

이전 단계에서 만든 배포서버에 대한 연결 문자열 조회 하려면 Atlas 계정에 로그인 Database 섹션으로 이동한 다음 새 배포서버에 대한 Connect 버튼을 클릭합니다.

Connect your application 섹션으로 이동하여 Driver 선택 메뉴에서 "C"를 선택하고 Version 선택 메뉴에서 설치한 버전과 가장 일치하는 버전을 선택합니다.

Password (SCRAM) 인증 메커니즘을 선택합니다.

연결 string 만 보려면 Include full driver code example 옵션을 선택 취소합니다.

2

연결 문자열 복사

다음 스크린샷과 같이 연결 string 오른쪽에 있는 버튼을 클릭하여 클립보드에 복사합니다.

3

자리 표시자 업데이트

이 연결 문자열을 원하는 텍스트 편집기의 파일에 붙여넣고 <db_username> 및 <db_password> 자리 표시자를 데이터베이스 사용자의 사용자 이름 및 비밀번호로 바꿉니다.

다음 단계에서 사용할 수 있도록 이 파일을 안전한 위치에 저장합니다.

이 단계를 완료하면 클러스터 에 해당하는 연결 string Atlas 이 생성됩니다.

샘플 쿼리 실행

MongoDB deployment 에 연결하고 sample_mflix 데이터베이스 의 movies 컬렉션 에서 데이터를 검색하는 애플리케이션 만들 수 있습니다.

sample_mflix 데이터베이스에 대해 자세히 학습하려면 Atlas 설명서에서 샘플 Mflix 데이터 세트 를 참조하세요.

mkdir c-quickstart

cd c-quickstart
touch quickstart.c

cd c-quickstart
type nul > quickstart.c

#include <bson/bson.h>
#include <mongoc/mongoc.h>
#include <stdio.h>
int
main (void)
{
    const bson_t *doc;
    mongoc_init ();
    mongoc_client_t *client = mongoc_client_new ("<connection string>");
    mongoc_collection_t *collection = mongoc_client_get_collection (client, "sample_mflix", "movies");
    // Specify the query filter
    bson_t *query = BCON_NEW ("title", "The Shawshank Redemption");
    mongoc_cursor_t *results = mongoc_collection_find_with_opts (collection, query, NULL, NULL);
    // Print the results
    while (mongoc_cursor_next (results, &doc))
    {
        char* str = bson_as_canonical_extended_json (doc, NULL);
        printf ("%s\n", str);
        bson_free (str);
    }
    bson_destroy (query);
    mongoc_cursor_destroy (results);
    mongoc_collection_destroy (collection);
    mongoc_client_destroy (client);
    mongoc_cleanup ();
    return EXIT_SUCCESS;
}

gcc -o quickstartc quickstart.c $(pkg-config --libs --cflags libmongoc-1.0)
./quickstartc

{ "_id" : { "$oid" : "..." },
"plot" : "Two imprisoned men bond over a number of years, finding solace
and eventual redemption through acts of common decency.",
...
"title" : "The Shawshank Redemption",
...

이 단계를 완료한 후에는 드라이버를 사용하여 MongoDB deployment에 연결하고, 샘플 데이터에 대해 쿼리를 실행하고, 결과를 출력하는 등 정상적으로 작동하는 애플리케이션을 갖게 될 것입니다.

다음 단계

빠른 시작 튜토리얼을 완료하신 것을 축하드립니다!

이 튜토리얼에서는 MongoDB Atlas 에서 호스팅되는 MongoDB deployment 에 연결하고 쿼리 와 일치하는 문서 검색하는 C 애플리케이션 을 만들었습니다.

다음 리소스에서 C 운전자 에 대해 자세히 보기 .

• 데이터 읽기 섹션에서 읽기 작업을 수행하는 방법을 알아보세요.

• MongoDB 에 데이터 쓰기 섹션에서 쓰기 (write) 작업을 수행하는 방법을 알아보세요.