接続オプション
Overview
このガイドでは、MongoDB の接続および認証オプションについて学習できます。 接続string Client
のパラメーターとして接続オプションを設定して、サーバーに接続するときに {0 インスタンスの動作を指定できます。
オプション名 | 許容値 | デフォルト値 | 説明 |
---|---|---|---|
appName | 文字列 | なし | Specifies the application name that the Client instance sends
to the server as part of the handshake.Specifying an appName can help you use the server logs to
determine which Client instance is connected to the server. |
authMechanism | 文字列 | なし | 使用する認証メカニズムを指定します。 このオプションを指定しない場合、ドライバーはデフォルトの認証メカニズムを使用します。 Rust ドライバーでの認証の詳細については、「 認証メカニズム に関するガイドを参照してください。 |
authMechanismProperties | 文字列 | なし | authMechanism オプションで設定された認証メカニズムの詳細なプロパティを指定します。 |
authSource | 文字列 | 説明を参照してください | Specifies the database used to authenticate. This option defaults to admin for SCRAM-based authentication mechanisms,
$external for the MONGODB-X509 mechanism, and the database name or
$external for the PLAIN mechanism. |
compressors | 文字列のコンマ区切りリスト | なし | Client インスタンスが指定された順序で使用するコンプレッサーを指定します。 ネットワーク圧縮の詳細については、「ネットワーク圧縮 」のガイドを参照してください。 |
connectTimeoutMS | Non-negative integer | 10000 (10 秒) | サーバーに接続するときに、基礎の各 TCP ストリームに渡される接続タイムアウトをミリ秒単位で指定します。 |
directConnection | ブール値 | false | Client インスタンスがクラスター内のすべてのサーバーを検出して接続するのではなく、単一のホストに直接接続するかどうかを指定します。 |
heartbeatFrequencyMS | 500 以上の整数 | 10000 (10 秒) | 各監視スレッドがサーバー チェックの実行間で待機する時間をミリ秒単位で指定します。 |
journal | ブール値 | false | 操作がディスク上のジャーナルに伝達されたことの確認を要求します。 |
localThresholdMS | Non-negative integer | 15 | Specifies the amount of time in milliseconds that the average
round-trip time between the driver and server can last
compared to the shortest round-trip time of all the suitable servers. A value of 0 indicates that there is no latency window, so
only the server with the lowest average round-trip time is
eligible. |
maxIdleTimeMS | Non-negative integer | 0 | Specifies the amount of time in milliseconds that a connection
can remain idle in a connection pool the server closes it. A value of 0 indicates that the client does not close idle
connections. |
maxStalenessSeconds | -1 、または 以上の任意の整数 90 | -1 | Specifies the maximum lag, in seconds, behind the primary node
that a secondary node can be to be considered for the given operation. The value of this option must be at least 90 , or the
operation raises an error. A value of -1 means there is no
maximum lag. |
maxPoolSize | Non-negative integer | 10 | Specifies the maximum number of connections that the Client
instance can create in a connection pool for a given server.If you attempt an operation while the value of maxPoolSize
connections are checked out, the operation waits until an
in-progress operation finishes and the connection returns to the pool. |
minPoolSize | Non-negative integer | 0 | Specifies the minimum number of connections that are available in
a server's connection pool at a given time. If fewer than minPoolSize connections are in the pool,
the server adds connections in the background up to the value of minPoolSize . |
readConcernLevel | 文字列 | なし | Client インスタンスで実行される操作のデフォルトの読み取り保証を指定します。 詳細については、サーバー マニュアルの読み取り保証を参照してください。 |
readPreference | 文字列 | primary | ドライバーが読み取り操作をレプリカセットのノードにルーティングする方法を指定します。 詳細については、サーバー マニュアルの「読み込み設定」を参照してください。 |
readPreferenceTags | キーと値のペアをコンマで区切ったリスト | なし | どのレプリカセット ノードを操作の対象にするかを指定します。 このキーの各インスタンスは、個別のタグ セットです。 ドライバーは、セット内の各タグを持つ 1 つまたは複数のサーバーを見つけるまで、各タグセットをチェックします。 |
replicaSet | 文字列 | なし | Client インスタンスが接続するレプリカセットの名前を指定します。 |
retryReads | ブール値 | true | 操作が失敗した場合にクライアントが読み取り操作を再試行するかどうかを指定します。 |
serverSelectionTimeoutMS | Non-negative integer | 30000 (30 秒) | Client インスタンスがタイムアウトする前に操作のサーバーを選択しようとする際に待機する時間をミリ秒単位で指定します。 |
tls | ブール値 | false | サーバーとの接続で使用する Client インスタンスの TLS 構成を指定します。 デフォルトでは、TLS はオフになっています。 |
tlsAllowInvalidCertificates | ブール値 | false | Specifies whether the Client instance returns an error if the
server presents an invalid certificate.We recommend that you set this option to true only in
testing environments to avoid creating vulnerabilities in your
application. |
tlsCAFile | 文字列 | 説明を参照してください | Specifies the path to the certificate authority (CA) file that
the Client instance uses for TLS.If you do not specify this option, the driver uses the Mozilla
root certificates from the webpki-roots crate. |
tlsCertificateKeyFile | 文字列 | なし | Specifies the path to the certificate file that the Client
instance presents to the server to verify its identify.If you do not set this option, the Client instance does not
attempt to verify its identity to the server. |
tlsInsecure | ブール値 | false | Specifies whether the Client instance returns an error if the
server presents an invalid certificate.We recommend that you set this option to true only in
testing environments to avoid creating vulnerabilities in your
application. |
w | 負でない整数または文字列 | なし | Requests acknowledgment that the operation has propagated to a
specific number or variety of servers. To learn more, see Write Concern in the Server manual. |
wTimeoutMS | Non-negative integer | タイムアウトなし | 書込み保証 (write concern) の時間制限をミリ秒単位で指定します。 制限時間内に操作が要求されたレベルに伝達されなかった場合、ドライバーはエラーを発生させます。 |
zlibCompressionLevel | -1 から 9 までの整数 | -1 | Specifies the level field of the zlib compression if you use that compressor.Setting a value of -1 selects the default compression level (6 ).Setting a value of 0 specifies no compression, and setting
a value of 9 specifies maximum compression.To learn more about network compression, see the Network Compression guide. |
接続オプションの完全なリストを表示するには、サーバー マニュアル エントリの「接続stringオプション 」セクションにアクセスしてください。