Ch3. Prisma Postgres 활용
Prisma Postgres 연결·풀링과 Accelerate 종료·Early Access DB 이전을 운영 절차로 정리합니다.
핵심 요약
- 애플리케이션은 pooled TCP + Prisma 7
@prisma/adapter-pg, CLI·백업은 direct TCP로 분리합니다. - Hosted Accelerate 연결은 2026-12-01 종료됩니다. 연결 전환과 ORM 8 평가를 별도 변경으로 관리합니다.
- Accelerate 쿼리 캐시는 대체되지 않으므로
cacheStrategy·확장 API를 제거하고 캐시 없는 DB 부하를 측정합니다. - 구 Early Access PostgreSQL 16 DB는 2026-11-01 00:00 UTC 삭제 대상입니다. Console의 해당 공지를 확인해 새 DB로 이전합니다.
현재 연결 방식
| 용도 | 연결 | Prisma 7 설정 |
|---|---|---|
| Node.js 앱 요청 | pooled TCP | PrismaPg adapter에 DATABASE_URL 전달 |
| 마이그레이션·Studio·관리 | direct TCP | prisma.config.ts의 datasource URL |
| TCP 제약 런타임 | serverless driver | 공식 @prisma/adapter-ppg 경로 확인 |
Console에서 새 연결 문자열을 발급받습니다. 기존 URL의 호스트만 수작업으로 바꾸지 않습니다.
# 예시 형식이며 실제 값은 비밀 저장소에 둔다.
DATABASE_URL="postgres://USER:PASSWORD@pooled.db.prisma.io:5432/postgres?sslmode=require"
DIRECT_DATABASE_URL="postgres://USER:PASSWORD@db.prisma.io:5432/postgres?sslmode=require"실제 generator·adapter·config 예제는 토폴로지와 환경 구성을 따릅니다.
12월 1일 전 Accelerate 연결 전환
대상은 hosted prisma://accelerate.prisma-data.net와 prisma+postgres://accelerate.prisma-data.net 경로입니다. 로컬 개발의 prisma+postgres://localhost는 이 종료 공지의 대상이 아닙니다.
withAccelerate,accelerateUrl,@prisma/extension-accelerate,cacheStrategy,$accelerate,--no-engine사용 위치를 찾습니다.- 새 pooled·direct credential을 발급하고 preview·staging의 설정부터 교체합니다.
- Accelerate 확장·캐시 API를 제거하고 driver adapter를 구성한 뒤 Client를 재생성합니다.
- 캐시가 없는 상태에서 DB QPS·활성 연결·pool wait·p95·timeout을 측정합니다. 컴파일 LRU 캐시는 결과 캐시의 대체재가 아닙니다.
- 읽기·쓰기·트랜잭션·migration·Studio·
pg_dump를 별도 검증합니다. 연결 경로 변경을 ORM major 변경과 함께 배포하지 않습니다. - 정상화 후 이전 credential을 회수하고 cutover 결과를 남깁니다.
이 작업은 기존 DB·데이터·플랜을 그대로 둔 접속 경로 변경입니다. 자체 DB에서 standalone Accelerate를 쓰는 경우에는 해당 DB 유지 가이드를 따릅니다.
11월 1일 전 Early Access DB 이전
해당 공지는 모든 PostgreSQL 16 DB가 아니라 Console이 종료 대상으로 표시하는 Prisma Postgres Early Access DB에 적용됩니다.
- 새 DB를 만들고 export·restore를 리허설합니다. extension·sequence·제약·인덱스·row count와 대표 쿼리를 확인합니다.
- 허용 가능한 쓰기 중단 시간과 최종 데이터 동기화 방식을 정합니다. 초기 복제 후 생긴 변경분을 누락한 채 연결만 바꾸지 않습니다.
- 앱과 worker·스케줄·운영 도구의 credential을 함께 전환하고 로그인·결제·배치까지 확인합니다.
- 2026-11-01 00:00 UTC(한국 11월 1일 09:00) 이후 원본을 복구 경로로 기대하지 않습니다.
한도·비용·백업의 운영 기준
예전 Free/Starter/Pro/Business 가격·연결 수 표를 현재 계약으로 재사용하지 않습니다. 배포 시 현재 풀링 문서와 Console 플랜에서 다음을 기록합니다.
| 항목 | 남길 증거 |
|---|---|
| 연결 예산 | 인스턴스×adapter pool + worker + 관리 연결; DB 실제 한도 |
| 시간 제한 | driver connection timeout·statement timeout·요청 deadline |
| 용량·과금 | 저장량·전송량·작업량과 적용 플랜·확인 날짜 |
| 백업·복구 | 자동 백업 보존 기간·복구 권한·최근 복원 리허설 RTO/RPO |
| 관측 | Query Insights의 느린 쿼리, 연결·지연·실패율 |
숫자는 상품 한도와 팀의 운영 목표를 구분합니다. 자동 백업이 있어도 복원 테스트를 별도로 수행하고 결과를 DR 전략에 연결합니다.
공식 근거
Accelerate 연결 전환 · 2026-10-02 Changelog · Prisma Console 접속 경로 · Release status.