02662025년 8월 8일

[Node.js] Prisma 완벽 가이드: 개념, 구조, MySQL 주의사항까지 한 번에 정리

Prisma란?

Prisma는 TypeScript/JavaScript 환경에서 사용되는 차세대 ORM(Object-Relational Mapping) 도구이다.

전통적인 ORM들과 달리 개발 경험과 타입 안전성에 특히 초점을 맞춘다.

쉽게 말해서,

Prisma의 구조

Prisma는 크게 3가지 핵심 컴포넌트로 나눌 수 있다.

1) Prisma Schema (schema.prisma)

JavaScript

model User {
  id    Int    @id @default(autoincrement())
  name  String
  email String @unique
}

: 이 스키마를 기반으로 타입 안전 클라이언트 코드가 생성된다

2) Prisma Migrate

DB 스키마 변경을 관리하는 마이그레이션 도구
npx prisma migrate dev 명령으로 SQL 마이그레이션을 자동 생성 및 실행
마이그레이션 파일이 남아 있어, 스키마 변경 이력 추적이 가능하다.
dp push와 차이
- dp push : 개발 중 빠르게 구조를 DB에 반영 (마이그레이션 파일 X)
- migrate : 구조 변경 이력을 파일로 관리 (운영 환경 배포 시 필수)

3) Prisma Client

JavaScript

const user = await prisma.user.findUnique({
  where: { id: 1 },
});

: 완전 타입 안전: 오타나 없는 필드 접근 시 컴파일 에러 발생

Prisma의 동작 흐름

1) 스키마 작성 → schema.prisma에 DB 구조 정의

2) DB 반영

3) 클라이언트 생성 → npx prisma generate

4) 코드에서 사용 → import { PrismaClient } from '@prisma/client'

MySQL에서 Prisma 사용할 때 주의할 점

Prisma에서 MySQL을 사용할 경우, 몇 가지 주의해야 할 사항이 있다.

1) VARCHAR(191): MySQL 인덱스 키 제한

2) Partial Unique 없음 → 복합키 + Boolean 플래그

3) @updatedAt는 자동 갱신이므로 기존 데이터 마이그레이션 시 default 필요

4) now() 기본값은 UTC 기준 → 시간대 보정 필요

Prisma가 다른 ORM보다 좋은 점

최근 글