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

パラメーター

説明

mongodb+srv://

接続文字列のプレフィックス。サービスディスカバリに DNS SRV レコードが使用されることを示します。

<username>

データベースアカウントの名前。

<password>

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

<srv-host>

ホスト名。

<database>

アクセスするデータベースの名前。デフォルト値は admin です。

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

このパラメーターは、データベースアカウントが存在するデータベースを指定します。<authenticationDatabase> は認証データベースの名前です。

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

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

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

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

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

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

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

このパラメーターは、指定されたタグに一致するノードに読み取りリクエストを優先的に送信します。通常、readPreference パラメーターと共に使用され、primary モードとは互換性がありません。<readonly_Tags> は、読み取り専用ノードのタグのキーと値のペアのリストです。次のタイプがサポートされています。

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

  説明

  このオプションは、ディスクを使用するインスタンスでのみ有効です。

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

<other_options>

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

読み取りリクエストのルーティングポリシー

読み取りリクエストのターゲットノード

パラメーターの組み合わせ

読み取りリクエストはプライマリノードにフォールバック可能

最初にプライマリノードから読み取る

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 です。

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> は、読み取り専用ノードのタグのキーと値のペアのリストです。次のタイプがサポートされています。

• 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> は、インスタンスの高可用性エンドポイントの一意の ID です。

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

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

パラメーター

説明

<username>

データベースアカウントの名前。

<password>

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

<host>

プライマリノードのドメイン名

<port>

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

<database>

アクセスするデータベースの名前。デフォルト値は admin です。

directConnection=true (オプション)

リクエストが現在のエンドポイント (プライマリノード) にのみ送信されるように指定します。

• このパラメーターを指定し、その値を true に設定すると、読み取りリクエストと書き込みリクエストの両方がプライマリノードに送信されます。

• このパラメーターを指定しないか、その値を false に設定すると、読み取りリクエストが他のノードに転送される可能性があります。

パラメーター

説明

<username>

データベースアカウントの名前。

<password>

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

<host>

セカンダリノードのドメイン名。

<port>

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

<database>

アクセスするデータベースの名前。デフォルト値は admin です。

directConnection=true (オプション)

リクエストが現在のエンドポイント (セカンダリノード) にのみ送信されるように指定します。

• このパラメーターを指定し、その値を true に設定すると、書き込みリクエストは拒否されます。

• このパラメーターを指定しないか、その値を false に設定すると、書き込みリクエストはプライマリノードに転送されます。

パラメーター

説明

<username>

データベースアカウントの名前。

<password>

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

<host>

読み取り専用ノードの[ドメイン名]

<port>

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

<database>

アクセスするデータベースの名前。デフォルト値は admin です。

directConnection=true

リクエストが現在のエンドポイント (読み取り専用ノード) にのみ送信されるように指定します。

• このパラメーターを指定し、その値を true に設定すると、書き込みリクエストは拒否されます。

• このパラメーターを指定しないか、その値を false に設定すると、書き込みリクエストはプライマリノードに転送されます。