Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Pool de Conexões

Neste guia, você aprenderá como o driver do Kotlin Sync usa os pools de conexões para gerenciar conexões com o MongoDB deployment. Você pode especificar as configurações do pool de conexões em seu aplicação para configurar esse comportamento.

Um pool de conexões é um cache de conexões de banco de dados abertas mantidas pelo driver Kotlin Sync. Quando seu aplicação solicita uma conexão com MongoDB, o driver recupera uma conexão do pool, 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 o driver cria novas conexões.

Cada instância MongoClient tem um pool de conexões integrado para cada servidor em sua topologia do MongoDB . Se você não configurar a opção minPoolSize, os pools de conexões abrirão os soquetes sob demanda. Esses soquetes suportam operações simultâneas do MongoDB em seu aplicação.

Quando você instancia um novo MongoClient, o cliente abre dois soquetes 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, poderá haver no máximo 106 soquetes abertos e 100 conexões no pool de conexões. Se a aplicação usar uma preferência de leitura para consultar os nós secundários, pode haver um total de 306 conexões.

Por questões de eficiência, crie um cliente uma vez para cada processo e reutilize-o para todas as operações. Evite criar um novo cliente para cada solicitação, pois isso aumentará a latência.

Você pode especificar configurações para o pool de conexões usando uma string de conexão ou um objeto MongoClientSettings.

Selecione a aba Connection String ou MongoClientSettings para ver a sintaxe correspondente:

A tabela a seguir descreve as opções de pool de conexões que você pode definir em sua string de conexão:

Opção
Descrição

maxConnecting

Define o número máximo de conexões que um pool pode estabelecer simultaneamente.

Padrão: 2

maxIdleTimeMS

Define o número máximo de milissegundos que uma conexão pode permanecer inativa no pool antes de ser removida e fechada. Defina esse valor como maior que o período ocioso esperado do seu aplicativo, mas menor que o tempo limite de conexão do firewall ou do proxy para evitar desconexões inesperadas.

Padrão: 0

maxPoolSize

Define o número máximo de conexões que podem ser abertas em um pool. Se uma operação precisar de uma nova conexão enquanto o pool de conexões tiver o número máximo de conexões abertas, a operação aguardará a abertura de uma nova conexão. Para limitar esse tempo de espera, use a configuração de tempo limite único. Para saber mais, consulte o guia Limitar o tempo de execução do servidor.

Padrão: 100

minPoolSize

Define o número mínimo de conexões que podem ser abertas em um pool. O valor de minPoolSize deve ser menor que o valor de maxPoolSize.

Padrão: 0

maxLifeTimeMS

Define a quantidade máxima de tempo, em milissegundos, o driver pode continuar a usar uma pool de conexão antes de fechar a conexão. Um valor de 0 indica que não há limite superior de quanto tempo o driver pode manter uma pool de conexão aberta.

Padrão: 0

Para saber mais sobre essas opções, consulte a documentação da API ConnectionString.

O exemplo a seguir mostra como criar um pool de conexões que tenha tamanho máximo de 50 conexões.

Selecione a aba Connection String ou MongoClientSettings para ver a sintaxe correspondente:

val uri = "mongodb://<host>:<port>/?maxPoolSize=50"val client = MongoClient.create(uri)

Para saber mais sobre como usar um pool de conexões, consulte Visão geral do pool de conexões no manual do MongoDB Server.