0Pricing
SQL Academy · Lekcja

Pula połączeń: PgBouncer

Uruchamiać PgBouncer w trybie puli transakcyjnej, poprawnie dobierać rozmiar puli i unikać pułapki prepared statements

Pula połączeń: PgBouncer to bezpłatna lekcja SQL Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej SQL Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs SQL Academy zawiera 4 lekcji w sumie.

Dlaczego warto korzystać z puli połączeń

Każde połączenie z Postgres jest osobnym procesem systemu operacyjnego, który intensywnie wykorzystuje pamięć i procesor. Aplikacje otwierające i zamykające połączenie przy każdym żądaniu szybko wyczerpują zasoby serwera. Pula połączeń ponownie wykorzystuje niewielki zestaw długotrwałych połączeń.

Koszt pojedynczego połączenia

Typowy proces backendu Postgresa zużywa 5–10 MB pamięci RAM. 500 połączeń to około 5 GB RAM przeznaczonego tylko na procesy backendu. PgBouncer może multipleksować tysiące klientów za pomocą 50 połączeń backendu.

Trzy tryby puli połączeń

  • Sesja — klient otrzymuje dedykowane połączenie na czas całej sesji
  • Transakcja — klient otrzymuje połączenie dla każdej transakcji
  • Instrukcja — połączenie dla każdej instrukcji (używany rzadko)

Tryb transakcji (zalecany)

Każda transakcja otrzymuje połączenie z serwerem. Ten sam klient może korzystać z różnych połączeń w kolejnych transakcjach.

# pgbouncer.ini
[databases]
mydb = host=primary port=5432 dbname=mydb

[pgbouncer]
pool_mode = transaction
listen_port = 6432
max_client_conn = 1000
default_pool_size = 50

Ograniczenia trybu transakcji

Funkcje wymagające stanu sesji przestają działać:

  • Przygotowane instrukcje (wymagają tego samego backendu przy kolejnych wywołaniach)
  • SET LOCAL ... (ustawienie dla jednej transakcji jest prawidłowe; SET ... zachowujące wartość między transakcjami już nie)
  • LISTEN / NOTIFY (wymagają trwałego połączenia)
  • Kursory działające dłużej niż jedna transakcja

Tryb sesji

Należy go użyć, gdy tryb transakcji powoduje problemy w aplikacji — trzeba jednak liczyć się z mniejszą liczbą jednoczesnych klientów.

Dobieranie rozmiaru puli

Praktyczna zasada: default_pool_size ≈ vCPU count × 2 + spindles. Zbyt duża pula oznacza, że przełączanie kontekstu ogranicza przepustowość; zbyt mała powoduje oczekiwanie na dostęp do puli.

PgBouncer przed HAProxy

Typowy stos produkcyjny:

App → HAProxy (read/write routing) → PgBouncer (pooling) → Postgres

Przygotowane instrukcje w trybie transakcji

Nowsze wersje PgBouncer (1.21+) obsługują przygotowane instrukcje na poziomie protokołu w trybie transakcji. W starszych wersjach należy używać prostych zapytań lub trybu sesji.

Monitorowanie PgBouncer

Należy połączyć się z bazą administracyjną (specjalną bazą danych):

psql -p 6432 -U pgbouncer pgbouncer

-- Commands:
SHOW STATS;
SHOW POOLS;
SHOW CLIENTS;
SHOW SERVERS;

Alternatywy

  • pgpool-II — pula połączeń, równoważenie obciążenia i przepisywanie zapytań
  • Odyssey — pooler firmy Yandex, wielowątkowy
  • Pule po stronie sterownika — zwykle używane razem z PgBouncerem do obsługi puli w całym klastrze

Pula aplikacji i PgBouncer

Aplikacje zwykle mają własną pulę połączeń (HikariCP, pgxpool) ORAZ korzystają z PgBouncera. Jest to pula dwuwarstwowa — pula aplikacji utrzymuje połączenia z brokerem, a broker multipleksuje je na połączenia z Postgres.

Podsumowanie

PgBouncer jest niezbędny przy każdej większej skali.

  • Tryb transakcji jest standardem
  • Należy uważać na przygotowane instrukcje, SET i LISTEN
  • Rozmiar puli powinien wynosić około vCPU × 2
  • Należy monitorować ją za pomocą SHOW POOLS

Szybkie sprawdzenie

Który tryb PgBouncera multipleksuje najwięcej klientów przy najmniejszej liczbie połączeń z serwerem?

Często zadawane pytania

Czy lekcja „Pula połączeń: PgBouncer” jest bezpłatna?

Tak — pełny tekst „Pula połączeń: PgBouncer” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu SQL Academy, przejdź na CoddyKit PRO. Kurs SQL Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Pula połączeń: PgBouncer”?

Uruchamiać PgBouncer w trybie puli transakcyjnej, poprawnie dobierać rozmiar puli i unikać pułapki prepared statements Ćwiczysz SQL Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć SQL Academy?

Nie wymagamy żadnego doświadczenia. SQL Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Pula połączeń: PgBouncer”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji SQL Academy?

Tak. Każda lekcja SQL Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. pg_stat_statements: najważniejsze zapytania
  2. pgBadger do analizy logów
  3. Pula połączeń: PgBouncer
  4. Planowanie pojemności i audyty bloatu
← Powrót do SQL Academy