NOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Veja o changelog →

Desempenho · 11 minutos de leitura

PgBouncer vs Supavisor vs PgCat: qual pooler Postgres?

Affane Daylami · Fondateur · 9 de junho de 2026

Voltar ao blog

PgBouncer, Supavisor e PgCat compartilham conexões Postgres, mas não resolvem o mesmo problema. PgBouncer continua sendo o padrão histórico: leve, em C, integrado nativamente ao ecossistema Kubernetes via CloudNativePG. Supavisor foi construído por Supabase para uma necessidade específica, para manter milhares de bancos de dados atrás de um único serviço em vez de um processo por banco de dados. PgCat, escrito em Rust, acrescenta ao pooling clássico de fragmentação e balanceamento de carga entre réplicas. Em Aurabase, o tráfego do plano de dados passa por PgBouncer no modo de transação. Isso é mostrado diretamente no código do repositório: gráfico Helm, recurso CNPG Pooler e configuração local do k3d convergem para a mesma escolha.

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Este artigo compara a arquitetura dos três poolers: linguagem, modos de pooling, modelo de locatário único ou multilocatário, funções além do pooling puro. Tembo e PkgPulse publicaram comparações numéricas dessas três ferramentas, mas nós mesmos não reproduzimos nenhuma de suas medições. Nossa posição editorial sobre benchmarks, detalhada em nossa metodologia de benchmark , é nunca republicar um número que não tenhamos verificado. Em vez disso, o que você encontrará aqui: a arquitetura real de cada ferramenta e como Aurabase realmente roteia seu tráfego Postgres, verificado seção por seção no código-fonte.

O essencial
  • PgBouncer (C) continua sendo o pooler mais comprovado e melhor integrado ao Kubernetes: CloudNativePG depende diretamente dele para seu recurso Pooler.
  • Supavisor (Elixir, projeto Supabase) tem como alvo um problema diferente: atender milhares de bancos de dados do mesmo serviço, em vez de um pooler por banco de dados.
  • PgCat (Rust) adiciona fragmentação de aplicativos, balanceamento de carga entre réplicas e failover automático para pooling bruto.
  • O repositório Aurabase mostra PgBouncer usado em dois níveis: uma implantação compartilhada para a frota compartilhada e um recurso Pooler gerenciado pelo CloudNativePG por locatário dedicado. Ambos operam em modo de transação.
  • PostgREST e o pool de administraçãoaura-db permanecem voluntariamente em conexão direta com Postgres, sem passar pelo pooler: o pool de transações interromperia o recarregamento do esquema e os bloqueios de sessão.
#
panorama

Três poolers, três filosofias

PgBouncer minimiza, Supavisor pools em escala multilocatário, PgCat adiciona funções de rede ao pool bruto. Nenhum dos três substitui diretamente os outros dois, embora sejam frequentemente comparados termo por termo nas mesmas páginas.

IdiomaCElixir (FEIXE)Rust
Modos de agrupamentoSessão, transação, declaraçãoSessão, transaçãoSessão, transação, declaração
Modelo de locaçãoUm cluster de destino por instância, projetado para ser de locatário únicoMultilocatário nativo: um serviço para muitos bancos de dadosUm cluster de destino, fragmentado por chave de partição
Além do poolingSem funções adicionais, deliberadamente mínimasAPI Admin HTTP, registro dinâmico de locatárioFragmentação, balanceamento de carga e failover entre réplicas
Integração nativa do KubernetesSim: pool de recursos CloudNativePGNão documentado nativamente até o momentoNão documentado nativamente até o momento
OrigemO padrão histórico de pooling PostgresConstruído por Supabase para sua própria nuvem multilocatáriaNascido na Instacart, mantido hoje pelo PostgresML

Colunas, em ordem: PgBouncer, Supavisor, PgCat. Características da arquitetura de acordo com os registros oficiais de cada projeto, a serem confirmados na versão que você está implantando, o ecossistema evoluindo rapidamente neste ponto.

#
PgBouncer

O padrão histórico, leve e integrado ao Kubernetes

PgBouncer faz apenas uma coisa: agrupar conexões Postgres, sem quaisquer funções adicionais. Este escopo deliberadamente estreito explica em grande parte sua longevidade e sua adoção como um elemento básico na maioria das pilhas Postgres em produção.

