NUEVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Ver el registro de cambios →

Rendimiento · 11 lectura mínima

PgBouncer vs Supavisor vs PgCat: ¿qué agrupador Postgres?

Affane Daylami · Fondateur · 9 de junio de 2026

volver al blog

PgBouncer, Supavisor y PgCat comparten conexiones Postgres, pero no solucionan el mismo problema. PgBouncer sigue siendo el estándar histórico: liviano, en C, integrado de forma nativa en el ecosistema de Kubernetes a través de CloudNativePG. Supavisor fue creado por Supabase para una necesidad específica: contener miles de bases de datos detrás de un único servicio en lugar de un proceso por base de datos. PgCat, escrito en Rust, se suma a la agrupación clásica de fragmentación y equilibrio de carga entre réplicas. En Aurabase, el tráfico del plano de datos pasa por PgBouncer en modo de transacción. Esto se muestra directamente en el código del repositorio: el gráfico de Helm, el recurso CNPG Pooler y la configuración local de k3d convergen hacia la misma elección.

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Este artículo compara la arquitectura de los tres agrupadores: lenguaje, modos de agrupación, modelo de inquilino único o múltiple y funciones más allá de la agrupación pura. Tembo y PkgPulse han publicado comparaciones numéricas de estas tres herramientas, pero nosotros no hemos reproducido ninguna de sus mediciones. Nuestra posición editorial sobre los puntos de referencia, detallada en nuestra metodología de puntos de referencia , es nunca volver a publicar una cifra que no hayamos verificado nosotros mismos. Lo que encontrará aquí en su lugar: la arquitectura real de cada herramienta y cómo Aurabase realmente enruta su tráfico Postgres, verificado sección por sección en el código fuente.

Lo esencial
  • PgBouncer (C) sigue siendo el pooler más probado y mejor integrado con Kubernetes: CloudNativePG depende directamente de él para su recurso Pooler.
  • Supavisor (Elixir, proyecto Supabase) aborda un problema diferente: servir miles de bases de datos desde el mismo servicio, en lugar de un agrupador por base de datos.
  • PgCat (Rust) agrega fragmentación de aplicaciones, equilibrio de carga entre réplicas y conmutación por error automática a la agrupación sin formato.
  • El repositorio Aurabase muestra PgBouncer usado en dos niveles: una implementación compartida para la flota compartida y un recurso Pooler administrado por CloudNativePG por inquilino dedicado. Ambos operan en modo transacción.
  • PostgREST y el grupo de administraciónaura-db permanecen voluntariamente en conexión directa con Postgres, sin pasar por el grupo: el grupo de transacciones rompería la recarga de su esquema y los bloqueos de sesión.
#
Panorámica

Tres poolers, tres filosofías

PgBouncer minimiza, Supavisor agrupa en una escala de múltiples inquilinos, PgCat agrega funciones de red a la agrupación sin formato. Ninguno de los tres reemplaza directamente a los otros dos, aunque a menudo se comparan término por término en las mismas páginas.

IdiomaCElixir (HAGA)Rust
Modos de agrupaciónSesión, transacción, declaraciónSesión, transacciónSesión, transacción, declaración
Modelo de arrendamientoUn clúster de destino por instancia, diseñado para ser de un solo inquilinoMultiinquilino nativo: un servicio para muchas bases de datosUn clúster de destino, fragmentación por clave de partición
Más allá de la agrupaciónSin funciones adicionales, deliberadamente mínimasAPI HTTP de administrador, registro dinámico de inquilinosFragmentación, equilibrio de carga y conmutación por error entre réplicas
Integración nativa de KubernetesSí: agrupador de recursos CloudNativePGNo documentado de forma nativa hasta la fechaNo documentado de forma nativa hasta la fecha
OrigenEl estándar histórico de agrupación PostgresCreado por Supabase para su propia nube multiinquilinoNacido en Instacart, mantenido hoy por PostgresML

Columnas, en orden: PgBouncer, Supavisor, PgCat. Características de la arquitectura según las presentaciones oficiales de cada proyecto, a confirmar en la versión que se esté implementando, el ecosistema evoluciona rápidamente en este punto.

#
PgBouncer

El estándar histórico, ligero e integrado en Kubernetes

