datasource db {
provider = "postgresql"
// Conexiunea prin PgBouncer pentru query-urile normale ale aplicației
url = env("DATABASE_URL") // postgres://user:pass@pgbouncer:6432/app?pgbouncer=true&connection_limit=1
// Conexiunea directă fără proxy, folosită EXCLUSIV pentru prisma migrate
directUrl = env("DIRECT_URL") // postgres://user:pass@postgres:5432/app
}Dacă pui Prisma peste PostgreSQL într-o arhitectură cu containere scalabile sau serverless, o să-ți lovești baza în genunchi mai repede decât crezi. Am pățit asta pe un sistem cu vreo 12.000 de utilizatori activi zilnic: la fiecare spike de trafic, pod-urile de Kubernetes deschideau zeci de conexiuni noi până când PostgreSQL crăpa glorios cu sorry, too many clients already.
Soluția clasică este PgBouncer. Doar că între teorie și un setup stabil în producție sunt câteva pietre de care te împiedici sigur dacă nu le-ai mai văzut.
Transaction vs Session: alege corect de la început
PgBouncer știe trei moduri, dar în practică te interesează doar două:
- Session pooling: clientul primește o conexiune la PostgreSQL și o ține ocupată până când își închide propriul socket. Pentru microservicii sau serverless e complet inutil. Ai 200 de containere idle? Ai 200 de conexiuni ocupate în Postgres fără să execute un rând de SQL.
- Transaction pooling: PgBouncer îi dă clientului o conexiune fizică doar pe durata unei tranzacții. În secunda în care ai dat
COMMITsauROLLBACK, conexiunea se întoarce în pool pentru alt request.
În proiectul respectiv am trecut direct pe transaction mode. Am coborât de la 380 de conexiuni deschise permanent la un pool de doar 20 de conexiuni reale pe baza de date.
Trade-off-ul? În transaction pooling pierzi suportul nativ pentru LISTEN/NOTIFY, comenzi temporare de tip SET timezone, și cel mai dureros pentru ORM-uri: prepared statements. Dacă lași setările default, o să vezi erori de tip prepared statement "s0" already exists pe bandă rulantă.
Cum calculezi pool size fără să ghicești
Mulți dev seniors pe care îi știu cad în capcana de a pune default_pool_size = 100 în pgbouncer.ini. E greșit.
Postgres gestionează fiecare conexiune ca pe un proces separat în Linux, nu ca pe un thread. 100 de conexiuni active simultan care rulează query-uri grele o să satureze CPU-ul cu context switching. Formula clasică recomandată chiar de echipa PostgreSQL pentru pool-ul fizic este:
conexiuni_reale = (numar_nuclee_cpu * 2) + spindle_count
Pe un nod cu 8 vCPU și SSD (spindle_count = 1), nu vrei mai mult de 17-25 de conexiuni reale deschise către serverul Postgres (default_pool_size = 20). În schimb, la nivel de clienți în PgBouncer (max_client_conn), poți urca liniștit la 2.000 sau 5.000. PgBouncer ține acele conexiuni în memorie cu un cost infim (câțiva KB per client) și trimite query-urile către Postgres doar când e liber un slot din cele 20. Latency-ul a crescut insesizabil (sub 1.2ms per query), dar utilizarea procesorului pe Postgres a coborât de la 85% la 25%.
Trucul esențial pentru Prisma
Ca să folosești Prisma cu PgBouncer în transaction mode, ai obligatoriu nevoie de două lucruri:
- parametrul
?pgbouncer=truela finalul string-ului de conexiune (care forțează Prisma să nu folosească prepared statements la nivel de protocol); - două URL-uri separate în
schema.prisma. Unul care trece prin PgBouncer (pe portul 6432) pentru aplicația propriu-zisă, și undirectUrlcare bate direct în Postgres (portul 5432) pentru comenzi DDL.
Dacă încerci să rulezi prisma migrate deploy prin PgBouncer în mod transaction, migrația va eșua mizerabil pentru că DDL-ul are nevoie de session locking.
Voi ce folosiți când scalați instanțele de Node.js: PgBouncer de sine stătător, RDS Proxy sau ați lăsat logica de pooling în seama driverului?