Três modos de pooling estão disponíveis. O modo de sessão abre uma conexão de servidor por conexão de cliente, o mais permissivo. O modo transação reutiliza uma conexão de servidor entre vários clientes, liberada a cada final de uma transação. O modo de instrução vai ainda mais longe e raramente é usado na produção. É o modo de transação que traz o ganho real de pooling, mas impõe regras rígidas. Qualquer estado de sessão (variáveis ​​SET, bloqueios de aconselhamento, LISTEN/NOTIFY) não sobrevive além de uma transação. Detalhamos essas regras e suas armadilhas em nosso artigo dedicado sobre o modo de pooling de transações de PgBouncer.

Historicamente de processo único, uma instância PgBouncer usa um único núcleo de CPU por padrão. A execução de várias instâncias na mesma porta (via SO_REUSEPORT) é uma evolução mais recente do projeto, não um recurso de design inicial. No lado da autenticação, PgBouncer suporta um auth_query configurável, uma função SQL executada em cada conexão para resolver dinamicamente a senha de uma função. Este mecanismo evita depender de um arquivo estático listando previamente cada usuário. É exatamente esse mecanismo que Aurabase usa para suas funções por projeto (seção 05).

Astuce

PgBouncer é o pooler que CloudNativePG implanta nativamente por trás de seu recurso Pooler. Em um cluster Postgres gerenciado pelo operador CloudNativePG, ativar um pooler gerenciado equivale, na prática, a ativar PgBouncer sem configurá-lo manualmente.

#
Supavisor

Pooler multilocatário nativo da nuvem de Supabase

Supavisor aborda um problema que PgBouncer nunca foi projetado para resolver nesta escala. Isto envolve servir um grande número de bases de dados de inquilinos distintas a partir de um único serviço, em vez de uma instância de pooler por base de dados. Escrito em Elixir e executado na máquina virtual Erlang (BEAM), o projeto é desenvolvido e mantido por Supabase, em código aberto, em seu próprio repositório GitHub.

O modelo nativo multilocatário é a verdadeira diferença estrutural. Onde uma frota PgBouncer clássica requer um processo (ou um conjunto de conexões dedicadas) por base de destino, Supavisor funciona de maneira diferente. Ele registra locatários dinamicamente por meio de uma interface de administração HTTP e roteia cada conexão de entrada para o banco de dados correto sem reiniciar o serviço. Supabase migrou seus próprios projetos de nuvem de PgBouncer para Supavisor exatamente por esse motivo. Um cluster de pooling clássico, um por banco de dados, não pode ser dimensionado para uma nuvem multilocatário que hospeda centenas de milhares de projetos.

Esta escolha arquitetônica tem uma desvantagem documentada. A paridade de recursos com PgBouncer em casos avançados levou algum tempo para se estabilizar após o lançamento do projeto. Dois exemplos: certos comportamentos de LISTEN/NOTIFY e o gerenciamento preciso de instruções preparadas em modo de transação. Verifique sua versão antes da migração se seu aplicativo depender desses comportamentos específicos.

#
PgCat

O estranho Rust: fragmentação nativa e balanceamento de carga

PgCat é explicitamente posicionado como uma alternativa a PgBouncer, escrito em Rust. Ele adiciona funções de rede ao pooling clássico que nem PgBouncer nem Supavisor incorporam nativamente. Três em particular: fragmentação de aplicativos por chave de partição, balanceamento de carga entre réplicas de leitura e failover automático de uma réplica com falha. O projeto nasceu na Instacart antes de ser assumido e mantido hoje pelo PostgresML.

Concretamente, PgCat pode desempenhar o papel que duas camadas distintas normalmente ocupariam: um pooler de conexões e um proxy de aplicação para roteamento entre várias instâncias de Postgres. Uma equipe que já estava fragmentando seus dados manualmente pode simplificar seu código com PgCat. O mesmo vale para uma lógica de distribuição de leituras entre réplicas desenvolvida internamente: uma camada de rede dedicada a substitui diretamente.

