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.
- 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
Pooleradministrado por CloudNativePG por inquilino dedicado. Ambos operan en modo transacción. - PostgREST y el grupo de administración
aura-dbpermanecen 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.
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.
| Idioma | C | Elixir (HAGA) | Rust |
|---|---|---|---|
| Modos de agrupación | Sesión, transacción, declaración | Sesión, transacción | Sesión, transacción, declaración |
| Modelo de arrendamiento | Un clúster de destino por instancia, diseñado para ser de un solo inquilino | Multiinquilino nativo: un servicio para muchas bases de datos | Un clúster de destino, fragmentación por clave de partición |
| Más allá de la agrupación | Sin funciones adicionales, deliberadamente mínimas | API HTTP de administrador, registro dinámico de inquilinos | Fragmentación, equilibrio de carga y conmutación por error entre réplicas |
| Integración nativa de Kubernetes | Sí: agrupador de recursos CloudNativePG | No documentado de forma nativa hasta la fecha | No documentado de forma nativa hasta la fecha |
| Origen | El estándar histórico de agrupación Postgres | Creado por Supabase para su propia nube multiinquilino | Nacido 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.
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).
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.
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.
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.
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.
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.
# 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.
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.
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.
Lo que más nos preguntan
PgBouncer y Pgpool-II, ¿cuál es la diferencia?+
¿Podemos usar PgBouncer con Supabase?+
¿PgCat gestiona extractos preparados en modo transacción?+
¿Supavisor es de código abierto?+
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.