AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

クライアント ライブラリ経由でクラスターに接続する

クラスターの Connect ダイアログ ボックスには、MongoDBクライアントライブラリを使用するアプリケーションでクラスターに接続するための詳細が表示されます。


➤ [言語の選択] ドロップダウン メニューを使用して、このページの例の言語を設定します。


ドライバーのバージョンは、MongoDB サーバーのバージョンと互換性がある必要があります。最新のデータベース機能を使用し、将来のバージョン アップグレードに備えるために、MongoDB サーバーのバージョンと互換性のある最新のドライバーを選択することをお勧めします。

ご使用のMongoDBサーバーのバージョンの完全な機能セットを含むドライバー バージョンのリストは、 ドライバーの クライアント ライブラリの互換性テーブル を確認してください。

重要

正式にサポートされているドライバー

Use officially supported MongoDB drivers at current versions for the best reliability and support experience. The Atlas SLA covers officially supported drivers only.

Atlas は、Community ドライバーとサポート終了ドライバーバージョンに対して、ベストエフォートの診断のみのサポートを提供します。Atlas は、Community ドライバーのテスト、パッチ、認証は行いません。サポートは、接続の問題がプラットフォームとドライバーのどちらに起因するかを判定するのに役立ちますが、ドライバーコードのデバッグは行いません。

さらに学ぶには、Atlas の Community ドライバーとサポートされていないドライバーのサポートポリシーはどのようになっていますか。を参照してください。

ドライバーと最適化された接続文字列を使用してシャーディングされたクラスターに接続できます。

Atlas クラスターに接続するには、クライアントが TLS をサポートしている必要があります。

Clients must support the SNI TLS extension to connect to an Atlas Free cluster (formerly known as M0) or Flex cluster.

クラスターにアクセスするには、Atlas プロジェクトの IP アクセス リストにある IP アドレスから接続する必要があります。IP アクセス リストに IP アドレスを追加する必要がある場合は、Connect ダイアログ ボックスで追加できます。[ネットワーク アクセス] タブから IP アドレスを追加することもできます。

To access a cluster, you must have a database user with access to the desired databases on your Atlas cluster. Database users are separate from Atlas users. Database users have access to MongoDB databases, while Atlas users have access to the Atlas application itself.

Connect ダイアログ ボックスで、Atlas クラスターにアクセスするためのデータベースユーザーを作成できます。クラスター ビューからデータベースユーザーを追加することもできます。Atlas は、最初のクラスターを作成すると、データベースユーザーを作成します。

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. サイドバーで、 Database見出しの下のClustersをクリックします。

[ Clusters (クラスター) ] ページが表示されます。

2

接続するクラスターの Connect をクリックします。

3

Choose Connection Type (使用可能なボタンのセットから選択)。

注意

機能が有効な場合のオプション表示

Atlas は、ピアリングのプライベート IP、プライベートエンドポイント、またはその両方を有効にすると、接続タイプのオプションを表示します。どちらの機能も有効にしていない場合、ボタンは表示されず、接続タイプのデフォルトは標準になります。

許可されたパブリック IP アドレスにはこの接続タイプを使用します。

4

Add a Connection IP Address

重要

Atlas が Setup connection security ステップで、クラスターに IP アクセス リスト エントリがすでに設定されていることを示している場合は、このステップをスキップします。IP アクセス リストを管理するには、「アクセス リストへのエントリの追加」を参照してください。

Atlas はプロジェクトの IP アクセス リストのエントリからクラスターへの標準クライアント接続を許可します。プロジェクトの IP アクセス リストは、API アクセス リスト とは異なります。APIアクセスリストは、特定の IP アドレスまたは CIDR アドレスへの API アクセスを制限します。

IP アクセス リストが空の場合、Atlas はプロジェクトの IP アクセス リストに IP アドレスを追加するように求めます。次のいずれかを実行できます。

  • 現在の IP アドレスからのアクセスを許可するには、 [Add Your Current IP Address] をクリックします。

  • 単一の IP アドレスまたは CIDR 表記のアドレス範囲を追加するには、[Add an IP Address] をクリックします。

