Prisma 스키마 디자인, 마이그레이션 및 쿼리 최적화란 무엇인가요?

이 스킬은 Prisma ORM을 사용하는 개발자들을 위한 가이드로, 효율적인 스키마 디자인, 안전한 마이그레이션 관리, 그리고 고성능 쿼리 작성을 돕습니다. 핵심 규칙으로는 단일 진실 공급원(single source of truth)으로서의 `prisma/schema.prisma` 파일 관리, `include`보다 `select`를 우선 사용하여 필요한 필드만 가져오기, 다중 단계 변이에는 트랜잭션 사용, 소프트 삭제 패턴(`deletedAt DateTime?` 필드 + 미들웨어 필터) 적용, 자주 조회되는 필드에 인덱스 생성, 양방향 관계 정의 등이 포함됩니다. 또한 서버리스 환경을 위한 커넥션 풀링(Prisma Accelerate 또는 PgBouncer) 사용과 스키마 변경 후 타입 생성(`npx prisma generate`)을 권장합니다. 피해야 할 사항으로는 불필요한 `include`, N+1 쿼리, Prisma API로 처리 가능한 경우의 Raw SQL 사용, 페이지네이션 없이 `findMany()` 호출 등을 명시하여 성능 저하를 방지합니다.

지원 대상~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/prisma

문서

Prisma

규칙

스키마는 prisma/schema.prisma에 위치 — 단일 진실 공급원
include보다 select 사용 — 필요한 필드만 가져오기
다중 단계 변이에는 트랜잭션 사용: prisma.$transaction([...])
소프트 삭제는 deletedAt DateTime? 필드 + 미들웨어 필터로 구현
자주 조회되는 필드에 인덱스 생성: @@index([fieldName])
관계: 항상 양쪽을 정의 (@relation)
마이그레이션: npx prisma migrate dev --name 설명-이름
서버리스 환경을 위한 커넥션 풀링: Prisma Accelerate 또는 PgBouncer 사용
타입 생성: 스키마 변경 후 npx prisma generate

피해야 할 사항

한 필드만 필요할 때 include: { relation: true } 사용 — 대신 select 사용
N+1 쿼리 — 중첩된 관계에는 include 또는 select 사용
Prisma API로 처리 가능할 때 Raw SQL 사용 — 복잡한 집계에만 $queryRaw 사용
prisma.table.findMany() 호출 시 take 제한 없이 사용 — 항상 페이지네이션 적용

Prisma 스키마 디자인, 마이그레이션 및 쿼리 최적화