O compromisso oposto também existe: PgCat é um projeto mais jovem, com um ecossistema de documentação e feedback de produção muito menor do que PgBouncer. Adotar as suas funções de fragmentação e failover também significa concordar em depender da maturidade deste componente específico, e não apenas da sua capacidade de agrupamento.

#
Verificado no código

O que o código Aurabase mostra: PgBouncer em todos os lugares, exceto onde o pool de transações quebra tudo

O repositório Aurabase implementa PgBouncer em duas camadas separadas, ambas em modo de transação. Para a frota compartilhada, o gráfico Helm define uma implantação PgBouncer dedicada na frente do plano de dados compartilhado (deploy/helm/aurabase/templates/infra/pgbouncer.yaml, imagem edoburu/pgbouncer). Para um locatário em uma instância dedicada, o provisionador gera um recurso Pooler gerenciado nativamente por CloudNativePG (deploy/cnpg/tenant-pooler.yaml, renderizado por k8s_tenant.rs). Nenhum dos dois usa Supavisor ou PgCat. O código não documenta uma comparação explícita que precedeu esta escolha. Por outro lado, mostra uma integração profunda e já operacional com o ecossistema CloudNativePG, consistente com o fato de que PgBouncer é o bloco de pooling nativo.

transação
MODO DE PISCINA
Frota compartilhada e pooler por inquilino dedicado
1000
CONEXÃO MÁXIMA DO CLIENTE
Teto de cliente simultâneo, padrão do gráfico Helm
80
TAMANHO PADRÃO DA PISCINA
Conexões do servidor por (base, função), gráfico Helm padrão

No entanto, nem tudo passa pelo pooler, e esta é uma escolha deliberada documentada no próprio código. PostgREST permanece conectado ao vivo a Postgres, nunca via PgBouncer. O comentário do gráfico Helm é explícito sobre o motivo: o pool de transações interromperia o recarregamento do esquema, que depende de um LISTEN no canal pgrst. Este mecanismo é incompatível com conexões de servidor recicladas entre clientes. O conjunto de administraçãoaura-db (esquema, DDL, bloqueios de aconselhamento de sessão) também permanece em conexão direta, pelo mesmo motivo básico. SET search_path sem escopo de transação e bloqueios de sessão não sobrevivem a um pooler de modo de transação.

deploy/helm/aurabase/templates/infra/pgbouncer.yaml (extrato comentado)yaml
# Plano de dados aura-db: via PgBouncer, tudo tem escopo de transação (SET LOCAL)
DATABASE_URL: postgresql://aura_authenticator:...@pgbouncer:5432/aura_db_master

# Administrador do pool (DDL, introspecção): DIRETO em Postgres, nunca PgBouncer
# SET search_path não LOCAL + bloqueios de sessão interrompem o pool de transações
ADMIN_DATABASE_URL: postgresql://aura:...@postgres:5432/aura_db_master

A autenticação segue o padrão auth_query descrito na seção 02: AUTH_QUERY: SELECT * FROM pgbouncer.user_lookup($1), sem um arquivo userlist.txt estático. Isso é o que permite que funções criadas dinamicamente por projeto (project_<uuid>_authenticator) sejam autenticadas via PgBouncer sem reimplantar o pooler para cada novo projeto.

Uma lição operacional encontrada ao escrever este artigo

O comentário de verificação de integridade PgBouncer no Kubernetes local manifesta documenta um bug real, já corrigido. Uma execução de pg_isready em PgBouncer valida apenas o handshake do proxy, nunca a conexão real com o backend Postgres que ele retransmite. PgBouncer responde “aceitando conexões” mesmo quando o backend está parado, enfileirando as solicitações. Resultado observado durante teste destrutivo: o serviço permaneceu healthy por 5 ciclos consecutivos enquanto Postgres estava inacessível. A correção substitui a verificação por uma solicitação psql verdadeira de ponta a ponta por meio do pooler, até o back-end. Resultado após correção, no mesmo teste repetido: unhealthy detectado em 7 ciclos, aproximadamente 35 segundos.

Um último detalhe, menor, mas revelador: o gráfico do Helm fixa edoburu/pgbouncer:v1.24.1-p1 por padrão, enquanto o banco k3d local usa v1.25.2-p0. Não é uma escolha arquitetônica, apenas uma pequena falta de sincronização de versão entre dois ambientes, o tipo de detalhe que uma revisão de código captura mais rápido do que uma postagem de blog. Nós documentamos como é, em vez de enfeitá-lo. Para obter detalhes sobre o particionamento de esquema que este pooler atende, consulte nosso artigo sobremulti-tenant RLS isolamento.

