接続プールによる接続の管理

maxPoolSize

アプリケーションのリクエストをサポートするために必要なソケットに加えて、各 MongoClientインスタンスは、サーバーの状態を監視するためにMongoDBトポロジー内のサーバーごとに最大 2 つの接続を開きます。

例、3 ノードのレプリカセットに接続されたクライアントは6 つの監視ソケットを開きます。アプリケーションがmaxPoolSize のデフォルト設定を使用し、 プライマリ （デフォルト）ノードのみをクエリする場合、接続プールには最大で 106 個のソケットと 100 接続が存在できます。アプリケーションが読み込み設定 (read preference)を使用してセカンダリ ノードをクエリする場合、それらの接続プールは大きくなり、開いている監視ソケットを含む合計接続数は 306 になる可能性があります。

1 つのプロセス内で多数の同時 MongoDB リクエストをサポートするには、 maxPoolSizeを増やすことができます。

次のコードでは、optionsオブジェクトで maxPoolSize オプションを指定して、最大接続プールサイズが 200 である MongoClientインスタンスが作成されます。

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  maxPoolSize: 200
});

maxConnecting

接続プールは接続確立をレート制限します。maxConnecting オプションによって、プールが並行して作成できる接続数が決定されます。例、maxConnecting の値が 2 の場合、接続を同時にチェックアウトしようとする 3 番目のリクエストは、次のいずれかの場合にのみ成功します。

• 接続プールは接続の作成を完了し、プール内の接続数はmaxPoolSize未満です。

• 既存の接続がプールにチェックバックされます。

次のコードでは、optionsオブジェクトで maxConnecting オプションを指定して、プールごとに同時に確立される最大数の 2 接続を持つ MongoClientインスタンスを作成します。

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
   maxConnecting: 2
});

minPoolSize

minPoolSize オプションを使用して、各サーバーへの最小接続数を設定できます。ドライバーが、接続プール内に minPoolSize オプションで設定された接続数以上が常に存在するようにします。ソケットが閉じられ、ソケットの合計数（使用中とアイドル状態の両方）が最小値を下回る場合、最小値に達するまでさらにソケットが開かれます。

次のコードでは、optionsオブジェクトで minPoolSize オプションを指定して、最小接続プール サイズが 10 である MongoClientインスタンスが作成されます。

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  minPoolSize: 10
});

maxIdleTimeMS

maxIdleTimeMSオプションを設定することで、プール内で接続がアイドル状態を維持できる最大ミリ秒数を設定できます。 maxIdleTimeMSの接続がアイドル状態になると、接続プールはそれを削除し、置き換えます。 このオプションのデフォルトは0 （制限なし）です。

次のコードでは、optionsオブジェクトで maxIdleTimeMS 設定を指定して、最大アイドル時間が 10000 ミリ秒（10 秒）の MongoClientインスタンスを作成します。

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  maxIdleTimeMS: 10000
});

waitQueueTimeoutMS

MongoClient は、複数の同時リクエストをサポートします。 プロセスごとにクライアントを作成し、プロセス内のすべての操作で再利用します。 この方法は、リクエストごとにクライアントを作成するよりも効率的です。

ドライバーはソケットが利用可能になるまで待機できるリクエストの数を制限しません。負荷が急増したときにプールのサイズを境界のあるキューに制限するのはアプリケーションの責任です。 リクエストは、 waitQueueTimeoutMSオプションで指定された時間だけ待機します。デフォルトでは0 （制限なし）です。

ソケットを対象にwaitQueueTimeoutMSで定義された時間以上待機するリクエストでは、接続エラーが発生します。 すべての操作を完了することよりも、負荷急増中に操作の継続時間を制限することが重要な場合は、このオプションを使用します。

次のコードでは、待機キューの最大タイムアウトが 10000 ミリ秒（10 秒）である MongoClientインスタンスを、optionsオブジェクトで宣言して作成します。

const { MongoClient } = require('mongodb');
const uri = '<connection-string>';
const client = new MongoClient(uri, {
  waitQueueTimeoutMS: 10000
});