新しく追加された IP アドレスまたは CIDR 範囲の説明を任意で入力します。Add IP Addressをクリックして、アドレスを IP アクセス リストに追加します。

5

重要

Atlas がSetup connection security の手順でプロジェクトに少なくとも 1 人のデータベースユーザーが設定されていることを示している場合は、この手順をスキップします。既存のデータベースユーザーを管理するには、「データベースユーザーの構成」を参照してください。

クラスターにアクセスするには、プロジェクト内の目的のデータベースまたはクラスター上のデータベースにアクセスできる MongoDB ユーザーが必要です。プロジェクトに MongoDB ユーザーがいない場合、Atlas は Atlas 管理者ロールを持つ新しいユーザーを作成するように要求します。

  1. 新しいユーザーの Username を入力します。

  2. この新しいユーザーの Password を入力するか、Autogenerate Secure Password をクリックします。

  3. Create Database User をクリックしてユーザーを保存します。

次のステップでは、このユーザーを使用してクラスターに接続します。

IP アクセス リストに IP アドレスを追加し、データベースユーザーを追加したら、Choose Your Connection Method をクリックします。

6

Choose a connection method の手順で、Drivers を選択します。

7

ドロップダウン メニューからドライバーとバージョンを選択します。接続文字列を含むコード サンプルが表示されます。<password> を、データベースユーザーの作成時に指定したパスワードに置き換えます。

Use this connection string in your application では、接続文字列はデフォルトで SRV 形式 (mongodb+srv://) を使用します。標準(SRV 以外)の接続文字列(mongodb://)を表示するには、SRV Connection String トグルをオフにします。

注意

パスワード、データベース、または接続文字列に予約済みの URI 文字が含まれている場合は、それらの文字をエスケープする必要があります。たとえば、パスワードが @bc123 の場合、接続文字列でパスワードを指定するときは、%40bc123 などに指定して、@ の文字をエスケープする必要があります。詳細については、「接続文字列パスワードの特殊文字」を参照してください。

詳細については、「ドライバーの互換性」を参照してください。

In the following example, you authenticate and connect to an Atlas cluster by using a URI connection string. Replace the placeholders in the example with your credentials and deployment details.

注意

Atlas M0 無料クラスターまたはフレックス クラスターに接続するには、MongoDB 7.0 以降をサポートする C ドライバー バージョンを使用する必要があります。C ドライバーと MongoDB の互換性に関する完全なドキュメントについては、「MongoDB 互換性マトリックス」を参照してください。最新バージョンのドライバーにアップグレードすることをお勧めします。

client = mongoc_client_new ("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority");
db = mongoc_client_get_database (client, "<databaseName>");
MongoDB バージョン
推奨ドライバーのバージョン

すべて

See the MongoDB compatibility matrix for the latest recommended driver versions.

MongoDB 7.0以降

バージョン 1.11 以降

注意

以下の構成オプションは、C ドライバーをシングルスレッド モードで実行する場合にのみ適用されます。

MongoDB ドライバーは、クラスターの選択またはフェイルオーバー イベントの後に自動的にサーバーの選択を試みます。デフォルトでは、C ドライバーは、サーバーを選択する最初の試行が失敗するとすぐにエラーを発生させます。以下の設定により、Atlas クラスタへのアプリケーションの接続性を向上させることができますが、サーバ選択ループに多くの時間を費やすことになります。

  • Set serverSelectionTryOnce to false to direct the C driver to perform server selection up to the time limit defined by serverSelectionTimeoutMS.

  • Lower the serverSelectionTimeoutMS to 15000 from the default of 30000. MongoDB elections typically take 10 seconds, but can be as fast as 5 seconds on Atlas. Setting this value to 15 seconds (15000 milliseconds) covers the upper bound of election plus additional time for latency.

クラスターへの接続に問題がある場合は、「接続の問題のトラブルシューティング」を参照してください。