Gerencie conexões com pools de conexões

Visão geral

Neste guia, você aprenderá como o driver Ruby usa pools de conexões para gerenciar conexões com o MongoDB deployment e como definir as configurações de pool de conexões em seu aplicação.

Um pool de conexões é um cache de conexões de banco de dados abertas mantidas pelo driver Ruby. Quando seu aplicação solicita uma conexão com o MongoDB, o driver obtém uma conexão do pool sem problemas, executa operações e retorna a conexão ao pool para reutilização.

Os pools de conexões ajudam a reduzir a latência de aplicação e o número de vezes que novas conexões são criadas pelo driver Ruby.

Configurar pools de conexões

Cada instância Mongo::Client tem um pool de conexões integrado para cada servidor em sua topologia do MongoDB . Se você não configurar a opção min_pool_size, os pools de conexões abrirão conexões sob demanda para oferecer suporte a solicitações simultâneas ao MongoDB em seu aplicação.

Você pode especificar as seguintes configurações do pool de conexões na sua instância do Mongo::Client:

require 'mongo'
uri = "<connection-string>"
client = Mongo::Client(uri, {
    max_pool_size: 200
})

require 'mongo'
uri = "<connection-string>"
client = Mongo::Client(uri, {
    max_connecting: 2
})

require 'mongo'
uri = "<connection-string>"
client = Mongo::Client(uri, {
    min_pool_size: 10
})

require 'mongo'
uri = "<connection-string>"
client = Mongo::Client(uri, {
    max_idle_time: 10000
})

Fechando conexões

Quando qualquer solicitação chama Mongo::Client.close(), o driver Ruby executa as seguintes ações:

• Fecha todas as conexões ociosas no pool de conexões

• Fecha todas as conexões que estão em uso à medida que são retornadas ao pool

• Fecha todas as conexões que estão em uso somente quando as operações associadas são concluídas

A chamada de Mongo::Client.close() fecha apenas conexões inativas e não encerra diretamente nenhuma operação em andamento.

Evitar tempos limite de conexão

Ter um grande pool de conexões nem sempre reduz as solicitações de reconexão. Considere o seguinte cenário de exemplo :

• Um aplicação tem um tamanho de pool de conexões de 5 conexões e tem a opção timeout_ms definida para 5000 milissegundos.

• As operações ocorrem, em média, a cada 3000 milésimos de segundo, e as solicitações de reconexão são frequentes.

• Cada conexão atinge o tempo limite após 5000 milésimos de segundo, o que significa que todas as conexões devem fazer algo durante esses 5000 milésimos de segundo para evitar o fechamento.

Nesse cenário, cada conexão atinge o tempo limite após 5000 milissegundos, exigindo atividade dentro desse período de tempo limite para evitar o fechamento. No entanto, uma mensagem a cada 3000 milésimos de segundo não é suficiente para manter todas as conexões ativas, fazendo com que várias delas expirem.

Para evitar tempos limite excessivos de conexão, reduza o número de conexões que o driver pode manter no pool de conexões especificando a opção max_pool_size. Para saber como definir a opção max_pool_size, consulte a seção max_pool_size deste guia.

Documentação da API

Para obter mais informações sobre como criar um objeto Mongo::Client com o driver Ruby e especificar opções, consulte a seção Hash de opções da documentação da API Mongo::Client.