마이그레이션: Prisma Migrate 실전

pnpm add prisma @prisma/client
pnpm dlx prisma init

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

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model User {
  id        String   @id @default(cuid())
  email     String   @unique
  name      String
  posts     Post[]
  createdAt DateTime @default(now())

  @@index([createdAt])
}

model Post {
  id        String   @id @default(cuid())
  title     String
  content   String   @db.Text
  authorId  String
  author    User     @relation(fields: [authorId], references: [id])
  published Boolean  @default(false)
  createdAt DateTime @default(now())

  @@index([authorId, createdAt(sort: Desc)])
  @@index([published])
}

# 개발 — 스키마 변경 후
pnpm dlx prisma migrate dev --name add_user_email_unique

# → migrations/20260429_add_user_email_unique/migration.sql 생성
# → DB 적용 + Prisma Client 재생성


# 프로덕션
pnpm dlx prisma migrate deploy

# → 미적용 마이그레이션 실행 (생성 X)


# DB 재설정 (개발용)
pnpm dlx prisma migrate reset

❌ 위험한 변경:
1. 컬럼 이름 변경 (rename)
2. 컬럼 타입 변경 (string → number)
3. NOT NULL 추가 (기존 데이터에)
4. 큰 테이블에 인덱스 추가 (블로킹)


✅ 안전한 패턴 — Expand & Contract:

[Phase 1: Expand]
- 새 컬럼 추가 (nullable)
- 새 코드는 양쪽 쓰기 (dual-write)
- 백필 (background)

[Phase 2: Migrate]
- 새 컬럼이 채워질 때까지 대기
- 새 코드는 새 컬럼만 읽기

[Phase 3: Contract]
- 옛 컬럼 제거
- 코드 정리

// ❌ 한 번에
model User {
  username String  // name → username으로 변경
}


// ✅ 단계별
// Phase 1
model User {
  name      String
  username  String?  // 추가
}
// 코드: 양쪽 쓰기
await prisma.user.update({ where, data: { name: x, username: x } });


// Phase 2 — 백필
await prisma.$executeRaw`UPDATE "User" SET username = name WHERE username IS NULL`;


// Phase 3
model User {
  username String  // name 제거 + NOT NULL
}

-- ❌ 블로킹
CREATE INDEX idx_posts_created ON posts(created_at);


-- ✅ 비차단 (PostgreSQL)
CREATE INDEX CONCURRENTLY idx_posts_created ON posts(created_at);


-- Prisma는 자동으로 CONCURRENTLY 안 함
-- → 수동 마이그레이션 SQL 작성

-- migration.sql
CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_posts_created ON "Post"("createdAt");

// prisma/seed.ts
import { PrismaClient } from '@prisma/client';
const prisma = new PrismaClient();

async function main() {
  await prisma.user.upsert({
    where: { email: 'admin@example.com' },
    create: { email: 'admin@example.com', name: 'Admin', role: 'ADMIN' },
    update: {},
  });
}

main().finally(() => prisma.$disconnect());


// package.json
{
  "prisma": { "seed": "tsx prisma/seed.ts" }
}


// 실행
pnpm dlx prisma db seed

# Prisma는 자동 롤백 없음 → 수동 작성

# migrations/20260429_xxx/migration.sql
ALTER TABLE "Post" ADD COLUMN "summary" TEXT;

# rollback.sql (수동 작성·관리)
ALTER TABLE "Post" DROP COLUMN "summary";


# 프로덕션 롤백 절차:
1. 백업 확인 (RDS 자동 스냅샷)
2. 새 마이그레이션으로 역방향 변경
3. 또는 백업에서 PITR (Point-In-Time Recovery)

# .env.development
DATABASE_URL="postgresql://localhost/myapp_dev"

# .env.staging
DATABASE_URL="postgresql://stage-db.../myapp_stage"

# .env.production (Vercel/Railway 환경변수)
DATABASE_URL="postgresql://prod-db.../myapp_prod"


# CI/CD 흐름:
1. PR 머지 → staging migrate deploy
2. 검증 통과 → production migrate deploy
3. 실패 시 alert + 롤백 절차