接続文字列の形式

SRV 接続形式

MongoDB は、DNS で構築された シード リスト をサポートしています。DNS を使用して使用可能なサーバー リストを作成しておくことで、配置の柔軟性が向上し、クライアントの再構成不要でサーバーのローテションが可能となります。

SRV URI 接続スキームの形式は次のとおりです。

mongodb+srv://[username:password@]host[/[defaultauthdb][?options]]

その他の例については、次のページを参照してください。

• MongoDB Atlas 配置接続文字列の例

• 自己管理型配置の接続文字列の例

$ : / ? # [ ] @

DNSシードリストを使用するには、標準の mongodb+srvmongodbではなく のプレフィックスを持つ標準の接続文字列と同じ構文を使用します。+srv は、それに続くホスト名が DNS SRVレコードに対応していることをクライアントに示します。ドライバーまたは mongosh は DNS でレコードをクエリして、mongod または mongos インスタンスを実行中いるホストを判断します。

+srv 形式を使用する場合は、hostname、domain、および top-level domain (TLD) を次の形式で指定する必要があります: <hostname>.<domain>.<TLD>. 次の表は、プレースホルダーがサンプル値にどのように対応しているかを示しています。

この例では、<hostname>.<domain>.<TLD> 形式を正しく使用する DNS シード リスト 接続文字列を示しています。パスワード D1fficultP%40ssw0rd を使用してユーザー myDatabaseUser として認証します。

mongodb+srv://myDatabaseUser:D1fficultP%40ssw0rd@server.example.com/

対応する DNS 構成は次のようになります。

Record                            TTL   Class    Priority Weight Port  Target
_mongodb._tcp.server.example.com. 86400 IN SRV   0        5      27317 mongodb1.example.com.
_mongodb._tcp.server.example.com. 86400 IN SRV   0        5      27017 mongodb2.example.com.

個々の SRV レコードは _mongodb._tcp.<hostname>.<domain>.<TLD> 形式である必要があります。

クライアントがシードリストのメンバーに接続すると、クライアントは接続できるレプリカセットメンバーのリストを検索します。クライアントはシード リストで DNS エイリアスを使用することが多いため、ホストは元のシードリストとは異なるサーバーリストを返す可能性があります。このような場合、クライアントはシードリストにリストされているホスト名ではなく、レプリカセットによって提供されるホスト名を使用して、結果のレプリカセット構成内のホスト名を介してレプリカセットメンバーにアクセスできるようにします。

標準の接続文字列と同様に、DNS シード リストの接続文字列では、クエリ文字列としてオプションを指定することができます。DNSシードリスト文字列 は、TXTレコードで以下のオプションを指定することもできます。

• replicaSet

• authSource

mongodインスタンスごとに指定できる TXTレコードは1 つだけです。DNS に複数の TXT レコードが存在する場合、または TXTレコードに replicaSet または authSource 以外のオプションが含まれている場合、クライアントはエラーを返します。

server.example.comDNS エントリの TXTレコードは次の例のようになります。

Record              TTL   Class    Text
server.example.com. 86400 IN TXT   "replicaSet=mySet&authSource=authDB"

DNS SRV レコードと TXT レコードで指定されたオプションを組み合わせると、次の標準形式の接続文字列が解決されます。

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb1.example.com:27317,mongodb2.example.com:27017/?replicaSet=mySet&authSource=authDB

TXTレコードで指定されたオプションを上書きするには、クエリ文字列で オプションを指定します。 例、次のクエリ文字列は、前の DNS エントリの TXTレコードで構成されている authSource オプションを上書きします。

mongodb+srv://myDatabaseUser:D1fficultP%40ssw0rd@server.example.com/?connectTimeoutMS=300000&authSource=aDifferentAuthDB

authSource のオーバーライドを指定すると、標準形式の同等の接続文字列は次の例のようになります。

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb1.example.com:27317,mongodb2.example.com:27017/?connectTimeoutMS=300000&replicaSet=mySet&authSource=aDifferentAuthDB

標準接続文字列形式

このセクションでは、セルフホスト型 MongoDB スタンドアロン配置、レプリカセット、またはシャード クラスターに接続するために使用される MongoDB 接続 URI の標準形式について説明します。

標準の URI 接続スキームの形式は次のとおりです。

mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb0.example.com:27017/myDefaultDB?authSource=admin

$ : / ? # [ ] @