すべてのプロダクト
Search

このプロダクト

    ApsaraDB for MongoDB:シャードクラスタインスタンスへの接続

    ドキュメントセンター

    ApsaraDB for MongoDB:シャードクラスタインスタンスへの接続

    最終更新日:Dec 11, 2024

    ApsaraDB for MongoDBは、シャードクラスターインスタンス内の各mongosコンポーネント、各シャードコンポーネント、およびConfigServerコンポーネントの接続文字列を提供します。 ApsaraDB for MongoDBは、インスタンス内のmongosおよびシャードノードの接続文字列URI (Uniform Resource Identifier) も提供します。 シャードクラスタインスタンスのURIは、アプリケーションとインスタンス間の高可用性 (HA) 接続を確立するために使用されます。 このトピックでは、シャードクラスタインスタンスの接続文字列とURIを表示する方法、およびインスタンスの特定のデータベースにログオンする方法について説明します。

    インスタンスの接続文字列とURIの表示

    1. シャードクラスターインスタンスページに移動します。 上部のナビゲーションバーで、インスタンスが存在するリージョンを選択します。 次に、インスタンスを見つけて、インスタンスのIDをクリックします。

    2. インスタンスの詳細ページの左側のナビゲーションウィンドウで、データベース接続をクリックします。 表示されるページで、インスタンス内のノードの接続情報を表示します。

    接続文字列とURI

    エンドポイントのネットワークタイプ

    ネットワークタイプ

    注

    プライベートネットワーク

    • VPC: 仮想プライベートクラウド (VPC) は、クラシックネットワークよりも高いセキュリティとパフォーマンスを提供する分離されたネットワークです。 デフォルトでは、ApsaraDB for MongoDBはインスタンスのVPCエンドポイントを提供します。

    • クラシックネットワーク: クラシックネットワークは、クラウドサービスが分離されていないネットワーク環境です。 クラシックネットワークは、セキュリティグループまたはホワイトリストを使用して、クラウドサービスへの不正アクセスをブロックします。 新しいインスタンスはクラシックネットワークタイプをサポートしていません。 詳細については、「 [通知] 新しいApsaraDB For MongoDBインスタンスのクラシックネットワークが利用できない」をご参照ください。

    インターネット

    インターネット経由でApsaraDB for MongoDBインスタンスに接続すると、インスタンスがセキュリティリスクにさらされる可能性があります。 したがって、ApsaraDB for MongoDBインスタンスには、デフォルトでパブリックエンドポイントは提供されません。 インターネット経由でApsaraDB for MongoDBインスタンスに接続する場合は、パブリックエンドポイントを申請する必要があります。 詳細については、「 (オプション) ApsaraDB For MongoDBインスタンスのパブリックエンドポイントの申請」をご参照ください。

    エンドポイントの種類

    Endpointタイプ

    説明

    Mongosエンドポイント

    インスタンス内のmongosコンポーネントのプライマリノードのエンドポイント。 エンドポイントを使用すると、コンポーネントのプライマリノードに接続できます。

    説明

    ルーチンテストを実行するときは、mongosノードに接続するだけで済みます。

    Shardエンドポイント

    インスタンスのシャードコンポーネント内のシャードノードのエンドポイント。 エンドポイントを使用すると、コンポーネント内のプライマリノード、セカンダリノード、または読み取り専用ノードに接続できます。

    説明

    • デフォルトでは、インスタンス内のmongosノードの接続文字列のみがApsaraDB for MongoDBコンソールに表示されます。 インスタンス内のシャードまたはConfigServerノードの接続文字列を表示するには、ノードのエンドポイントを申請します。 詳細については、「シャードクラスターインスタンスのシャードまたはConfigServerノードのエンドポイントの申請」をご参照ください。

    • シャードコンポーネント内の読み取り専用ノードの接続文字列は、コンポーネント内に読み取り専用ノードが存在する場合にのみ表示できます。

    ConfigServerエンドポイント

    インスタンス内のConfigServerコンポーネント内のConfigServerノードのエンドポイント。 エンドポイントを使用すると、コンポーネント内のプライマリノードまたはセカンダリノードに接続できます。

    説明

    • デフォルトでは、インスタンス内のmongosノードの接続文字列のみがApsaraDB for MongoDBコンソールに表示されます。 インスタンス内のシャードまたはConfigServerノードの接続文字列を表示するには、ノードのエンドポイントを申請します。 詳細については、「シャードクラスターインスタンスのシャードまたはConfigServerノードのエンドポイントの申請」をご参照ください。

    • ローカルディスクを使用するシャードクラスタインスタンスのConfigServerノードのエンドポイントにのみ適用できます。

    Connection string URI

    ApsaraDB for MongoDBは、インスタンス内のmongosまたはシャードノードの接続文字列URIを提供します。

    アプリケーションが本番環境にデプロイされている場合は、接続文字列URIを使用してインスタンスに接続することを推奨します。 これにより、クライアントはリクエストを自動的にmongosノードに分散して、インスタンス内の負荷を分散できます。 mongosノードに障害が発生した場合、クライアントは他の正常なmongosノードにリクエストを自動的にリダイレクトできます。

    説明

    デフォルトでは、インスタンス内のmongosノードの接続文字列URIのみがApsaraDB for MongoDBコンソールに表示されます。 インスタンス内のシャードノードの接続文字列URIを表示するには、シャードノードのエンドポイントを申請します。 詳細については、「シャードクラスターインスタンスのシャードまたはConfigServerノードのエンドポイントの申請」をご参照ください。

    SRV HAエンドポイント

    SRV HAエンドポイントは、シャードクラスタインスタンスのメンテナンスと管理を簡素化できます。 mongosノードを追加または削除するときに、エンドポイントを変更する必要はありません。 クライアントは、サービスを中断することなくインスタンスと対話でき、アプリケーションの設計とメンテナンスが簡単になります。

    アプリケーションが本番環境にデプロイされている場合は、接続文字列URIを使用してインスタンスに接続することを推奨します。 これにより、クライアントはリクエストを自動的にmongosノードに分散して、インスタンス内の負荷を分散できます。 mongosノードに障害が発生した場合、クライアントは他の正常なmongosノードにリクエストを自動的にリダイレクトできます。

    重要

    • デフォルトでは、SRV HAエンドポイントはApsaraDB for MongoDBコンソールに表示されません。 SRV HAエンドポイントを使用するには、[データベース接続] ページで [プライベートSRVアドレスの申請] または [パブリックSRVアドレスの申請] をクリックします。

    • パブリックSRVエンドポイントを申請する前に、mongosノードのパブリックエンドポイントを有効化してください。 パブリックSRVエンドポイントを使用してインスタンスに接続すると、クライアントは、パブリックエンドポイントがアクティブ化されているmongosノードにリクエストを自動的にリダイレクトします。

    • SRV HAエンドポイントは、クラウドディスクを使用するインスタンスでのみ使用できます。

    • 仮想プライベートクラウド (VPC) にデプロイされたシャードクラスターインスタンスのプライベートSRVエンドポイントは、インスタンス内の最大20個のmongosノードに関連付けることができます。 エンドポイントが20を超えるmongosノードに関連付けられている場合、VPCのドメインネームシステム (DNS) 解決プロトコルによって課される制限により、過剰なノードはリクエストをオフロードできません。 インスタンスのパブリックSRVエンドポイントはこの制限の対象ではありません。

    次のセクションでは、各エンドポイントの形式、パラメーター、および例について説明します。

    Mongosエンドポイント

    形式：

    <host>:<port>

    パラメーター：

    パラメーター

    説明

    <ホスト>

    mongosコンポーネント内のノードのドメイン名。

    <ポート>

    mongosコンポーネント内のノードのポート番号。

    例：

    s-bp1c010266f6****.mongodb.rds.aliyuncs.com:3717

    Shardエンドポイント

    形式：

    <host>:<port>

    パラメーター：

    パラメーター

    説明

    <ホスト>

    シャードコンポーネント内のノードのドメイン名。

    <ポート>

    シャードコンポーネント内のノードのポート番号。

    例：

    s-bp1c010266f6****.mongodb.rds.aliyuncs.com:3717

    ConfigServerエンドポイント

    形式：

    <host>:<port>

    パラメーター：

    パラメーター

    説明

    <ホスト>

    ConfigServerコンポーネント内のノードのドメイン名。

    <ポート>

    ConfigServerコンポーネント内のノードのポート番号。

    例：

    s-bp1c010266f6****.mongodb.rds.aliyuncs.com:3717

    接続文字列URI

    次のセクションでは、mongosまたはシャードシャードの接続文字列URIについて説明します。

    Mongosノード

    重要

    アプリケーションが本番環境にデプロイされている場合は、接続文字列URIを使用してインスタンスに接続することを推奨します。 これにより、クライアントはリクエストを自動的にmongosノードに分散して、インスタンス内の負荷を分散できます。 mongosノードに障害が発生した場合、クライアントは他の正常なmongosノードにリクエストを自動的にリダイレクトできます。

    形式： 

    mongodb://<username>:<password>@<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>/<database>[?&authSource=<authenticationDatabase>]

    パラメーター

    説明

    <username>

    データベースへのログインに使用されるデータベースアカウントの名前。 デフォルト値：root。

    <パスワード>

    データベースアカウントのパスワードを設定します。

    <ホスト>

    mongosコンポーネント内のノードのドメイン名。

    <ポート>

    mongosコンポーネント内のノードのポート番号。

    <データベース>

    接続するデータベースの名前。 デフォルト値: admin。

    authSource=<authenticationDatabase> (オプション)

    指定されたデータベースアカウントが属するデータベース。 <authenticationDatabase> は、認証に使用するデータベースの名前を示します。 認証データベースを指定しない場合は、<database> で指定したデータベースが認証データベースとして使用されます。

    例：

    次のサンプルコマンドでは、ユーザー名はtest、データベースはadminです。 

    mongodb://test:****@s-bp1c010266f6****.mongodb.rds.aliyuncs.com:3717,s-bp1773180e38****.mongodb.rds.aliyuncs.com:3717/admin

    シャードノード

    インスタンス内のシャードノードの接続文字列URIは、負荷分散を実装し、高可用性を確保できるHA接続文字列URIです。 接続文字列URIを使用してインスタンスに接続し、インスタンス内のデータベースに対して読み取り /書き込み操作を実行できます。 エンドポイントを使用すると、インスタンス内のすべてのシャードノードに接続できます。 アプリケーションが本番環境にデプロイされている場合は、接続文字列URIを使用してインスタンスに接続することを推奨します。

    重要

    このURIを使用してインスタンスに接続すると、すべてのリクエストはインスタンスのプライマリノードによって処理されます。 読み取り /書き込み操作は、プライマリ /セカンダリの切り替えの影響を受けません。

    形式：

    mongodb://<username>:<password>@<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>/<database>?replicaSet=<replicaSet_value>[&authSource=<authenticationDatabase>]

    パラメーター：

    パラメーター

    説明

    <username>

    データベースへのログインに使用されるデータベースアカウントの名前。 デフォルト値：root。

    <パスワード>

    データベースアカウントのパスワードを設定します。

    <ホスト>

    プライマリ、セカンダリ、または読み取り専用ノードへの接続に使用されるドメイン名。

    <ポート>

    プライマリ、セカンダリ、または読み取り専用ノードへの接続に使用されるポート。

    <データベース>

    接続するデータベースの名前。 デフォルト値: admin。

    replicaSet=<replicaSet_value>

    読み取り要求がインスタンスのすべてのノードに送信されることを指定します。 <replicaSet_value> は、インスタンスのHAエンドポイントの一意のIDを示します。

    authSource=<authenticationDatabase> (オプション)

    指定されたデータベースアカウントが属するデータベース。 <authenticationDatabase> は、認証に使用するデータベースの名前を示します。 認証データベースを指定しない場合は、<database> で指定したデータベースが認証データベースとして使用されます。

    readPreference=[primary | primaryPreferred | secondary | secondaryPreferred] (オプション)

    書き込み要求がプライマリノードに送信され、読み取り要求がパラメーターで指定されたノードに送信されることを指定します。 このパラメータは、読み書き分離と負荷分散を保証します。 有効な値：

    • readPreference=primary: 読み取り要求はプライマリノードにのみ送信されます。

    • readPreference=primaryPreferred: 読み取り要求は優先的にプライマリノードに送信されます。 プライマリノードに障害が発生した場合、読み取り要求はセカンダリノードと読み取り専用ノードに送信されます。

    • readPreference=secondary: 読み取り要求は、セカンダリおよび読み取り専用ノードにのみ送信されます。 セカンダリノードと読み取り専用ノードに障害が発生した場合、読み取り要求は失敗し、プライマリノードに送信されません。

    • readPreference=secondaryPreferred: 読み取り要求は、セカンダリノードと読み取り専用ノードに優先的に送信されます。 セカンダリノードと読み取り専用ノードに障害が発生した場合、読み取り要求はプライマリノードに送信されます。

    説明

    読み取り要求がセカンダリノードと読み取り専用ノードに送信されると、不均一な負荷が発生する可能性があります。 読み取り要求を受信するノードをさらに指定するには、readPreferenceTagsパラメーターを設定します。

    readPreferenceTags=<readonly_Tags> (オプション)

    指定したタグに対応するノードに優先的に読み取り要求を送信するように指定します。 ほとんどの場合、パラメーターはreadPreferenceパラメーターと一緒に指定され、primaryモードと互換性がありません。 <readonly_Tags> は、読み取り専用ノードのタグキーとタグ値を示し、role:electableオプションとrole:readonlyオプションが含まれます。 有効な値：

    • readPreferenceTags=role:electable: セカンダリノードから優先的にデータが読み取られます。

      説明

      このオプションは、クラウドディスクを使用するインスタンスでのみ使用できます。

    • readPreferenceTags=role:readonly: データは読み取り専用ノードから優先的に読み取られます。

    インスタンスでは、readPreferenceパラメーターとreadPreferenceTagsパラメーターを使用できます。 異なるタグの組み合わせは、様々なシナリオの要件を満たすことができる。 次の表に、さまざまなシナリオでのパラメーターの組み合わせを示します。

    読み取り要求を受信するプライマリノードの応答ポリシー

    読み取り要求を受信するノード

    パラメータの組み合わせソリューション

    失敗した読み取り要求をプライマリノードに送信する

    プライマリノードから優先的にデータを読み取る

    readPreference=primaryPreferred

    セカンダリノードと読み取り専用ノードから優先的にデータを読み取る

    readPreference=secondaryPreferred

    セカンダリノードから優先的にデータを読み取る

    説明

    セカンダリノードに障害が発生した場合、読み取り要求がプライマリノードに送信されます。

    readPreference=secondaryPreferred&readPreferenceTags=role:electable

    読み取り専用ノードから優先的にデータを読み取る

    説明

    読み取り専用ノードに障害が発生した場合、読み取り要求はプライマリノードに送信されます。

    readPreference=secondaryPreferred&readPreferenceTags=role:readonly

    失敗した読み取り要求をプライマリノードに送信しない

    セカンダリノードと読み取り専用ノードからのみデータを読み取る

    readPreference=セカンダリ

    セカンダリノードからのみデータを読み取る

    説明

    セカンダリノードに障害が発生した場合、読み取り操作は失敗します。

    readPreference=secondary&readPreferenceTags=role:electable

    読み取り専用ノードからのみデータを読み取る

    説明

    読み取り専用ノードに障害が発生した場合、読み取り操作は失敗します。

    readPreference=secondary&readPreferenceTags=role:readonly

    例：

    mongodb://test:****@dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-6108****

    SRV HAエンドポイント

    形式：

    mongodb+srv://<username>:<password>@<srv-host>/<database>?<options>

    パラメーター：

    パラメーター

    説明

    mongodb + srv://

    接続文字列のプレフィックス。DNS SRVレコードを使用してサービスを識別することを示します。

    <username>

    データベースへのログインに使用されるデータベースアカウントの名前。 デフォルト値：root。

    <パスワード>

    データベースアカウントのパスワードを設定します。

    <srv-host>

    ホスト名。

    <データベース>

    接続するデータベースの名前。 デフォルト値: admin。

    <オプション>

    その他のオプションパラメーター。

    説明

    SRV HAエンドポイントのsslパラメーターのデフォルト値はtrueです。 SSL暗号化機能を使用しなくなった場合は、インスタンスのエンドポイントにfalseに設定されたsslパラメーターを追加します。 オプションパラメーターの詳細については、「MongoDBドキュメント」をご参照ください。

    例：

    次のサンプルコマンドでは、ユーザー名はtest、データベースはadminです。 

    mongodb+srv://test:****@dds-2zef4c23****-srv.mongodb.pre.nosql.aliyuncs.com/admin?ssl=false

    インスタンスの特定のデータベースにログインする

    1. 次の情報を取得します。

      • インスタンスの接続文字列またはURI。 詳細については、「シャードクラスターインスタンスの接続文字列とURIの表示」をご参照ください。

      • インスタンスへの接続に使用されるデータベースアカウント。 初期アカウントはルートアカウントです。

        重要

        ルートアカウントを使用して本番環境のデータベースに接続しないことをお勧めします。 データベースアカウントを作成し、ビジネス要件に基づいてアカウントに権限を付与できます。 詳細については、「MongoDBデータベースユーザーの権限の管理」をご参照ください。

      • インスタンスへの接続に使用されるデータベースアカウントのパスワード。 データベースアカウントのパスワードを指定しない場合、またはアカウントのパスワードを忘れた場合は、アカウントのパスワードを設定または変更できます。 詳細については、「 (オプション) パスワードのリセット」をご参照ください。

      • 接続するデータベースの名前。 ユーザー名がrootの場合は、adminと入力します。

    2. 特定のデータベースにログオンします。 詳細については、以下のトピックを参照してください。

    一般的な接続シナリオ

    よくある質問