Repolode
jackc

jackc/pgx

LISTEN/NOTIFY와 COPY 같은 PostgreSQL 전용 기능을 제공하는 순수 Go 드라이버 겸 툴킷입니다.

스타
14,384
포크
1,159
열린 이슈
218
마지막 커밋
그저께

어떤 프로젝트인가요?

pgx는 PostgreSQL용 순수 Go 드라이버 겸 툴킷입니다. 성능을 중시하는 저수준 드라이버 인터페이스를 제공하며, LISTEN / NOTIFY와 COPY 같은 PostgreSQL 전용 기능도 지원합니다. 기존 코드에서 database/sql을 사용한다면 이를 위한 어댑터도 함께 제공됩니다.

툴킷은 PostgreSQL 와이어 프로토콜 파싱과 PostgreSQL-GO 간 타입 매핑 등 PostgreSQL 기능을 구현하는 여러 패키지로 구성됩니다. 이 패키지들은 대체 드라이버, 프록시, 로드 밸런서 또는 논리 복제 클라이언트를 만드는 데 재사용할 수 있습니다. 동시 사용을 위한 커넥션 풀(pg​​xpool)도 제공됩니다.

이 프로젝트는 약 70개의 PostgreSQL 타입, prepared statement 캐싱, 배치 쿼리, 사용자 정의 타입의 바이너리 형식 인코딩, 트레이싱 및 로깅 훅을 지원합니다. Go 1.25 이상과 PostgreSQL 14 이상을 대상으로 합니다.

핵심 기능

  • 01약 70개의 PostgreSQL 타입과 Go 타입 매핑 지원
  • 02prepared statement 자동 캐싱 및 배치 쿼리
  • 03대량 데이터 적재를 위한 COPY 프로토콜 지원
  • 04LISTEN / NOTIFY 및 대형 객체 지원
  • 05연결 후 훅을 지원하는 커넥션 풀
  • 06트레이싱 및 로깅 훅, database/sql 어댑터

활용 사례

  • PostgreSQL에 직접 연결해 PostgreSQL 전용 기능을 활용하는 Go 서비스 개발
  • COPY 프로토콜을 사용해 대규모 데이터셋 대량 적재
  • PostgreSQL 프록시, 커넥션 풀러 또는 논리 복제 클라이언트 개발
  • database/sql을 사용하는 기존 코드베이스에서 pgx 활용

빠른 시작

  1. 1

    Go로 pgx v5 모듈을 설치합니다

    go get github.com/jackc/pgx/v5
  2. 2

    DATABASE_URL 환경 변수를 사용해 pgx.Connect로 연결하고 쿼리를 실행하는 프로그램을 작성합니다

사용 전 알아둘 점

  • 연결할 PostgreSQL 서버가 필요합니다(버전 14 이상 지원).
  • Go 1.25 이상이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

pgx은(는) 무엇인가요?
LISTEN/NOTIFY와 COPY 같은 PostgreSQL 전용 기능을 제공하는 순수 Go 드라이버 겸 툴킷입니다. pgx는 PostgreSQL용 순수 Go 드라이버 겸 툴킷입니다. 성능을 중시하는 저수준 드라이버 인터페이스를 제공하며, LISTEN / NOTIFY와 COPY 같은 PostgreSQL 전용 기능도 지원합니다. 기존 코드에서 database/sql을 사용한다면 이를 위한 어댑터도 함께 제공됩니다.
pgx은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
pgx은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
pgx은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. pgx의 마지막 커밋은 2026년 11월 5일입니다.
pgx은(는) 어디에 사용할 수 있나요?
PostgreSQL에 직접 연결해 PostgreSQL 전용 기능을 활용하는 Go 서비스 개발 COPY 프로토콜을 사용해 대규모 데이터셋 대량 적재 PostgreSQL 프록시, 커넥션 풀러 또는 논리 복제 클라이언트 개발 database/sql을 사용하는 기존 코드베이스에서 pgx 활용
pgx는 어떻게 설치하나요?
Go로 pgx v5 모듈을 설치합니다: go get github.com/jackc/pgx/v5 DATABASE_URL 환경 변수를 사용해 pgx.Connect로 연결하고 쿼리를 실행하는 프로그램을 작성합니다
pgx은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jackc/pgx

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트