MongoDB クライアントの作成

項目一覧

Overview

接続URI
を作成します mongocxx::client
API ドキュメント

Overview

MongoDB 配置に接続するには、次の 2 つのものが必要です。

接続 URI （ 接続string C++MongoDBとも呼ばれます）。これは、接続する配置をドライバーに指示します。
mongocx::クライアントオブジェクトMongoDB配置への接続を作成し、それに対して操作を実行できるようにします。

これらのコンポーネントのいずれかを使用して、 MongoDBに接続中にC++ドライバーが動作する方法をカスタマイズすることもできます。

このガイドでは、接続string を作成し、{0mongocxx::client オブジェクトを使用してMongoDB に接続する方法について説明します。

注意

mongocx::インスタンス

このページのコード例では、アプリケーション内の他の場所にmongocxx::instanceオブジェクトがすでに作成されていることを前提としています。

インスタンスの作成の詳細については、「ドライバーインスタンスの作成」を参照してください。

接続URI

標準の接続stringには次のコンポーネントが含まれます。

コンポーネント	説明
`mongodb://`	必須: これを標準接続形式の文字列として識別するプレフィックス。
`db_username:db_password`	任意。認証資格情報。これらを含めると、クライアントは`authSource`で指定されたデータベースに対してユーザーを認証します。 `authSource`接続オプションの詳細については、「認証メカニズム」を参照してください。
`host[:port]`	必須。 MongoDB が実行されているホストとオプションのポート番号。ポート番号を指定しない場合、ドライバーはデフォルトのポート`27017`を使用します。
`/defaultauthdb`	任意。接続stringに `db_username:db_password@` 認証情報が含まれている一方で、`authSource` オプションが含まれていない場合に使用する認証データベース。このコンポーネントを含めない場合、クライアントは`admin`データベースに対してユーザーを認証します。
`?<options>`	任意。接続固有のオプションを `<name>=<value>` ペアとして指定するクエリstringです。これらのオプションの詳細については、「接続オプションの指定」を参照してください。

接続の作成の詳細については、string MongoDB Serverドキュメントの「接続文字列」を参照してください。

を作成します `mongocxx::client`

MongoDBへの接続を作成するには、接続 URI を string としてコンストラクターに渡して、 mongocxx::uriクラスのインスタンスを構築します。次に、 mongocxx::uriクラスのインスタンスをmongocxx::clientコンストラクターに渡します。

次の例では、ドライバーはサンプル接続 URI を使用して、 localhostのポート27017上のMongoDBデプロイに接続します。

#include <mongocxx/instance.hpp>
#include <mongocxx/uri.hpp>
#include <mongocxx/client.hpp>
int main()
{
    mongocxx::instance instance;
    mongocxx::uri uri("mongodb://localhost:27017");
    mongocxx::client client(uri);
}

Tip

クライアントの再利用

各mongocxx::clientオブジェクトはデータベースへの接続のプールを表すため、ほとんどのアプリケーションでは、複数のリクエスト間でもmongocxx::clientのインスタンスが 1 つだけ必要になります。

API ドキュメント

C++ドライバーでmongocxx::clientオブジェクトを作成する方法の詳細については、次のAPIドキュメントを参照してください。

mongocx::クライアント

戻る

ドライバーインスタンスの作成

接続ターゲットの選択