Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é pool?

    Um pool de conexões gerencia conexões reutilizáveis com o banco. O código obtém uma conexão, usa-a e a devolve ao conjunto para atender novas consultas.

    Também chamado de: connection pool, pool de conexões

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano