Prisma는 Node.js 및 TypeScript 애플리케이션에서 데이터베이스와의 상호 작용을 용이하게 하는 최신 ORM(객체 관계형 매핑)입니다. Prisma의 가장 중요한 기능 중 하나는 데이터베이스 스키마를 애플리케이션의 데이터 모델과 동기화된 상태로 유지할 수 있는 마이그레이션 시스템입니다. 이 게시물에서는 마이그레이션을 사용하는 Prisma 워크플로를 살펴보겠습니다.

마이그레이션이란 무엇입니까?

마이그레이션은 체계적이고 버전이 지정된 방식으로 데이터베이스 스키마에 대한 변경 사항을 제어하고 적용하는 방법입니다. 이를 통해 테이블 ​​생성 또는 변경과 같은 데이터베이스의 구조적 변경 사항을 증분 및 되돌릴 수 있는 방식으로 정의할 수 있습니다.

마이그레이션을 포함한 Prisma 워크플로

Prisma의 일반적인 마이그레이션 작업 흐름에는 다음 단계가 포함됩니다.

1. 설치 및 초기 구성
2. 스키마 정의
3. 마이그레이션 생성
4. 마이그레이션 신청
5. 마이그레이션 관리

1단계: 설치 및 초기 구성

먼저 프로젝트에 Prisma를 설치하고 초기화해야 합니다.

npm install @prisma/client
npx prisma init

이 명령은 데이터 모델을 정의하는 Schema.prisma 파일이 포함된 프리즘 디렉터리를 생성합니다.

2단계: 스키마 정의

schema.prisma 파일에서 데이터베이스 테이블을 나타내는 모델을 정의합니다. 예를 들어 User:
모델을 정의해 보겠습니다.

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

여기에서는 ID, 이메일, 이름 열이 있는 사용자 테이블을 정의합니다.

3단계: 마이그레이션 생성

스키마를 정의하거나 변경한 후 데이터베이스에 이러한 변경 사항을 반영하기 위해 마이그레이션을 생성합니다.

npx prisma migrate dev --name init

migration dev 명령은 새 마이그레이션을 생성하고 변경 사항을 데이터베이스에 적용합니다. --name 매개변수를 사용하면 위 예의 init와 같이 마이그레이션에 설명이 포함된 이름을 지정할 수 있습니다.

4단계: 마이그레이션 신청

migration dev 명령을 사용하면 마이그레이션이 데이터베이스에 자동으로 적용됩니다. 이를 통해 데이터베이스는 항상 Schema.prisma에 정의된 데이터 모델과 동기화됩니다.

프로덕션 환경에서 마이그레이션을 적용하려면 다음 명령을 사용하세요.

npx prisma migrate deploy

이 명령은 보류 중인 모든 마이그레이션을 프로덕션 데이터베이스에 적용합니다.

5단계: 마이그레이션 관리

Prisma는 데이터베이스에 적용된 모든 마이그레이션 기록을 유지합니다. 이는 변경 사항을 추적하고 필요한 경우 마이그레이션을 되돌리는 데 유용합니다. 마이그레이션 기록을 보려면 다음을 사용할 수 있습니다.

npx prisma migrate status

이 명령은 적용된 마이그레이션과 보류 중인 마이그레이션을 포함하여 마이그레이션의 현재 상태를 표시합니다.

실제 사례

사용자 모델에 새 필드를 추가하고 이 변경 사항에 대한 마이그레이션을 생성하는 방법에 대한 실제 예를 살펴보겠습니다.

1. schema.prisma의 사용자 모델에 필드 추가:
   

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

2. 새 마이그레이션 만들기:
   

   npx prisma migrate dev --name add-birthdate-to-user
   
   

3. 마이그레이션 적용:

   마이그레이션 dev 명령은 이미 데이터베이스에 마이그레이션을 적용합니다. 이제 데이터베이스는 사용자 테이블에 새로운 생년월일 필드를 갖게 됩니다.

4. 이전 상태 확인:
   

   npx prisma migrate status
   
   

   이 명령은 사용자에게 생년월일 추가 이전이 성공적으로 적용되었음을 보여줍니다.

결론

마이그레이션을 사용하는 Prisma의 워크플로는 데이터베이스 스키마 변경 사항을 관리하는 효율적이고 안전한 방법입니다. 스키마 정의, 마이그레이션 생성, 변경 사항 적용 및 마이그레이션 기록 관리 등 명확한 일련의 단계를 통해 데이터베이스를 애플리케이션의 데이터 모델과 동기화된 상태로 유지하여 소프트웨어 개발 및 유지 관리를 촉진할 수 있습니다.

Prisma를 사용하면 데이터베이스 관리를 단순화할 뿐만 아니라 모든 변경 사항을 추적 및 되돌릴 수 있도록 하는 강력한 도구를 확보하여 보다 강력하고 민첩한 개발 프로세스에 기여할 수 있습니다.