Docs Menu
Docs Home
/ / /
Node.js
/ /

接続オプション

このセクションでは、ドライバーでサポートされている MongoDB 接続および認証オプションについて説明します。接続 URI のパラメーターとして接続オプションを渡し、クライアントの動作を指定できます。

名前
許容値
デフォルト値
説明
appName
string
null
接続ハンドシェイクの一環として、ドライバーがクライアントのメタデータでサーバーに渡すアプリ名を指定します。ドライバーは接続を確立するときに appName 値を MongoDB に送信します。この値は、ログファイル、スロークエリログ、プロファイル コレクションに記録されます。
authMechanism
string
null
サーバーへの接続に使用する認証メカニズムの方法を指定します。 値を指定しない場合、ドライバーはサーバーのバージョンに応じてデフォルトのメカニズムである、 SCRAM-SHA-1またはSCRAM-SHA-256を使用します。 使用可能な認証メカニズムについては、「 認証メカニズム」を参照してください。
authMechanismProperties
カンマで区切られたキーと値のペア(例: opt1:val1,opt2:val2)
null
GSSAPI のホスト名正規化を有効にするなど、認証に提供される追加オプションを指定します。
authSource
string
null
接続の認証対象となるデータベースを指定します。
compressors
カンマ区切りの文字列リスト(例: snappy,zlib,zstd)
null
サーバーとの間で送受信されるワイヤプロトコルのメッセージに許可される圧縮の種類を指定します。詳細については、「ネットワーク圧縮」を参照してください。
connectTimeoutMS
non-negative integer
30000
エラーが発生する前に、サーバーへの単一の TCP ソケット接続を確立するための待機時間をミリ秒単位で指定します。0 を指定すると、接続タイムアウトが無効になります。
directConnection
ブール値
false
接続 URI で指定されたホストにすべての操作を強制的にディスパッチするかどうかを指定します。
enableUtf8Validation
ブール値
true

true を指定すると、接続の UTF-8 検証が有効になります。MongoDB は、無効な UTF-8 文字を含む文字列データを BSON に直列化する場合、エラーをスローします。これはドキュメント キーとドキュメント値の両方に当てはまるため、この検証により処理のオーバーヘッドが増加します。

false を指定すると、接続の UTF-8 検証が無効になります。MongoDB は、データに無効な UTF-8 データが含まれる場合でもエラーをスローしません。検証を無効にすると、アプリケーションは検証処理のオーバーヘッドを回避します。検証が無効になっているときにデータを編集すると、データが失われる可能性があります。UTF-8 検証を無効にすることは、データのクエリまたはエクスポートのみを行う場合の一時的な回避策です。

Node.js コードで UTF- 8検証を設定することもできます。 UTF-8 文字の詳細については、 UTF-8 を参照してください Wikipedia で。

heartbeatFrequencyMS
500 以上の整数
null
定期的なサーバーのモニタリング チェックの間隔をミリ秒単位で指定します。
journal
ブール値
null
クライアントのデフォルトの書込み保証 (write concern) "j" フィールドを指定します。 詳しくは、「書込み保証(write concern)」を参照してください。
loadBalanced
ブール値
null
ドライバーがロード バランサーに接続しているかどうかを指定します。
localThresholdMS
non-negative integer
15
適切なサーバー間で選択するためのラウンド トリップ時間のレイテンシ ウィンドウのサイズをミリ秒単位で指定します。0 を指定すると待機なしとなり、利用可能な最速のサーバーを意味します。
maxIdleTimeMS
non-negative integer
0
接続が閉じられる前にアイドル状態を維持できる時間をミリ秒単位で指定します。0 を指定すると、最小値がないことを意味します。
maxPoolSize
non-negative integer
100
ドライバーが接続プール内に作成できるクライアントまたは最大接続数を指定します。このカウント数には、使用中の接続が含まれています。
maxConnecting
non-negative integer
2
ドライバーの接続プールが同時に確立できる最大接続数を指定します。
maxStalenessSeconds
-1、または 90 以上の整数
null
セカンダリで発生してもサーバー選択の対象となる最大レプリケーションラグを、ウォール クロック時間で指定します。-1 を指定すると、最大値はありません。
minPoolSize
non-negative integer
0
操作が行われていない場合でも、ドライバーが接続プールに作成して維持する接続の数を指定します。このカウント数には、使用中の接続が含まれています。
proxyHost
string
null
MongoDB サービスへの接続に使用される SOCKS 5プロキシ サーバーの IPv 4 /IPv 6アドレスまたはドメイン名を指定します。
proxyPort
non-negative integer
null
proxyHostで指定された SOCKS 5プロキシ サーバーのポートを指定します。
proxyUsername
string
null
proxyHostで指定された SOCKS 5プロキシ サーバーへのユーザー名/パスワード認証に使用するユーザー名を指定します。
proxyPassword
string
null
proxyHostで指定された SOCKS 5プロキシ サーバーへのユーザー名およびパスワード認証のパスワードを指定します。
readConcernLevel
string
null
クライアントのデフォルトの読み取り保証 (read concern) を指定します。詳細については、「読み取り保証 (read concern)」を参照してください。
readPreference
string
"primary"
クライアントのデフォルトの読み込み設定 (read preference) を指定します(タグは除く)。詳細については、「読み込み設定 (read preference)」を参照してください。
readPreferenceTags
カンマで区切られたキー: 値のペア。たとえば、「dc:ny,rack:1」と「dc:ny」は複数回指定できます。このキーの各インスタンスは個別のタグセットです。
null

