ApsaraDB for MongoDB:レプリカセットインスタンスへの接続

パラメーター

説明

mongodb+srv://

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

<username>

データベースアカウント。

<password>

データベースアカウントのパスワード。

<srv-host>

ホスト名。

<database>

アクセスするデータベースの名前。値を admin に設定します。

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

データベースアカウントが属するデータベース。<authenticationDatabase> は認証データベースの名前を示します。

<other_options>

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

パラメーター

説明

<username>

データベースアカウント。値を root に設定します。

<password>

データベースアカウントのパスワード。

<host>

プライマリ、セカンダリ、または読み取り専用ノードの [ドメイン名情報]。

<port>

プライマリ、セカンダリ、または読み取り専用ノードの [ポート]。

<database>

アクセスするデータベースの名前。値を admin に設定します。

replicaSet=<replicaSet_value>

読み取りリクエストがインスタンスのすべてのノードに送信されるように指定します。<replicaSet_value> は、インスタンスの高可用性エンドポイントの一意の ID を示します。

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

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

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

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

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

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

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

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

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

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

• readPreferenceTags=role:electable: 読み取りリクエストは優先的にセカンダリノードに送信されます。

  説明

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

• readPreferenceTags=role:readonly: 読み取りリクエストは優先的に読み取り専用ノードに送信されます。

読み取りリクエストを受信するためのプライマリノードの応答ポリシー

読み取りリクエストを受信するノード

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

失敗した読み取りリクエストをプライマリノードに送信する

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

readPreference=primaryPreferred

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

readPreference=secondaryPreferred

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

readPreference=secondaryPreferred&readPreferenceTags=role:electable

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

readPreference=secondaryPreferred&readPreferenceTags=role:readonly

失敗した読み取りリクエストをプライマリノードに送信しない

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

readPreference=secondary

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

readPreference=secondary&readPreferenceTags=role:electable

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

readPreference=secondary&readPreferenceTags=role:readonly

パラメーター

説明

<username>

データベースアカウントです。値を root に設定します。

<password>

データベースアカウントのパスワード。

<host>

[ドメイン名情報] は読み取り専用ノードのものです。

<port>

読み取り専用ノードの [ポート] です。

<database>

接続先のデータベースの名前。値を admin に設定します。

readPreference=secondary&readPreferenceTags=role:readonly

読み取りリクエストが読み取り専用ノードに送信されるように指定します。readPreferenceTags は、読み取り専用ノードに対応するタグキーとタグ値を示します。値は role:readonly に固定されています。このパラメーターは変更できません。

replicaSet=<replicaSet_value>

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

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

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

パラメータ

説明

<host>

プライマリノードの [ドメイン名情報] です。

<port>

プライマリノードの [ポート] です。

パラメータ

説明

<host>

セカンダリノードの [ドメイン名情報] です。

<port>

セカンダリノードの [ポート] です。

パラメータ

説明

<host>

読み取り専用ノードの [ドメイン名情報] です。

<port>

読み取り専用ノードの [ポート] です。