django [Django 09] DB Migration

1. DB Migration

Django에서 Model 클래스를 생성하고 난 후, 해당 모델에 상응하는 테이블을 데이타베이스에서 생성할 수 있다. Python 모델 클래스의 수정 (및 생성 )을 DB에 적용하는 과정을 Migration이라 부른다. 이는 Django가 기본적으로 제공하는 ORM (Object-Relational Mapping) 서비스를 통해 진행된다.

Django 모델 클래스로부터 테이블을 생성하기 위해서는 크게 Migration을 준비하는 과정과 이를 적용하는 과정으로 나뉘는데, 구체적으로는 다음과 같은 절차를 따른다.

1. settings.py 파일 안의 INSTALLED_APPS 리스트에 (만약 이미 추가되지 않았다면) 해당 Django App (예: feedback)을 추가한다.
2. 모델 클래스로부터 테이블 스키마를 생성 혹은 수정하기 위하여 아래 명령을 실행한다. 이 명령이 실행되면 해당 Django App 안에 migrations 라는 서브폴더를 만들고 테이블 생성 및 수정을 위한 파이썬 마이크레이션 파일들을 생성한다.

   $ ./manage.py makemigrations
   

3. 모델 클래스로부터 실제 DB에 테이블을 생성하거나 수정하기 위해 아래 명령을 실행한다. 이는 실제 Migration을 DB에 적용하는 명령이다.

   $ ./manage.py migrate
   

아래 그림은 앞에서 만든 Feedback 모델을 DB로 Migration하는 과정이다. Migration에 의해 생성되는 테이블은 "App명_ModelClass명"의 형식으로 생성되는데, 예를 들어 feedback App의 모델 Feedback에 대해 feedback_feedback 이라는 테이블이 생성된다.

이전 버전의 Django (1.6 이하)에서는, Django 모델 수정에 따라 테이블을 변경하는 Migration 기능을 제공하지 않았다. 즉, Alter Table 하는 기능이 없었으며, 모델이 수정되었을 경우 테이블을 Drop하고 다시 Create해야 했다. 아래는 1.6 이하에 사용하던 명령으로 새로 Table을 생성하는 명령이다.

$ ./manage.py syncdb

경축! 아무것도 안하여 에스천사게임즈가 새로운 모습으로 재오픈 하였습니다.
어린이용이며, 설치가 필요없는 브라우저 게임입니다.
https://s1004games.com

2. DB 관리 Shell

데이타베이스 관리를 위해 "manage.py dbshell" 명령을 사용할 수 있다. Migration이 완료되면 아래와 같이 dbshell 을 사용하여 생성된 테이블과 테이블의 컬럼 정보, 혹은 테이블 내용 등을 확인할 수 있다.

$ ./manage.py dbshell

3. DB 설정

Django 에서 사용하는 DB 에 대한 정보는 Django 프로젝트의 settings.py 파일에 설정되어 있다. Django 프로젝트가 생성되면 기본적으로 설정되어 있는 셋팅은 아래와 같다. 데이타베이스는 디폴트로 sqlite3 를 사용하고, 파일명은 /db.sqlite3 로 지정되어 있다.

DATABASES 에는 반드시 "default"가 설정되어야 하며, 뒤에 다른 DB 설정도 추가할 수 있다. Django 프레임워크은 현재 (v1.9) 기본적으로 다음과 같은 DB 엔진을 지원하고 있는데, DB 설정의 "ENGINE" 키에 해당 DB 엔진 값을 지정할 수 있다. (주: 3rd Party에 지원하는 DB 엔진을 사용할 수도 있다)

• django.db.backends.postgresql
• django.db.backends.mysql
• django.db.backends.sqlite3
• django.db.backends.oracle

DB 설정은 각 DB 엔진마다 서로 다른 옵션을 지정한다. 예를 들어, 아래는 MySQL에 대한 연결 정보를 담은 DB 설정의 예이다.