C++ 드라이버 시작하기

종속성 설치

이 튜토리얼을 시작하기 전에 개발 환경에 다음 종속성이 설치되어 있는지 확인하세요.

• C++17 를 지원하는 컴파일러(예:GCC, Clang 또는 Visual Studio

• CMake v3.15 이상

• pkg-config

C++ 운전자 다운로드

리포지토리 에서 최신 버전의 C++ 운전자 를 mongo-cxx-driver Github shell 다운로드 하려면 루트 디렉토리 의 에서 다음 명령을 실행 합니다.

curl -OL https://github.com/mongodb/mongo-cxx-driver/releases/download/r4.0.0/mongo-cxx-driver-r4.0.0.tar.gz
tar -xzf mongo-cxx-driver-r4.0.0.tar.gz
cd mongo-cxx-driver-r4.0.0/build

설치할 운전자 구성

운영 체제에 해당하는 탭 을 선택하고 mongo-cxx-driver-r4.0.0/build 디렉토리 에서 다음 명령을 실행 합니다.

cmake ..                                \
    -DCMAKE_BUILD_TYPE=Release          \
    -DCMAKE_CXX_STANDARD=17

'C:\<path>\cmake.exe' .. \
    -G "Visual Studio <version> <year>" -A "x64"         \
    -DCMAKE_CXX_STANDARD=17                     \
    -DCMAKE_INSTALL_PREFIX=C:\mongo-cxx-driver  \

운전자 빌드 및 설치

운영 체제에 해당하는 탭 을 선택하고 다음 명령을 실행 하여 운전자 를 설치합니다.

cmake --build .
sudo cmake --build . --target install

cmake --build . --config RelWithDebInfo
cmake --build . --target install --config RelWithDebInfo

Atlas에 무료 MongoDB 배포서버 생성

Atlas 시작하기 가이드를 완료하여 새 Atlas 계정을 설정하고 새로운 프리 계층 MongoDB 배포서버에 샘플 데이터를 로드하세요.

자격 증명 저장

데이터베이스 사용자를 생성한 후 다음 단계에서 사용할 수 있도록 해당 사용자의 사용자 이름과 비밀번호를 안전한 위치에 저장하세요.

MongoDB Atlas 연결 문자열 찾기

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

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

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

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

연결 문자열 복사

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

자리 표시자 업데이트

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

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

프로젝트 디렉토리 만들기

루트 디렉토리 의 shell 에서 다음 명령을 실행 하여 이 프로젝트 에 대해 cpp-quickstart 디렉토리 를 만듭니다.

mkdir cpp-quickstart

다음 명령을 실행하여 cpp-quickstart 디렉토리 에 quickstart.cpp 애플리케이션 파일 을 만듭니다.

cd cpp-quickstart
touch quickstart.cpp

C++ 운전자 애플리케이션 만들기

다음 코드를 복사하여 sample_mflix 데이터베이스 의 movies 컬렉션 을 쿼리하는 quickstart.cpp 파일 에 붙여넣습니다.

#include <cstdint>
#include <iostream>
#include <vector>
#include <bsoncxx/builder/basic/document.hpp>
#include <bsoncxx/json.hpp>
#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
#include <mongocxx/uri.hpp>
using bsoncxx::builder::basic::kvp;
using bsoncxx::builder::basic::make_document;
int main() {
    mongocxx::instance instance;
    mongocxx::uri uri("<connection string>");
    mongocxx::client client(uri);
    auto db = client["sample_mflix"];
    auto collection = db["movies"];
    auto result = collection.find_one(make_document(kvp("title", "The Shawshank Redemption")));
    std::cout << bsoncxx::to_json(*result) << std::endl;
}

연결 문자열 할당

<connection string> 자리 표시자를 이 가이드의 연결 문자열 만들기 단계에서 복사한 연결 문자열로 바꿉니다.

C++ 애플리케이션 실행

shell 에서 다음 명령을 실행 하여 이 애플리케이션 을 컴파일하고 실행 합니다.

c++ --std=c++17 quickstart.cpp $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out

dyld[54430]: Library not loaded: @rpath/libmongocxx._noabi.dylib

c++ --std=c++17 quickstart.cpp -Wl,-rpath,/usr/local/lib/ $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out

명령줄 출력에는 검색된 영화 문서에 대한 세부 정보가 포함됩니다.

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

오류가 발생하거나 출력이 표시되지 않는 경우 quickstart.cpp 파일에 적절한 연결 문자열을 지정했는지, 그리고 샘플 데이터를 로드했는지 확인합니다.