PgBouncer solo hace una cosa: agrupar conexiones Postgres, sin funciones adicionales. Este alcance deliberadamente limitado explica en gran medida su longevidad y su adopción como componente básico en la mayoría de las pilas Postgres en producción.

Hay tres modos de agrupación disponibles. El modo de sesión abre una conexión de servidor por conexión de cliente, la más permisiva. El modo de transacción reutiliza una conexión de servidor entre varios clientes, liberada en cada extremo de una transacción. El modo declaración va aún más allá y rara vez se utiliza en producción. Es el modo de transacción el que genera la ganancia real de la agrupación, pero impone reglas estrictas. Cualquier estado de sesión (variables SET, bloqueos de aviso, LISTEN/NOTIFY) no sobrevive más allá de una transacción. Detallamos estas reglas y sus dificultades en nuestro artículo dedicado al modo de agrupación de transacciones de PgBouncer.

Históricamente, una instancia de proceso único, PgBouncer utiliza un único núcleo de CPU de forma predeterminada. La ejecución de varias instancias detrás del mismo puerto (a través de SO_REUSEPORT) es una evolución más reciente del proyecto, no una característica de diseño inicial. En el lado de la autenticación, PgBouncer admite una auth_query configurable, una función SQL ejecutada en cada conexión para resolver dinámicamente la contraseña de un rol. Este mecanismo evita depender de un archivo estático que enumera a cada usuario de antemano. Es exactamente este mecanismo el que Aurabase utiliza para sus funciones por proyecto (sección 05).

Astucia

PgBouncer es el pooler que CloudNativePG implementa de forma nativa detrás de su recurso Pooler. En un clúster Postgres administrado por el operador CloudNativePG, activar un pooler administrado equivale, en la práctica, a activar PgBouncer sin configurarlo manualmente.

#
Supavisor

Pooler multiinquilino nativo de la nube de Supabase

Supavisor aborda un problema que PgBouncer nunca fue diseñado para resolver a esta escala. Esto implica servir a una gran cantidad de bases de datos de inquilinos distintas desde un único servicio, en lugar de una instancia de agrupación por base de datos. Escrito en Elixir y ejecutado en la máquina virtual Erlang (BEAM), el proyecto es desarrollado y mantenido por Supabase, en código abierto, en su propio repositorio GitHub.

El modelo nativo multiinquilino es la verdadera diferencia estructural. Mientras que una flota clásica PgBouncer requiere un proceso (o un conjunto de conexiones dedicadas) por base de destino, Supavisor funciona de manera diferente. Registra dinámicamente a los inquilinos a través de una interfaz de administración HTTP y enruta cada conexión entrante a la base de datos correcta sin reiniciar el servicio. Supabase migró sus propios proyectos en la nube de PgBouncer a Supavisor por esta misma razón. Un clúster de agrupación clásico, uno por base de datos, no se adapta a una nube multiinquilino que aloja cientos de miles de proyectos.

Esta elección arquitectónica tiene una desventaja documentada. La paridad de funciones con PgBouncer en casos avanzados tardó en estabilizarse después del lanzamiento del proyecto. Dos ejemplos: ciertos comportamientos de LISTEN/NOTIFY y la gestión fina de declaraciones preparadas en modo transacción. Verifique su versión antes de la migración si su aplicación depende de estos comportamientos específicos.

#
PgCat

El forastero Rust: fragmentación nativa y equilibrio de carga

PgCat se posiciona explícitamente como una alternativa a PgBouncer, escrito en Rust. Agrega funciones de red a la agrupación clásica que ni PgBouncer ni Supavisor incorporan de forma nativa. Tres en particular: fragmentación de aplicaciones por clave de partición, equilibrio de carga entre réplicas de lectura y conmutación por error automática lejos de una réplica fallida. El proyecto nació en Instacart antes de ser asumido y mantenido hoy por PostgresML.

Concretamente, PgCat puede desempeñar el papel que normalmente ocuparían dos capas distintas: un agrupador de conexiones y un proxy de aplicación para enrutar entre varias instancias Postgres. Un equipo que ya estaba fragmentando sus datos a mano puede simplificar su código con PgCat. Lo mismo ocurre con una lógica para distribuir lecturas entre réplicas desarrollada internamente: una capa de red dedicada la reemplaza directamente.

También existe el compromiso opuesto: PgCat es un proyecto más joven, con un ecosistema de documentación y comentarios de producción mucho más pequeño que PgBouncer. Adoptar sus funciones de fragmentación y conmutación por error también significa aceptar depender de la madurez de este componente específico, no solo de su capacidad de agrupación.

