Gerencie conexões com pools de conexões

maxPoolSize

Além dos soquetes necessários para dar suporte às solicitações do seu aplicativo, cada instância MongoClient abre até duas conexões por servidor em sua topologia MongoDB para monitorar o estado do servidor.

Por exemplo, um cliente conectado a um conjunto de réplicas de três nós abre seis soquetes de monitoramento. Se o aplicação usar a configuração padrão para maxPoolSize e consultar apenas o nó primário (padrão), poderá haver no máximo 106 soquetes abertos e 100 conexões no pool de conexões. Se o aplicação usar uma preferência de leitura para consultar os nós secundários, essas pools de conexões crescerão e poderá haver um total de 306 conexões, incluindo os soquetes de monitoramento abertos.

Para dar suporte a um grande número de solicitações simultâneas do MongoDB em um processo, você pode aumentar maxPoolSize.

O seguinte código cria uma instância do MongoClient com um tamanho máximo do pool de conexões de 200 especificando a opção maxPoolSize no objeto options :

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

maxConnecting

Estabelecimento de conexão com limite de taxa de pools de conexões. A opção maxConnecting determina o número de conexões que o grupo pode criar em paralelo a qualquer momento. Por exemplo, se o valor de maxConnecting for 2, a terceira solicitação que tenta fazer check-out simultâneo de uma conexão terá êxito somente quando ocorrer um dos seguintes casos:

• O pool de conexões termina de criar uma conexão e há menos de maxPoolSize conexões no pool.

• Uma conexão existente é verificada novamente no pool.

O código a seguir cria uma instância MongoClient com um número máximo de conexões 2 a serem estabelecidas simultaneamente por pool, especificando a opção maxConnecting no objeto options :

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

minPoolSize

Você pode configurar o número mínimo de conexões para cada servidor com a opção minPoolSize. O driver garante que sempre haja pelo menos o número de conexões definidas pela opção minPoolSize no pool de conexões. Se os soquetes forem fechados, fazendo com que o número total de soquetes (em uso e ociosos) caia abaixo do mínimo, mais soquetes serão abertos até que o mínimo seja atingido.

O seguinte código cria uma instância do MongoClient com um tamanho mínimo do pool de conexão de 10 especificando a opção minPoolSize no objeto options :

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

maxIdleTimeMS

Você pode definir o número máximo de milésimos de segundo em que uma conexão pode permanecer ociosa no pool definindo a opção maxIdleTimeMS. Depois que uma conexão fica inativa por maxIdleTimeMS, o pool de conexões a remove e a substitui. O padrão desta opção é 0 (sem limite).

O código a seguir cria uma instância MongoClient com um tempo ocioso máximo de 10000 milissegundos (10 segundos), especificando a configuração maxIdleTimeMS no objeto options :

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

waitQueueTimeoutMS

MongoClient suporta várias solicitações simultâneas. Para cada processo, crie um cliente e reutilize-o para todas as operações de um processo. Essa prática é mais eficiente do que criar um cliente para cada solicitação.

O driver não limita o número de solicitações que podem aguardar a disponibilidade de soquetes, e é responsabilidade do aplicativo limitar o tamanho de seu pool para limitar o enfileiramento durante um pico de carga. Os pedidos aguardam a quantidade de tempo especificada na opção waitQueueTimeoutMS, que padroniza para 0 (sem limite).

Uma solicitação que aguarda mais do que o período de tempo definido por waitQueueTimeoutMS para um soquete gera um erro de conexão. Use essa opção se for mais importante limitar a duração das operações durante um pico de carga do que concluir cada operação.

O seguinte código cria uma instância MongoClient com um tempo limite máximo da fila de espera de 10000 milésimos de segundo (10 segundos), declarando-o no objeto options :

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