migration은 어떻게 동작하나요?

Question

Accepted Answer

**migration**은 model에 가한 변경(필드 추가, model 생성)을 **데이터베이스 스키마**로 전파하는 Django의 방식입니다. 버전 관리되고 자동 생성되는 데이터베이스 변경 파일입니다. Python에서 model을 변경하면 migration이 데이터베이스를 동기화 상태로 유지합니다. ## 두 단계 워크플로 ```bash # 1. models.py에서 model을 변경(예: 필드 추가)... # 2. 변경을 기술하는 migration 파일 생성 python manage.py makemigrations # → migrations/0002_article_views.py 생성(변경을 Python으로) # 3. migration을 데이터베이스에 적용 python manage.py migrate # → 데이터베이스 스키마를 변경하는 SQL 실행(ADD COLUMN 등) ``` `makemigrations`는 model 변경을 감지하여 migration 파일을 생성하고, `migrate`는 보류 중인 migration을 실제 데이터베이스에 적용합니다. Python(model 변경)을 작성하면 Django가 SQL을 생성하고 실행합니다. ## migration 파일은 버전 관리되는 코드 ```python # migrations/0002_article_views.py (자동 생성) class Migration(migrations.Migration): dependencies = [("blog", "0001_initial")] # 순서 — 이전 것에 의존 operations = [ migrations.AddField( # 변경 model_name="article", name="views", field=models.IntegerField(default=0), ), ] ``` migration은 **버전 관리에 커밋**되므로, 데이터베이스 스키마의 이력이 코드와 함께 추적됩니다. 모든 개발자와 환경이 동일한 migration을 적용하여 동일한 스키마에 도달합니다. 재현 가능하고 일관됩니다. ## migration이 중요한 이유(수동 SQL 대비) ```text ✓ 스키마 변경이 버전 관리됨(코드와 함께 추적, PR에서 리뷰 가능) ✓ 재현 가능 — 모든 dev/staging/production DB가 migrate 실행으로 동일 스키마를 얻음 ✓ 수동의 오류 잦은 SQL 불필요 — Django가 올바른 ALTER 문을 생성 ✓ 되돌릴 수 있음 — 많은 migration을 롤백 가능(migrate ) ✓ 팀 친화적 — 스키마 변경이 일반 코드 리뷰 과정을 통해 흐름 ``` ## 유용한 명령과 개념 ```bash python manage.py showmigrations # 어떤 migration이 적용/보류 중인지 확인 python manage.py sqlmigrate blog 0002 # migration이 실행할 SQL 미리보기 python manage.py makemigrations --empty # 커스텀/데이터 변경용 빈 migration python manage.py migrate blog 0001 # 이전 migration으로 롤백 ``` ## 데이터 migration(스키마만이 아님) ```text migration은 RunPython 작업을 통해 데이터도 변환할 수 있음(예: 새 필드 채우기, 값 백필) — 스키마 변경에 수반되는 데이터 변경이 필요할 때 유용. ``` ## 왜 중요한가 migration은 Django의 데이터베이스 계층 작업에 필수적입니다. 데이터베이스 스키마를 Python model과 동기화 상태로 유지하는 중요한 문제를 안전하고 재현 가능하며 팀 친화적인 방식으로 해결합니다. 이를 이해하는 것은 기초적인 일상 지식입니다. `makemigrations` → `migrate` 워크플로는 모든 스키마 변경이 일어나는 방식(model을 변경하면 Django가 SQL을 생성하고 적용)이므로, 이것 없이는 데이터 기반 Django 앱을 개발할 수 없습니다. 핵심 가치는 migration이 스키마 변경을 **버전 관리**(코드와 함께 추적, PR에서 리뷰 가능)하고, **재현 가능**(모든 환경—각 개발자의 머신, staging, production—이 동일한 migration을 실행하여 동일한 스키마에 도달)하며, **안전**(Django가 오류 잦은 수동 `ALTER TABLE` 대신 올바르고 종종 되돌릴 수 있는 SQL을 생성)하게 만든다는 점입니다. 이는 스키마 드리프트, 일관성 없는 환경, 위험한 수동 데이터베이스 변경과 관련된 문제의 전체 범주를 제거합니다. 워크플로, migration이 소스 관리에 커밋된다는 점, 검사하고 롤백하는 방법, 그리고 migration이 **데이터 변환**(스키마뿐 아니라 데이터 백필/마이그레이션)도 처리할 수 있다는 점을 아는 것은 모든 실제 Django 프로젝트에 필요합니다. migration은 Django 팀이 프로젝트 수명 동안 데이터베이스 스키마를 협업적이고 안정적으로 발전시키는 방법으로, 핵심적이고 반드시 알아야 할 자료입니다.