#
Comprobado en código

Lo que muestra el código Aurabase: PgBouncer en todas partes, excepto donde la agrupación de transacciones rompe todo

El repositorio Aurabase implementa PgBouncer en dos niveles separados, ambos en modo de transacción. Para la flota compartida, el gráfico Helm define una implementación PgBouncer dedicada frente al plano de datos compartido (deploy/helm/aurabase/templates/infra/pgbouncer.yaml, imagen edoburu/pgbouncer). Para un inquilino en una instancia dedicada, el aprovisionador genera un recurso Pooler administrado de forma nativa por CloudNativePG (deploy/cnpg/tenant-pooler.yaml, representado por k8s_tenant.rs). Ninguno usa Supavisor o PgCat. El código no documenta una comparación explícita que precedió a esta elección. Por otro lado, muestra una integración profunda y ya operativa con el ecosistema CloudNativePG, consistente con el hecho de que PgBouncer es el bloque de agrupación nativo.

transacción
MODO PISCINA
Flota compartida y pooler por inquilino dedicado
1000
CONEXIÓN MÁXIMA DEL CLIENTE
Límite de cliente simultáneo, gráfico de Helm predeterminado
80
TAMAÑO DE PISCINA PREDETERMINADO
Conexiones de servidor por (base, rol), gráfico de Helm predeterminado

Sin embargo, no todo pasa por el pooler, y esta es una elección deliberada documentada en el propio código. PostgREST permanece conectado en vivo a Postgres, nunca a través de PgBouncer. El comentario del gráfico Helm es explícito sobre el motivo: la agrupación de transacciones interrumpiría la recarga del esquema, que depende de un LISTEN en el canal pgrst. Este mecanismo es incompatible con conexiones de servidor recicladas entre clientes. El grupo de administraciónaura-db (esquema, DDL, bloqueos de aviso de sesión) también permanece en conexión directa, por la misma razón básica. Los SET search_path sin ámbito de transacción y los bloqueos de sesión no sobreviven a un agrupador en modo de transacción.

deploy/helm/aurabase/templates/infra/pgbouncer.yaml (comentario extraído)yaml
# Plano de datos aura-db: a través de PgBouncer, todo tiene un alcance de transacción (SET LOCAL)
DATABASE_URL: postgresql://aura_authenticator:...@pgbouncer:5432/aura_db_master

# Administrador del grupo (DDL, introspección): DIRECTO en Postgres, nunca PgBouncer
# SET search_path no LOCAL + bloqueos de sesión interrumpen la agrupación de transacciones
ADMIN_DATABASE_URL: postgresql://aura:...@postgres:5432/aura_db_master

La autenticación sigue el patrón auth_query descrito en la sección 02: AUTH_QUERY: SELECT * FROM pgbouncer.user_lookup($1), sin un archivo userlist.txt estático. Esto es lo que permite que los roles creados dinámicamente por proyecto (project_<uuid>_authenticator) se autentiquen a través de PgBouncer sin volver a implementar el pooler para cada nuevo proyecto.

Una lección operativa encontrada al escribir este artículo.

El comentario de comprobación de estado PgBouncer en los manifiestos locales de Kubernetes documenta un error real, ya solucionado. Una ejecución de pg_isready contra PgBouncer solo valida el protocolo de enlace del proxy, nunca la conexión real al backend Postgres que transmite. PgBouncer responde "aceptando conexiones" incluso cuando el backend está detenido, poniendo en cola las solicitudes. Resultado observado durante una prueba destructiva: el servicio permaneció healthy durante 5 ciclos consecutivos mientras que Postgres estaba inalcanzable. La solución reemplaza la verificación con una verdadera solicitud psql de un extremo a otro a través del pooler, hasta el backend. Resultado después de la corrección, en la misma prueba reproducida: unhealthy detectado en 7 ciclos, aproximadamente 35 segundos.

Un último detalle, menor pero revelador: el gráfico Helm fija edoburu/pgbouncer:v1.24.1-p1 de forma predeterminada, mientras que el banco k3d local usa v1.25.2-p0. No es una elección arquitectónica, sólo una ligera falta de sincronización de versiones entre dos entornos, el tipo de detalle que una revisión de código capta más rápido que una publicación de blog. Lo documentamos tal como es en lugar de disfrazarlo. Para obtener detalles sobre la partición del esquema que ofrece este agrupador, consulte nuestro artículo sobreaislamiento multiinquilino RLS.

