[NoSQL] MongoDB C++ 환경 설정하기(feat. linux mongocxx driver)

💡 본 문서는 'MongoDB C++ 환경 설정하기'에 대해 정리해놓은 글입니다.
MongoDB 서버에 접속하여 데이터를 전송하기 위한 클라이언트를 위한 환경을 설정하는 방법에 대해 정리하였으니 참고하시기 바랍니다.

1. mongocxx driver 설치 스크립트

mongocxx driver를 설치하기 위한 스크립트 파일입니다. 스크립트에 대한 자세한 설명은 하단의 '2. mongocxx driver 설치 상세'에서 정리해놓았으니 참고하시기 바랍니다.

#!/bin/bash

sudo apt-get install libmongoc-1.0-0
sudo apt-get install libbson-1.0-0
sudo apt-get install cmake libssl-dev libsasl2-dev

curl -OL https://github.com/mongodb/mongo-c-driver/releases/download/1.23.2/mongo-c-driver-1.23.2.tar.gz
tar xzf mongo-c-driver-1.23.2.tar.gz
cd mongo-c-driver-1.23.2
mkdir cmake-build
cd cmake-build
cmake ..                                   \
    -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF     \
    -DCMAKE_INSTALL_PREFIX=/opt/mongo-c-driver  \
    -DCMAKE_PREFIX_PATH=/opt/mongo-c-driver
sudo cmake --build . --target install # 빌드에 성공하면 설치까지 진행한다

cd ../../
curl -OL https://github.com/mongodb/mongo-cxx-driver/releases/download/r3.7.0/mongo-cxx-driver-r3.7.0.tar.gz
tar -xzf mongo-cxx-driver-r3.7.0.tar.gz
cd mongo-cxx-driver-r3.7.0/build
cmake ..                                            \
    -DCMAKE_BUILD_TYPE=Release                      \
    -DCMAKE_PREFIX_PATH=/opt/mongo-c-driver         \
    -DCMAKE_INSTALL_PREFIX=/opt/mongo-cxx-driver
sudo cmake --build . --target install

2. mongocxx driver 설치 상세

C++ API를 활용하여 mongoDB에 접속하기 위해서는 mongocxx driver를 설치하여야 합니다. 자세한 설치과정은 앞으로 언급하겠지만, 하단에 mongocxx driver를 설치하고 세팅하는 스크립트를 첨부하였으니 참고하시기 바랍니다.

mongocxx driver를 설치하기 앞서 mongocxx driver에서는 'libmongoc', 'libbson' 라이브러리가 필요하기에 다음의 링크를 통해 mongoDB C Driver를 설치한 후에 mongocxx driver를 설치하셔야 합니다. 이때 cmake 명령어에 있어 설치 경로를 /opt/mongo-c-driver로 설정해주시기 바랍니다.

% cmake ..                                   	\
    -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF     \
    -DCMAKE_INSTALL_PREFIX=/opt/mongo-c-driver  \
    -DCMAKE_PREFIX_PATH=/opt/mongo-c-driver

• [mongodb] Installing the MongoDB C Driver (libmongoc) and BSON library (libbson): http://mongoc.org/libmongoc/current/installing.html

 'libmongoc', 'libbson' 라이브러리를 설치하였다면 mongocxx driver를 설치하시면 됩니다. 이때 cmake 명령어에 있어 설치 경로를 /opt/mongo-cxx-driver로 설정해주시기 바랍니다.

cmake ..                                            \
    -DCMAKE_BUILD_TYPE=Release                      \
    -DCMAKE_PREFIX_PATH=/opt/mongo-c-driver         \
    -DCMAKE_INSTALL_PREFIX=/opt/mongo-cxx-driver​

• [mongodb] mongocxx driver install guide(linux): https://mongocxx.org/mongocxx-v3/installation/linux/ 

이제 mongoDB C++을 사용하기 위한 환경 세팅은 마쳤습니다. 설치한 것을 바탕으로 라이브러리가 정상동작하는지 테스트를 해보도록 하겠습니다.

3. mongoDB C++ API 테스트

3.1 test.cpp

테스트를 위한 .cpp 파일은 다음과 같습니다. 