クライアントのデフォルトの読み込み設定 (read preference) タグを指定します。このオプションは、読み込み設定 (read preference) モードがプライマリでない場合にのみ有効です。

ドライバーは、URI 内のタグの順序を読み込み設定 (read preference) の順序として使用します。

replicaSet
string
null
接続先のレプリカセットの名前を指定します。
retryReads
ブール値
true
再試行可能な読み取りを有効にします。
retryWrites
ブール値
true
再試行可能な書き込みを有効にします。
serverSelectionTimeoutMS
non-negative integer
30000
エラーが発生する前にサーバー選択をブロックするタイムアウトをミリ秒単位で指定します。
serverSelectionTryOnce
ブール値
true
サーバー選択がタイムアウトするまでトポロジーを繰り返しスキャンするのではなく、サーバー選択が失敗した後に 1 回だけトポロジーをスキャンするように指定します。
socketTimeoutMS
non-negative integer
0
タイムアウトする前にソケットでの送信または受信の試行に費やされる時間をミリ秒単位で指定します。0 を指定すると、タイムアウトは発生しません。
srvMaxHosts
non-negative integer
0
シードリストを最初に設定するとき、または SRV ポーリング中にトポロジに新しいホストを追加するときにランダムに選択する SRV 結果の最大数を指定します。
srvServiceName
RFC6335 に準拠した有効な SRV サービス名
"mongodb"
最初の DNS シードリストの発見で SRV ルックアップに使用するサービス名を指定します。
ssl
ブール値
false
ssl は、tls オプションのエイリアスです。
tls
ブール値
false
サーバーへの接続に TLS が必要かどうかを指定します。 "mongodb+srv"srvServiceNameを使用するか、他のtlsプレフィックス付きオプションを指定すると、 tlsはデフォルトでtrueになります。
tlsAllowInvalidCertificates
ブール値
false
サーバーの TLS 証明書が無効な場合にドライバーがエラーを生成するかどうかを指定します。テスト目的のみでこのオプションを true に設定します。
tlsAllowInvalidHostnames
ブール値
false
サーバーのホスト名と TLS 証明書で指定されたホスト名が一致しない場合に、ドライバーがエラーを生成するかどうかを指定します。テスト目的のみでこのオプションを true に設定します。
tlsCAFile
string
null
TLS 接続を行う場合、1 つまたはまとまった証明書の認可があるファイルへのパスを指定します。
tlsCertificateKeyFile
string
null
クライアント証明書ファイルまたはクライアント秘密キーファイルへのパスを指定します。両方が必要な場合は、ファイルを連結する必要があります。
tlsCertificateKeyFilePassword
string
null
TLS 接続に使用するクライアント秘密キーを復号化するためのパスワードを指定します。
tlsInsecure
ブール値
false
無効な証明書やホスト名の不一致を許可するなど、TLS 制約を可能な限り緩和することを指定します。テスト目的のみでこのオプションを true に設定します。
w
負でない整数または文字列
null
クライアントのデフォルトの書込み保証 (write concern) "w" フィールドを指定します。
waitQueueTimeoutMS
non-negative integer
0
タイムアウトになるまでにサーバーの接続プールから接続をチェックアウトするのに費やされる時間をミリ秒単位で指定します。
wTimeoutMS
non-negative integer
null
クライアントのデフォルトの書込み保証 (write concern) "wtimeout" フィールドを指定します。
zlibCompressionLevel
-1 以上9 以下の整数
-1
zlib を使用してワイヤプロトコルのメッセージを圧縮するときの圧縮レベルを指定します。-1 はデフォルトのレベル、0 は圧縮なし、1 は最速の速度、9 は最適な圧縮を示します。詳細については、「ネットワーク圧縮」を参照してください。

戻る

接続ガイド