0Pricing
SQL Academy · 강의

연결 풀링: PgBouncer

PgBouncer를 트랜잭션 풀링 모드로 실행하고 풀 크기를 올바르게 설정하며 준비된 문 사용으로 인한 함정을 피해보세요.

연결 풀링: PgBouncer은(는) CoddyKit의 무료 SQL Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 SQL Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. SQL Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

연결을 풀링하는 이유

PostgreSQL 연결 하나마다 별도의 OS 프로세스가 생성되므로 메모리와 CPU를 많이 사용합니다. 요청마다 연결을 열고 닫는 애플리케이션은 서버의 리소스를 빠르게 고갈시킵니다. 풀링을 사용하면 소수의 오래 유지되는 연결을 재사용할 수 있습니다.

연결별 비용

일반적인 PostgreSQL 백엔드는 5~10MB의 RAM을 사용합니다. 연결 500개는 백엔드만으로 약 5GB의 RAM을 사용합니다. PgBouncer를 사용하면 수천 개의 클라이언트를 백엔드 연결 50개에 다중화할 수 있습니다.

세 가지 풀링 모드

  • Session — 클라이언트가 전체 세션 동안 전용 연결을 사용
  • Transaction — 클라이언트가 트랜잭션마다 연결을 사용
  • Statement — 문마다 연결을 사용(거의 사용하지 않음)

트랜잭션 모드(권장)

각 트랜잭션은 서버 연결 하나를 사용합니다. 동일한 클라이언트가 트랜잭션마다 서로 다른 연결을 사용할 수 있습니다.

# 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

트랜잭션 모드의 주의 사항

세션 상태가 필요한 기능은 작동하지 않습니다.

  • 준비된 문(호출 간에 동일한 백엔드가 필요함)
  • SET LOCAL ...(트랜잭션별 설정은 괜찮지만, 트랜잭션 사이에도 유지되는 SET ...은 사용할 수 없음)
  • LISTEN / NOTIFY(지속적인 연결이 필요함)
  • 트랜잭션보다 오래 유지되는 커서

세션 모드

트랜잭션 모드로 애플리케이션이 작동하지 않을 때 사용하십시오. 단, 동시에 연결할 수 있는 클라이언트 수가 줄어듭니다.

풀 크기 설정

일반적인 기준: default_pool_size ≈ vCPU count × 2 + spindles. 너무 크면 컨텍스트 전환으로 처리량이 떨어지고, 너무 작으면 풀이 비기를 기다리게 됩니다.

HAProxy 앞에 PgBouncer 배치하기

일반적인 운영 환경 스택:

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

트랜잭션 모드에서 준비된 문 사용하기

최신 PgBouncer(1.21 이상)는 트랜잭션 모드에서 프로토콜 수준의 준비된 문을 지원합니다. 이전 버전에서는 단순 쿼리 또는 세션 모드를 사용하십시오.

PgBouncer 모니터링

관리자 데이터베이스(특수 데이터베이스)에 연결하십시오.

psql -p 6432 -U pgbouncer pgbouncer

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

대안

  • pgpool-II — 풀링 + 부하 분산 + 쿼리 재작성
  • Odyssey — Yandex의 풀러, 다중 스레드 지원
  • 드라이버 측 풀 — 일반적으로 클러스터 전체의 풀링을 위해 PgBouncer와 함께 사용

애플리케이션 풀과 PgBouncer

애플리케이션은 일반적으로 자체 연결 풀(HikariCP, pgxpool)을 실행하면서 PgBouncer를 거칩니다. 두 계층의 풀링입니다. 애플리케이션 풀은 bouncer로 연결을 유지하고, bouncer는 이를 PostgreSQL 연결에 다중화합니다.

요약

상당한 규모의 환경에서는 PgBouncer가 필수입니다.

  • 트랜잭션 모드가 표준입니다.
  • 준비된 문, SET, LISTEN에 주의하십시오.
  • 풀 크기는 약 vCPU × 2입니다.
  • SHOW POOLS로 모니터링하십시오.

빠른 확인

가장 적은 서버 연결로 가장 많은 클라이언트를 다중화하는 PgBouncer 모드는 무엇일까요?

자주 묻는 질문

“연결 풀링: PgBouncer” 강의는 무료인가요?

네 — “연결 풀링: PgBouncer” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 SQL Academy 강의 전체를 잠금 해제할 수 있습니다. SQL Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“연결 풀링: PgBouncer”에서 뭘 배우나요?

PgBouncer를 트랜잭션 풀링 모드로 실행하고 풀 크기를 올바르게 설정하며 준비된 문 사용으로 인한 함정을 피해보세요. 브라우저에서 직접 실행하는 실습 코드로 SQL Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

SQL Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 SQL Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“연결 풀링: PgBouncer” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 SQL Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 SQL Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. pg_stat_statements: 주요 쿼리
  2. 로그 분석을 위한 pgBadger
  3. 연결 풀링: PgBouncer
  4. 용량 계획과 비대화 감사
← SQL Academy(으)로 돌아가기