すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB for MongoDB:インスタンスへの接続

最終更新日:Nov 09, 2025

ApsaraDB for MongoDB インスタンスを作成した後、クライアントツールを使用してインスタンスに接続する必要があります。

前提条件

  • クイックスタートの説明に従って、ホワイトリストを設定していること。

  • インスタンスが [実行中] 状態であること。

手順

DMS

  1. ApsaraDB for MongoDB レプリカセットインスタンス」ページまたは「ApsaraDB for MongoDB シャードクラスターインスタンス」ページに移動します。 ページの上部で、リソースグループとリージョンを選択します。 次に、ターゲットインスタンスの ID をクリックします。

  2. ページの右上隅にある [データベースにログオン] をクリックします。

    • レプリカセットインスタンスの場合: ドロップダウンリストから [プライマリ] を選択します。 Data Management (DMS) コンソールにリダイレクトされます。

      説明

      セカンダリノードは読み取り操作のみをサポートします。 データを書き込むには、プライマリノードを選択します。

    • シャードクラスターインスタンスの場合: ドロップダウンリストから任意のノードを選択します。 DMS コンソールにリダイレクトされます。

    • スタンドアロンインスタンスの場合: 選択は不要です。 DMS コンソールにリダイレクトされます。

  3. DMS コンソールの [インスタンスにログオン] ダイアログボックスで、[データベースアカウント][データベースパスワード] を入力します。 他の設定はデフォルトのままにします。

    説明

    パスワードを忘れた場合、またはインスタンスの作成時にパスワードを設定しなかった場合は、ApsaraDB for MongoDB コンソールに移動してパスワードをリセットします。

  4. [接続のテスト] をクリックします。 成功ダイアログボックスで、[OK] をクリックします。

  5. [ログオン] をクリックします。

説明

MongoDB Shell

ローカルデバイスまたは ECS インスタンスに MongoDB Shell をインストールする

MongoDB は、MongoDB Shell (mongosh) と mongo shell の 2 つのコマンドラインインターフェイス (CLI) ツールを提供します。 mongo shell はレガシークライアントツールで、MongoDB Shell はアップグレードされたツールです。 この Topic では、MongoDB Shell を例として使用します。

  1. クライアントで、MongoDB Shell をダウンロードします。

  2. mongosh をインストールします。

エンドポイントの取得

  1. ApsaraDB for MongoDB レプリカセットインスタンス」ページまたは「ApsaraDB for MongoDB シャードクラスターインスタンス」ページに移動します。 ページの上部で、リソースグループとリージョンを選択します。 次に、ターゲットインスタンスの ID をクリックします。

  2. 左側のナビゲーションウィンドウで、データベース接続 をクリックします。

  3. [データベース接続] ページで、必要なエンドポイントを取得します。

    この Topic では、[プライベート接続 - VPC] セクションの [高可用性接続文字列 URI] を例として使用します。 インターネット経由でインスタンスに接続するには、まずパブリックエンドポイントをリクエストする必要があります。

    mongodb://root:****@dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717,dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-8970****

    root:**** をデータベースアカウントとパスワードに置き換えます。 パスワードを忘れた場合、またはインスタンスの作成時にパスワードを設定しなかった場合は、ApsaraDB for MongoDB コンソールに移動してパスワードをリセットします。

データベースへの接続

クライアントで、次のコマンドを実行して MongoDB インスタンスに接続します。

説明

mongo shell を使用する場合は、コマンドの mongoshmongo に置き換えます。

mongosh "<High-availability connection string URI>"

次の例は、インスタンスへの接続方法を示しています。 データベースアカウントは root、パスワードは PassWord123!、認証データベースは admin です。

mongosh "mongodb://root:PassWord123%21@dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717,dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-8970****"

接続文字列のパスワードに含まれる特殊文字はエスケープする必要があります。 たとえば、この例のパスワードの感嘆符 (!) は %21 としてエスケープする必要があります。 詳細については、「接続文字列のユーザー名またはパスワードの特殊文字が原因で発生する接続障害を解決する方法」をご参照ください。

プログラムコード

次のステップ

データの書き込み

参考

本番環境では、root アカウントを使用してインスタンスに接続しないでください。 代わりに、他のデータベースアカウントを作成し、必要な権限を付与します。 必要な権限を持たないアカウントを使用してインスタンスに接続すると、データベース操作を実行できません。 Exception authenticating... のようなエラーメッセージが返されます。