Conexões disponíveis para reutilização
Um pool de conexões é um gerenciador que mantém conexões com o banco disponíveis para empréstimo ao código da aplicação. Depois do uso, a conexão retorna ao conjunto e pode atender outra consulta ou transação, evitando abrir uma nova conexão a cada acesso.
A biblioteca controla quantas conexões podem existir e como atender as solicitações quando todas estão ocupadas. No Psycopg, o código pode aguardar numa fila até uma conexão ficar disponível. A espera termina com erro quando ultrapassa o tempo configurado para obtê-la.
O que acontece quando o pool fica ocupado
Neste exemplo didático, um pool tem no máximo duas conexões, ambas emprestadas a funções que ainda estão executando. Uma terceira função solicita acesso e aguarda a devolução de uma delas. Quando uma conexão retorna em condições de uso, essa função pode obtê-la e executar sua consulta.
Uma função que termina com erro e não devolve a conexão reduz a disponibilidade do conjunto. Você precisa conferir também os caminhos de falha. No Psycopg, usar pool.connection() num bloco with devolve a conexão ao sair desse bloco, após confirmar ou desfazer a transação aberta conforme o resultado da execução.
Aumentar o pool permite mais conexões simultâneas, mas o banco ainda precisa processar as consultas. O limite adequado depende da carga e do tempo de uso de cada conexão, que você pode acompanhar pelas estatísticas do pool.
Dúvidas frequentes
Perguntas frequentes sobre pool
- O limite do pool vale para todas as instâncias da aplicação?
- Cada pool controla o próprio conjunto. Se três instâncias mantiverem pools independentes de até dez conexões, elas poderão usar até trinta conexões ao todo, além de outros clientes do banco.
- O timeout do pool limita a duração de uma consulta?
- No Psycopg, o timeout de obtenção da conexão limita a espera por uma conexão disponível. O tempo de execução da consulta exige uma configuração própria.
- Devolver uma conexão exige encerrá-la?
- A devolução permite reutilizar a conexão e deve seguir o método da biblioteca. No Psycopg, sair do bloco de pool.connection() devolve a conexão após confirmar ou desfazer uma transação aberta.
Para continuar
Recursos relacionados
Documentação
Psycopg: pools de conexões
Explica a reutilização das conexões, a espera por disponibilidade e a devolução no Psycopg.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão ao vivo para você revisar o uso das conexões e investigar a espera pelo banco na aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você pode revisar o uso das conexões no código gerado por agentes e conferir se elas retornam ao pool após consultas e falhas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.