✅ Prisma generator 완벽 가이드 – Prisma Client 생성의 시작점

 

✅ Prisma generator 완벽 가이드 – Prisma Client 생성의 시작점

"Prisma Client는 어디서 만들어질까?"
바로 generator 블록이 Prisma ORM의 코드 생성 과정을 책임집니다.

---

🧾 generator란?

generator 블록은 Prisma가 모델 정의를 바탕으로 어떤 코드를 생성할지 지정합니다.
대표적으로 @prisma/client를 생성하는 데 사용됩니다.

generator client {
  provider = "prisma-client-js"
}

---

📌 필수 필드 구성

필드 설명

provider	어떤 종류의 코드를 생성할지 지정 (ex: Prisma Client, zod, graphql 등)
output (optional)	생성된 파일의 출력 경로
previewFeatures (optional)	베타 기능 활성화 옵션 (예: clientExtensions, orderByRelation)

---

🧱 예시: 기본적인 Prisma Client 생성

generator client {
  provider = "prisma-client-js"
}

Prisma CLI 실행:

npx prisma generate

✅ 위 명령어 실행 시, /node_modules/@prisma/client 디렉토리에 TypeScript 기반의 Prisma Client가 생성됩니다.

---

📂 예시: 출력 위치 지정

반응형

generator client {
  provider = "prisma-client-js"
  output   = "./generated/client"
}

// 사용 예시
import { PrismaClient } from './generated/client'

✅ 주의: output은 일반적으로 Next.js 등의 빌드 시스템과 경로 호환성에 유의해야 합니다.

---

🌟 다양한 Generator 유형들

Generator 설명

prisma-client-js	Prisma 공식 Client (기본값)
prisma-zod-generator	Zod 스키마 자동 생성 (입력 유효성 검사용)
prisma-nestjs-graphql	NestJS용 GraphQL 스키마 생성
typegraphql-prisma	TypeGraphQL과 함께 사용되는 코드 생성기
커스텀 generator	나만의 CLI 코드 생성기 개발 가능

예시:

generator zod {
  provider = "prisma-zod-generator"
}

---

🧪 previewFeatures: 실험적 기능 활성화

generator client {
  provider        = "prisma-client-js"
  previewFeatures = ["clientExtensions"]
}

기능 이름 설명

clientExtensions	Prisma Client 확장 지원
orderByRelation	관계형 정렬 지원
mongoDbNativeTypes	MongoDB 고유 타입 사용 가능

⚠️ previewFeatures는 Prisma 버전에 따라 지원 여부가 다르므로 항상 문서 참고 필수

---

📌 Prisma Generate 전체 흐름 요약

1. schema.prisma에 generator 정의
2. npx prisma generate 실행
3. Prisma는 모델 정보를 바탕으로 코드 자동 생성
4. import { PrismaClient } from '@prisma/client'로 사용

---

🧠 실무 팁

상황 전략

Next.js에서 경로 충돌 방지	output = "./generated/prisma" 등으로 격리
DTO 자동 생성	Zod, GraphQL Generator와 함께 사용
CI/CD에서 타입 보장	prisma generate를 빌드시 자동 실행 처리
Monorepo 구성	output 경로를 패키지별로 다르게 지정 가능

---

 

Prisma generator 설정,Prisma Client 생성,Prisma generate 사용법,Prisma schema generator,prisma-client-js 설명,Prisma 출력 경로 설정,Zod Prisma 연동,Prisma NestJS GraphQL,Prisma previewFeatures,Prisma custom generator

---