C++ ドライバーを使い始める

すべての依存関係をインストールします。

このチュートリアルを開始する前に、開発環境に次の依存関係がインストールされていることを確認してください。

• C++17 をサポートするコンパイラー（GCC、Clang、Visual Studio など）

• CMax 3v.15 以降

• pkg-config

C++ドライバーをダウンロードします。

リポジトリから最新バージョンのC++ ドライバーをダウンロードするには、ルートディレクトリからmongo-cxx-driverGithub shellで次のコマンドを実行します。

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

インストール用のドライバーを構成します。

オペレーティング システムに対応するタブを選択し、 mongo-cxx-driver-r3.11.1/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 Release
cmake --build . --config Debug
cmake --install . --config Release
cmake --install . --config Debug

Atlas に無料のMongoDB配置を作成します。

MongoDB の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプルデータを新しい無料階層のMongoDB配置にロードします。

認証情報を保存します。

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

MongoDB Atlas接続文字列を見つけます。

To retrieve your connection string for the deployment that you created in the previous step, log into your Atlas account and navigate to the Clusters page under the Database section. Click the Connect button for your new deployment.

データベースユーザーをまだ設定していない場合、 MongoDB は新しいユーザーを作成して設定するように要求します。

Connect to your application セクションの下の Drivers ボタンをクリックし、Driver 選択メニューから「C++」を選択し、Version 選択メニューからインストールしたバージョンに最適化されたバージョンを選択します。

接続文字列のみを表示するには、View full code sample オプションが選択されていないことを確認します。

接続文字列をコピーします。

次のスクリーンショットに示すように、接続文字列の右側にある ボタンをクリックして、接続stringをクリップボードにコピーします。

パスワード プレースホルダーを更新します。

この接続文字列をテキストエディタのファイルに貼り付け、<db_password> プレースホルダーをデータベースユーザーのパスワードに置き換えます。接続文字列には、すでにデータベースユーザーのユーザー名が入力されています。

このファイルを安全な場所に保存して、次の手順で使用します。

プロジェクトディレクトリを作成します。

ルートディレクトリから、 shellで次のコマンドを実行して、このプロジェクト用に cpp-quickstart というディレクトリを作成します。

mkdir cpp-quickstart

次のコマンドを実行して、 cpp-quickstartディレクトリにquickstart.cppアプリケーションファイルを作成します。

cd cpp-quickstart
touch quickstart.cpp

C++ドライバーアプリケーションを作成します。

次のコードをコピーして、 quickstart.cppファイルに貼り付けます。このコードは、 sample_mflixデータベース内のmoviesコレクションをクエリします。

#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 ファイルに適切な接続stringが指定されており、サンプル データがロードされていることを確認してください。