#include <cstdint>
#include <iostream>
#include <vector>
#include <bsoncxx/json.hpp>
#include <mongocxx/client.hpp>
#include <mongocxx/stdx.hpp>
#include <mongocxx/uri.hpp>
#include <mongocxx/instance.hpp>
#include <bsoncxx/builder/stream/helpers.hpp>
#include <bsoncxx/builder/stream/document.hpp>
#include <bsoncxx/builder/stream/array.hpp>

using bsoncxx::builder::stream::close_array;
using bsoncxx::builder::stream::close_document;
using bsoncxx::builder::stream::document;
using bsoncxx::builder::stream::finalize;
using bsoncxx::builder::stream::open_array;
using bsoncxx::builder::stream::open_document;

int main()
{
    mongocxx::instance instance{}; // This should be done only once.
    mongocxx::uri uri("mongodb://localhost:27017");
    mongocxx::client client(uri);

    mongocxx::database db = client["bsm"];
    mongocxx::collection coll = db["test"];

    auto builder = bsoncxx::builder::stream::document{};
    bsoncxx::document::value doc_value = builder
            << "name"
            << "MongoDB"
            << "type"
            << "database"
            << "count" << 1
            << "versions" << bsoncxx::builder::stream::open_array
            << "v3.2"
            << "v3.0"
            << "v2.6"
            << close_array
            << "info" << bsoncxx::builder::stream::open_document
            << "x" << 203
            << "y" << 102
            << bsoncxx::builder::stream::close_document
            << bsoncxx::builder::stream::finalize;

    bsoncxx::document::view view = doc_value.view();
}

3.2 test.cpp 실행

3.2.1 pkg-config 활용

% c++ --std=c++11 <input>.cpp $(pkg-config --cflags --libs libmongocxx)

만약에 안된다면 PKG_CONFIG_PATH 환경변수에 libmongocxx.pc의 위치를 포함시킵니다.

% nano ~/.bashrc
...
export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/mongo-cxx-driver/lib/pkgconfig
% source ~/.bashrc

3.2.2 일일히 라이브러리 경로 지정

pkg-config가 안된다면? include, library를 일일히 지정하여 실행할 수 있습니다.

% c++ --std=c++11 test.cpp -I/opt/mongo-cxx-driver/include/mongocxx/v_noabi -I/opt/mongo-cxx-driver/include/bsoncxx/v_noabi -I/opt/mongo-c-driver/include/libmongoc-1.0 -I/opt/mongo-c-driver/include/libbson-1.0 -L/opt/mongo-cxx-driver/lib -lmongocxx -lbsoncxx

3.2.3 CMake 빌드

mongodb를 빌드한 후 나오는 shared 라이브러리를 가지고 CMake 파일을 만들어 빌드할 수 있습니다(하단 링크 참조). 이때 '# NOTE:'에 적힌 바와 같이 'CMAKE_PREFIX_PATH'를 이전에 설치했을 때 적었던 경로로 설정해주어야 합니다.

set(CMAKE_PREFIX_PATH /opt/mongo-cxx-driver)

• [mongodb] CMakeLists(shared library): https://github.com/mongodb/mongo-cxx-driver/blob/master/examples/projects/mongocxx/cmake/shared/CMakeLists.txt

 

참고

• [mongodb] MongoDB C++ Driver: https://www.mongodb.com/docs/drivers/cxx/#mongodb-compatibility
• [github] MongoDB C++ Driver: https://github.com/mongodb/mongo-cxx-driver
• [mongodb] Installing the mongocxx driver: https://mongocxx.org/mongocxx-v3/installation/
• [mongodb] mongocxx driver install guide(linux): https://mongocxx.org/mongocxx-v3/installation/linux/
• [mongodb] Installing the MongoDB C Driver (libmongoc) and BSON library (libbson): http://mongoc.org/libmongoc/current/installing.html
• [mongodb] mongocxx driver Advanced Configuration and Installation Options: https://mongocxx.org/mongocxx-v3/installation/advanced/
• [mongodb] Tutorial for mongocxx: https://mongocxx.org/mongocxx-v3/tutorial/
• [mongodb] CMakeLists(shared library): https://github.com/mongodb/mongo-cxx-driver/blob/master/examples/projects/mongocxx/cmake/shared/CMakeLists.txt