#
Decisão

Como escolher entre os três

Escolha PgBouncer se…

  • Cluster Postgres gerenciado por CloudNativePG ou Kubernetes em geral
  • Você quer o pooler mais comprovado e bem documentado
  • Uma base de destino por instância do pooler combina com você

Escolha Supavisor se…

  • Centenas ou milhares de bases por trás do mesmo serviço
  • Necessidade de registrar locatários dinamicamente por meio de uma API, sem reimplantação
  • Já está no ecossistema Supabase ou deseja depender dele

Escolha PgCat se…

  • Compartilhamento de aplicativos já implementado ou planejado no nível do pooler
  • Balanceamento de carga e réplica de failover sem camada de aplicação separada
  • Confortável com um projeto mais recente, menos documentado que PgBouncer

Qualquer que seja o pooler escolhido, ele não substitui o dimensionamento do próprio Postgres. O tamanho do pool e o servidor max_connections devem ser considerados juntos, não um após o outro. Um pool generoso na frente de um max_connections muito baixo simplesmente muda a saturação de um nível para outro. Nosso guia sobre ajuste max_connections detalha a fórmula de dimensionamento a ser aplicada antes de definir o tamanho do seu pool.

#
Perguntas frequentes

O que nos perguntam com mais frequência

PgBouncer e Pgpool-II, qual a diferença?+
O Pgpool-II vai além do pool de conexões: distribuição de carga entre réplicas, cache de consultas na memória, replicação de aplicativos. PgBouncer faz apenas uma coisa: conexões de pool. Isto é, em parte, o que explica por que é frequentemente escolhido como um elemento básico, complementado por outras ferramentas, se necessário, em vez de ser substituído por uma plataforma mais ampla.
Podemos usar PgBouncer com Supabase?+
Historicamente sim: Supabase confiou em PgBouncer antes de desenvolver Supavisor. Ambos permanecem apresentados em sua documentação oficial de acordo com o contexto da conexão: IPv4 direto, transação pooler, sessão pooler. Este ponto preciso evolui rapidamente, para verificar na hora de configurar um projeto.
PgCat gerencia instruções preparadas em modo de transação?+
Desde a versão 1.21, PgBouncer rastreia e prepara novamente instruções preparadas por protocolo dinamicamente no modo de transação, um comportamento documentado no próprio gráfico do Helm Aurabase. PgCat afirma suporte semelhante no lado do servidor. Não medimos nem um nem outro em condições reais de carga, portanto verifique o seu próprio tráfego antes de torná-lo um critério de seleção decisivo.
O Supavisor é de código aberto?+
Sim, o repositório é público em GitHub (supabase/supavisor). É um projeto distinto do núcleo Postgres de Supabase, escrito em Elixir, projetado desde o início para multilocatários, em vez de adaptado após o fato.
#
Em resumo

Não existe um pooler universal, apenas um bom ajuste para o seu arrendamento

PgBouncer, Supavisor e PgCat resolvem três variações do mesmo problema, não três versões da mesma ferramenta. PgBouncer continua sendo a escolha mais segura quando sua plataforma já depende de Kubernetes e CloudNativePG, ou quando você simplesmente deseja o pooler mais documentado. Supavisor torna-se relevante além de um certo número de bases servindo no mesmo serviço. PgCat vale a pena o desvio se você perder a fragmentação e o failover de réplica no nível da rede, desde que aceite a maturidade de um projeto mais jovem.

O código Aurabase mostra uma escolha consistente, não neutra: PgBouncer em modo de transação, em dois níveis, frota compartilhada e pooler CNPG por locatário dedicado. Restam duas exceções documentadas, para PostgREST e para administração de esquema. Se você quiser ver este projeto em ação e não no papel, nossa página Desempenho documenta a metodologia de medição associada.

PRONTO PARA IMPLEMENTAR?

Seu back-end em cinco minutos.

Não é necessário cartão de crédito · 500 MB grátis · 50.000 MAU