eduardweb.
PostgreSQLAvansat#devops#prisma#postgresql#pgbouncer

PgBouncer în producție: Transaction vs Session, pool sizes și Prisma

De Ioana Marinescu, 8 nov. 2026 · 14 vizualizări · 3 like-uri

Postat 8 nov. 2026
prisma
datasource db {
  provider  = "postgresql"
  url       = env("DATABASE_URL")       // pgbouncer: port 6432 cu ?pgbouncer=true
  directUrl = env("DIRECT_URL")         // direct postgres: port 5432 (pentru migrații)
}

generator client {
  provider = "prisma-client-js"
}

Am bușit un Postgres în producție acum vreo patru ani doar pentru că lăsasem Prisma să gestioneze conexiunile direct dintr-un cluster de Kubernetes. Când ai 20 de pod-uri care pornesc deodată și fiecare deschide câte 10 conexiuni, Postgres începe să aloce memorie per proces până când intervine OOM killer-ul. Soluția standard este PgBouncer, dar dacă nu ești atent la pooling mode și setări, te trezești cu erori ciudate de tranzacții sau migrații blocate.

Transaction vs Session: unde se rupe filmul

PgBouncer oferă trei moduri, dar în practică te interesează două: session și transaction.

În modul session, PgBouncer alocă o conexiune fizică din Postgres clientului pe toată durata existenței conexiunii clientului. E util doar dacă vrei un proxy simplu, dar nu rezolvă mare lucru când ai sute de containere Node.js. Nu economisești conexiuni, ci doar adaugi un hop în rețea.

Modul transaction este motivul pentru care instalezi de fapt PgBouncer. Clientul primește o conexiune reală doar pe durata unei tranzacții sau a unui query individual. Imediat ce vine COMMIT sau ROLLBACK, conexiunea fizică revine în pool și deservește alt client. În felul ăsta, poți ține 3.000 de clienți activi în aplicație cu doar 30 sau 40 de conexiuni reale pe baza de date.

Trade-off-ul e direct: în modul transaction pierzi feature-urile la nivel de sesiune. Fără LISTEN / NOTIFY, fără tabele temporare care să supraviețuiască între query-uri și, cel mai important, fără prepared statements clasice dacă ORM-ul tău nu știe să lucreze cu ele pe portul de pool.

Cum calculezi pool size fără să ghicești

Cea mai frecventă greșeală pe care o văd este setarea unui default_pool_size uriaș, gen 100 sau 200, „să fie acolo”. În Postgres, fiecare conexiune deservită este un proces separat al sistemului de operare, nu un thread ușor. Dacă ai un server cu 8 vCPU-uri și pui 150 de procese să se bată pe ele, pierzi masiv timp în CPU context switching.

Formula clasică pe care o folosesc pleacă de la regula de bază: (core_count * 2) + disk_spindle_count. Pentru un server cu SSD NVMe și 8 vCPU, 20-30 de conexiuni reale sunt de obicei arhisuficiente.

La un magazin online cu vreo 12.000 cereri/minut în campanii de reduceri, am redus conexiunile reale din Postgres de la 350 (unde baza gâfâia la 95% CPU) la 45 de conexiuni gestionate de PgBouncer. Latența la p95 a scăzut de la 180ms la 32ms doar pentru că procesorul nu mai pierdea cicluri administrând memoria per backend process.

Integrarea corectă cu Prisma

Prisma generează conexiuni agresiv și încearcă să folosească prepared statements. Dacă trimiți Prisma direct într-un PgBouncer setat pe pool_mode = transaction, vei primi erori de tipul prepared statement does not exist.

Ca să funcționeze curat, ai nevoie de două lucruri în URL-ul bazei:

  1. Adaugi parametrul ?pgbouncer=true la connection string. Asta instruiește engine-ul Prisma să nu mai țină prepared statements la nivel de sesiune.
  2. Configurezi două URL-uri separate în schema.prisma: unul prin PgBouncer pentru operațiuni normale de runtime și un directUrl care bate direct în Postgres pe portul standard (5432).

Dacă uiți de directUrl, prima dată când rulezi prisma migrate deploy în pipeline-ul de CI/CD procesul va crăpa, fiindcă migrațiile au nevoie de advisory locks la nivel de sesiune ca să nu ruleze două migrații paralele.

Voi ce raport folosiți între numărul de containere din aplicație și conexiunile maxime setate în PgBouncer?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.