TypeORM을 사용한 데이터베이스 마이그레이션이란

기본적인 정보 얻기

https://typeorm.io/

TypeORM - Amazing ORM for TypeScript and JavaScript (ES7, ES6, ES5). Supports MySQL, PostgreSQL, MariaDB, SQLite, MS SQL Server,

TypeORM을 사용한 데이터베이스 마이그레이션은 TypeORM이 제공하는 기능을 활용하여 데이터베이스의 스키마를 버전 관리하는 프로세스입니다. 이는 애플리케이션의 데이터 모델이 변경될 때마다 데이터베이스 스키마를 안전하게 변경할 수 있도록 도와줍니다. 마이그레이션을 사용하면 데이터베이스 스키마 변경 사항을 코드 형태로 관리할 수 있으며, 이러한 변경 사항을 버전별로 추적할 수 있습니다.

TypeORM 마이그레이션의 주요 과정은 다음과 같습니다:

1. 마이그레이션 파일 생성: 데이터베이스 스키마를 변경하고 싶을 때, TypeORM CLI(Command Line Interface)를 사용하여 마이그레이션 파일을 생성합니다. 이 파일은 데이터베이스 변경을 위한 SQL 명령어를 포함하거나, TypeORM이 제공하는 API를 통해 스키마 변경을 진행합니다.
2. 마이그레이션 실행: 생성된 마이그레이션 파일을 실행하여 데이터베이스 스키마를 변경합니다. TypeORM CLI를 사용하여 마이그레이션을 실행할 수 있으며, 이 과정에서 데이터베이스가 새로운 스키마로 업데이트됩니다.
3. 마이그레이션 롤백: 필요한 경우 이전 상태로 데이터베이스 스키마를 복원할 수 있습니다. 마이그레이션 파일은 보통 업그레이드와 다운그레이드 로직을 모두 포함하고 있어, 특정 마이그레이션을 롤백할 수 있습니다.

마이그레이션을 사용하는 이점은 다음과 같습니다:

• 버전 관리: 데이터베이스 스키마의 변경 사항을 코드로 관리하여, 여러 개발자가 작업하는 환경에서도 스키마 변경 사항을 쉽게 공유하고 적용할 수 있습니다.
• 이력 추적: 어떤 변경 사항이 언제 적용되었는지 기록을 통해 파악할 수 있습니다.
• 안정성: 마이그레이션 과정에서 발생할 수 있는 오류를 사전에 체크하여, 데이터베이스의 무결성을 유지할 수 있습니다.

TypeORM을 통한 데이터베이스 마이그레이션은 Node.js 환경에서 데이터베이스 관리를 보다 체계적으로 할 수 있게 도와주며, 애플리케이션의 데이터 관리를 더 안정적이고 효율적으로 만들어줍니다.

 

typeorm CLI를 사용하여 새로운 마이그레이션 파일을 생성합니다. 마이그레이션 이름은 의미있게 지정하는 것이 좋습니다.

 

typeorm migration:create -n MigrationName

 

이 명령은 src/migration 폴더(기본 설정)에 새로운 마이그레이션 파일을 생성합니다. 파일에는 데이터베이스 변경을 위한 코드를 작성해야 합니다.

마이그레이션 실행

모든 마이그레이션 파일에 작성된 변경 사항을 데이터베이스에 적용하려면 다음 명령을 실행합니다.

typeorm migration:run

 

이 명령은 아직 데이터베이스에 적용되지 않은 모든 마이그레이션을 실행합니다.

TypeORM을 사용한 데이터베이스 마이그레이션과 ts-node를 통한 서버 실행이 가능합니다. 개발 환경을 더 편리하게 구성하기 위해 npm scripts에 이러한 명령을 추가하는 것도 고려해 볼 수 있습니다.

 

예를 들어, package.json 파일에 다음과 같은 스크립트를 추가할 수 있습니다.

 

"scripts": {

"start": "ts-node src/app.ts",

"migration:run": "typeorm migration:run",

"migration:create": "typeorm migration:create -n"

}