[파이썬] ORM을 사용한 데이터베이스 스키마 마이그레이션

01 Sep 2023

python

데이터베이스 스키마 마이그레이션은 소프트웨어의 개발과정에서 필수적으로 이루어져야 하는 작업입니다. 스키마 마이그레이션은 데이터베이스의 구조를 변경하거나 데이터를 이동하는 일련의 작업을 말합니다. 이러한 작업을 효율적으로 처리하기 위해 ORM(Object-Relational Mapping)을 사용할 수 있습니다.

ORM은 객체지향 프로그래밍 언어를 사용하여 데이터베이스와 상호작용하기 위한 기술입니다. Python에서는 여러 ORM 도구들이 제공되고 있으며, 그 중에서도 Django ORM은 대표적인 예시입니다. 이번 블로그 포스트에서는 Django ORM을 사용하여 데이터베이스 스키마 마이그레이션을 하는 방법에 대해 살펴보겠습니다.

1. 데이터베이스 설정

Python에서 ORM을 사용하기 위해 먼저 데이터베이스에 연결하고 설정해야 합니다. Django에서는 settings.py 파일에서 데이터베이스 관련 설정을 할 수 있습니다. 예를 들어, MySQL 데이터베이스에 연결하기 위해 다음과 같이 설정할 수 있습니다.

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'mydatabase',
        'USER': 'myuser',
        'PASSWORD': 'mypassword',
        'HOST': 'localhost',
        'PORT': '3306',
    }
}

2. 모델 정의

다음으로는 데이터베이스 마이그레이션을 위해 변경할 스키마를 모델로 정의해야 합니다. Django에서는 모델을 사용하여 데이터베이스 테이블과 필드를 정의할 수 있습니다. 예를 들어, 사용자 정보를 담고 있는 User 모델을 정의해보겠습니다.

from django.db import models

class User(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField()
    age = models.IntegerField()

위 코드에서 User 모델은 name, email, age 필드를 가지고 있습니다. 각 필드의 타입은 CharField, EmailField, IntegerField로 정의되었습니다.

3. 마이그레이션 생성

모델을 정의한 후에는 마이그레이션 파일을 생성해야 합니다. 마이그레이션 파일은 변경된 스키마를 데이터베이스에 적용하는 작업을 기록한 파일입니다. Django에서는 makemigrations 명령어를 사용하여 마이그레이션 파일을 생성할 수 있습니다.

$ python manage.py makemigrations

위 명령어를 실행하면 Django ORM은 모델의 변경 사항을 분석하고 이를 마이그레이션 파일로 생성합니다.

4. 마이그레이션 적용

마이그레이션 파일을 생성한 후에는 이를 데이터베이스에 실제로 적용해야 합니다. Django에서는 migrate 명령어를 사용하여 마이그레이션을 적용할 수 있습니다.

$ python manage.py migrate

위 명령어를 실행하면 Django ORM은 마이그레이션 파일을 읽고, 데이터베이스에 변경 사항을 적용합니다.

5. 롤백

만약 마이그레이션 작업을 취소하고 이전 상태로 돌아가야 한다면, 롤백 기능을 사용할 수 있습니다. Django에서는 migrate 명령어에 --fake 옵션을 사용하여 롤백할 수 있습니다.

$ python manage.py migrate --fake

위 명령어를 실행하면 Django ORM은 마이그레이션 파일을 적용하지 않고, 데이터베이스를 이전 상태로 롤백합니다.

결론

ORM을 사용한 데이터베이스 스키마 마이그레이션은 데이터베이스 구조를 변경하거나 데이터를 이전하는 작업을 간편하게 처리할 수 있도록 도와줍니다. 위에서 언급한 Django ORM을 사용하여 데이터베이스 스키마 마이그레이션을 하는 방법을 살펴보았습니다. 올바른 스키마 마이그레이션 절차를 따르면 데이터베이스의 구조를 업데이트하는 작업을 안전하고 효율적으로 수행할 수 있습니다.