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

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

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

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

• CMax v3.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接続文字列を見つけます。

Clusters前のステップで作成した配置の接続文字列を取得するには、AtlasDatabase アカウントにログ、Connect セクションの下の ページに移動します。新しい配置で [] ボタンをクリックします。

データベースユーザーをまだ設定していない場合、 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が指定されており、サンプル データがロードされていることを確認してください。