npm 을 활용한 데이터 마이그레이션 (Data migration with npm)

10 Nov 2023

데이터 마이그레이션은 소프트웨어 시스템에서 중요한 작업입니다. 데이터베이스의 스키마 변경, 데이터 포맷 변경, 새로운 데이터베이스로의 이전 등 다양한 상황에서 데이터 마이그레이션을 진행해야 할 수 있습니다. 이때 npm(Node Package Manager)은 유용한 도구로 활용될 수 있습니다. npm을 사용하여 데이터 마이그레이션을 할 수 있는 방법에 대해 알아보겠습니다.

1. npm package 설치

먼저 데이터 마이그레이션을 가능하게 해주는 npm package를 설치해야 합니다. 대표적인 데이터 마이그레이션 도구로는 “migrate”와 “sequelize” 등이 있습니다.

npm install migrate

npm install sequelize

위와 같이 명령어를 통해 필요한 패키지를 설치합니다.

2. 마이그레이션 스크립트 작성

설치한 패키지를 이용하여 데이터 마이그레이션을 위한 스크립트를 작성합니다. 스크립트는 데이터베이스 변경 작업을 수행하는 코드를 포함하고 있습니다.

예를 들어, migrate 패키지를 사용하는 경우 마이그레이션 스크립트는 다음과 같이 작성할 수 있습니다.

const { migrations } = require('migrate');
const path = require('path');

migrations.init(path.join(__dirname, 'migrations'));

migrations.up().catch((err) => {
  console.error('Error running migrations:', err);
  process.exit(1);
});

sequelize 패키지를 사용하는 경우에는 다음과 같이 작성할 수 있습니다.

const db = require('./models');

(async () => {
  await db.sequelize.sync({ alter: true });
  console.log('Database migration completed successfully');
})();

3. 데이터 마이그레이션 실행

스크립트 작성이 완료되었다면, 데이터 마이그레이션을 실행할 차례입니다. 터미널에서 다음 명령어를 실행하여 데이터 마이그레이션을 수행합니다.

node migrate.js

또는

node sequelize.js

위와 같이 명령어를 입력하면 데이터 마이그레이션 스크립트가 실행되어 데이터베이스의 변경 작업이 수행됩니다.

4. 에러 처리 및 롤백

데이터 마이그레이션 중에는 에러가 발생할 수 있습니다. 이때는 에러 처리와 롤백 메커니즘이 중요합니다.

migrate 패키지를 사용하는 경우에는 catch 문을 사용하여 에러를 처리하고 롤백을 수행할 수 있습니다.

migrations.up().catch((err) => {
  console.error('Error running migrations:', err);
  migrations.down().then(() => {
    console.log('Rollback completed successfully');
    process.exit(1);
  });
});

sequelize 패키지를 사용하는 경우에는 try-catch 문을 사용하여 에러를 처리하고 롤백을 수행할 수 있습니다.

(async () => {
  try {
    await db.sequelize.sync({ alter: true });
    console.log('Database migration completed successfully');
  } catch (err) {
    console.error('Error running migrations:', err);
    await db.sequelize.sync({ alter: false });
    console.log('Rollback completed successfully');
    process.exit(1);
  }
})();

마무리

이처럼 npm을 활용하여 데이터 마이그레이션을 간단하게 수행할 수 있습니다. npm을 사용하여 데이터 마이그레이션을 진행하면 코드의 관리와 유지보수가 편리해지며, 신속하게 데이터베이스 변경 작업을 수행할 수 있습니다.

#datamigration #npm