#
decisión

Cómo elegir entre los tres

Elija PgBouncer si...

  • Clúster Postgres administrado por CloudNativePG o Kubernetes en general
  • Quiere el pooler más probado y mejor documentado
  • Una base de objetivos por instancia de pooler le conviene

Elija Supavisor si...

  • Cientos o miles de bases detrás de un mismo servicio
  • Necesidad de registrar inquilinos dinámicamente a través de una API, sin redistribución
  • Ya estás en el ecosistema Supabase o estás dispuesto a depender de él.

Elija PgCat si...

  • El uso compartido de aplicaciones ya está implementado o planificado a nivel del pooler
  • Equilibrio de carga y réplica de conmutación por error sin capa de aplicación separada
  • Cómodo con un proyecto más joven, menos documentado que PgBouncer

Cualquiera que sea el pooler elegido, no reemplaza el tamaño del propio Postgres. El tamaño del grupo y el servidor max_connections deben considerarse juntos, no uno tras otro. Un grupo generoso frente a un max_connections demasiado bajo simplemente cambia la saturación de un nivel a otro. Nuestra guía sobre ajuste de max_connections detalla la fórmula de tamaño que se debe aplicar antes de configurar el tamaño de su piscina.

#
Preguntas frecuentes

Lo que más nos preguntan

PgBouncer y Pgpool-II, ¿cuál es la diferencia?+
Pgpool-II va más allá de la agrupación de conexiones: distribución de carga entre réplicas, caché de consultas en memoria, replicación de aplicaciones. PgBouncer solo hace una cosa: conexiones de grupo. Esto es en parte lo que explica por qué a menudo se elige como un componente básico, complementado con otras herramientas si es necesario, en lugar de reemplazarlo por una plataforma más amplia.
¿Podemos usar PgBouncer con Supabase?+
Históricamente sí: Supabase confió en PgBouncer antes de desarrollar Supavisor. Ambos permanecen presentados en su documentación oficial según el contexto de conexión: IPv4 directo, transacción de pooler, sesión de pooler. Este punto concreto evoluciona rápidamente, para comprobarlo a la hora de configurar un proyecto.
¿PgCat gestiona extractos preparados en modo transacción?+
Desde la versión 1.21, PgBouncer rastrea y vuelve a preparar declaraciones preparadas por protocolo sobre la marcha en modo de transacción, un comportamiento documentado en el propio gráfico de Helm Aurabase. PgCat afirma tener soporte similar del lado del servidor. No hemos medido ni uno ni otro en condiciones de carga reales, así que compruebe su propio tráfico antes de convertirlo en un criterio decisivo de selección.
¿Supavisor es de código abierto?+
Sí, el repositorio es público en GitHub (supabase/supavisor). Es un proyecto distinto del núcleo Postgres de Supabase, escrito en Elixir, diseñado desde el principio para múltiples inquilinos en lugar de adaptado después del hecho.
#
En resumen

No existe un pooler universal, solo uno que se adapta bien a su arrendamiento

PgBouncer, Supavisor y PgCat resuelven tres variaciones del mismo problema, no tres versiones de la misma herramienta. PgBouncer sigue siendo la opción más segura cuando su plataforma ya depende de Kubernetes y CloudNativePG, o cuando simplemente desea el pooler más documentado. Supavisor se vuelve relevante más allá de un cierto número de bases que prestan servicios desde el mismo servicio. PgCat vale la pena desviarse si omite la fragmentación y la conmutación por error de réplica a nivel de red, siempre que acepte la madurez de un proyecto más joven.

El código Aurabase muestra una elección consistente, no neutral: PgBouncer en modo de transacción, en dos niveles, flota compartida y CNPG agrupador por inquilino dedicado. Quedan dos excepciones documentadas, para PostgREST y para la administración de esquemas. Si desea ver este proyecto aislado en acción en lugar de en papel, nuestra página Rendimiento documenta la metodología de medición asociada.

¿LISTO PARA IMPLEMENTAR?

Su backend en cinco minutos.

No se requiere tarjeta de crédito · 500 MB gratis · 50,000 MAU