15. Migrations - chohankyun/python-django-study GitHub Wiki

##Migrations
모델의 변경을 데이터베이스에 적용 해주는 방법
DB 스키마 버전 관리 시스템
app/migrations 폴더 및에 migration file 생성 및 DB 에 적용
MIGRATION_MODULES 설정으로 폴더를 변경 할 수 있음

###명령어

• migrate : migration file 의 내용을 DB 에 적용 시킨다.
• makemigrations : 모델을 바탕으로 migration file 을 만든다.
• sqlmigrate : migration file 을 읽어서 SQL 문으로 보여준다.
• showmigrations : DB 에 적용된 migrations file 을 보여준다.

###작업 흐름

• model 생성, 수정, 삭제
• makemigrations 명령어 실행

makemigrations

$ python manage.py makemigrations
Migrations for 'books':
  books/migrations/0003_auto.py:
  - Alter field author on book

• 현재의 migrations file 비교
• 업데이트 된 migrations file 생성
• migrate 명령어 실행

migrate

$ python manage.py migrate
Operations to perform:
  Apply all migrations: books
Running migrations:
  Rendering model states... DONE
  Applying books.0003_auto... OK

• database 에 적용

####특정 model 만 적용
makemigrations --name 사용

$ python manage.py makemigrations --name changed_my_model your_app_label

###버전 관리 migration 버전 관리 정보가 저장된다.

• migration file 의 번호는 개발자 참조용
• migration file 의 파일명에 의존

migration file 이 같은 app 에 적용 될때

• 문제가 없다고 생각되면 그냥 실행하면 자동으로 순서되로 적용
• 문제가 있다고 생각되면 수정해서 적용

###의존성

• migration file 안에 있는 dependencies 에 있는것이 적용된 이후 적용

###migration file
migratios 폴더에 저장

from django.db import migrations, models

class Migration(migrations.Migration):

    dependencies = [("migrations", "0001_initial")]

    operations = [
        migrations.DeleteModel("Tribble"),
        migrations.AddField("Author", "rating", models.IntegerField(default=0)),
    ]

django.db.migrations.Migration

• Migration 실행
• 원래는 4개의 속성 존재
• 대부분 2개의 속성만 사용
• dependencies : 의존성 리스트
• operations : migration 대상 선언, sql 생성시 참조

migration file 을 수동으로 생성 할 수 있다,
하지만 가능하면 수동으로 처리 하지 말것을 권장

###Model managers
RunPython 명령을 수행 하기 위해서 Manager 객체를 직렬화해서 migration 에 포함 시킨다.
Manage 객체를 직렬화 하려면 use_in_migrations = True 를 설정 한다.
(언제 쓰는지 모르겠다?)

class MyManager(models.Manager):
    use_in_migrations = True

class MyModel(models.Model):
    objects = MyManager()

###Inital migrrations
DB의 테이블 생성을 위한 최초 migration 파일을 만드는 것
최초 migrrations file

initial = True

DB 테이블이 만들어진 상태에서 최초의 migration 적용 하는 법

 migrate --fake-initial 

###특정 App 에만 migration 적용

$ python manage.py makemigrations your_app_label

• model 이 변경되지 않은 상에서 migration 을 적용 하려면, intial migration 을 먼전 수행 한다.
• 수동으로 DB 를 변경하지 마라

###model field 주의

• system_check_deprecated_details
• system_check_removed_details

###Data Migrations

• RunPython 을 사용해서 어렵지 않게 data migration

####작업 흐름
####비어있는 migration file 생성

python manage.py makemigrations --empty yourappname  

####migration file 열기

# -*- coding: utf-8 -*-
# Generated by Django A.B on YYYY-MM-DD HH:MM
from __future__ import unicode_literals  

from django.db import migrations, models

class Migration(migrations.Migration):
    initial = True

    dependencies = [
        ('yourappname', '0001_initial'),
   ]

    operations = [
   ]

####RunPython 을 사용한 Data Migration
RunPython 에서 호출 할 function 작성 function 아규먼트

• apps : 모든 app
• schema_editor : DB 수정 스키마

다음은 first_name 과 last_name 을 합하는 것

# -*- coding: utf-8 -*-
from __future__ import unicode_literals

from django.db import migrations, models

def combine_names(apps, schema_editor):
    # We can't import the Person model directly as it may be a newer
    # version than this migration expects. We use the historical version.
    Person = apps.get_model("yourappname", "Person")
    for person in Person.objects.all():
        person.name = "%s %s" % (person.first_name, person.last_name)
        person.save()

class Migration(migrations.Migration):
    initial = True

    dependencies = [
        ('yourappname', '0001_initial'),
    ]

    operations = [
        migrations.RunPython(combine_names),
    ]

####python manage.py migrate 실행