Django: model与makemigrations、migrate、syncdb详解

Migrations

Django中对Model进行修改是件麻烦的事情，syncdb命令仅仅创建数据库里还没有的表，它并不对已存在的数据表进行同步修改,也不处理数据模型的删除。 如果你新增或修改数据模型里的字段,或是删除了一个数据模型，你需要手动在数据库里进行相应的修改或者使用South。Django 1.7中已经集成了South的代码，提供了3个新命令：

• migrate: 用于执行迁移动作，具有syncdb的功能
• makemigrations: 基于当前的model创建新的迁移策略文件
• sqlmigrate: 显示迁移的SQL语句，具有sqlall的功能

使用起来很简单，对Model做了修改后，使用makemigrations记录修改：

1 2 3 4

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

你的Model会被扫描, 然后与migrations文件夹中以前的版本作比较, 然后生成本次迁移文件。

有了新的migration文件，就可以使用migrate修改数据库模式：

1 2 3 4 5 6 7 8 9 10 11

$ python manage.py migrate Operations to perform:    Synchronize unmigrated apps: sessions, admin, messages, auth, staticfiles, contenttypes    Apply  all  migrations: books Synchronizing apps without migrations:    Creating tables...    Installing custom SQL...    Installing indexes... Installed  0  object (s)  from  0  fixture(s) Running migrations:    Applying books. 0003_auto ... OK

也可以针对单独的app生成migration：

1	$ python manage.py makemigrations your_app_label

也可以对数据库中的数据进行修改，首先建立一个空的migration文件：

1	python manage.py makemigrations  - - empty yourappname

文件的内容如下：

1 2 3 4 5 6 7 8 9 10 11

# -*- coding: utf-8 -*- from  django.db  import  models, migrations   class  Migration(migrations.Migration):        dependencies  =  [          ( 'yourappname' ,  '0001_initial' ),      ]        operations  =  [      ]

如果想修改某个Model例如Person的数据，设置其name字段：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

# -*- coding: utf-8 -*- from  django.db  import  models, migrations   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):        dependencies  =  [          ( 'yourappname' ,  '0001_initial' ),      ]        operations  =  [          migrations.RunPython(combine_names),      ]

最后运行 python manage.py migrate即可。这样Person中的所有对象的name字段都设置好了。

依据Model修改关系数据库是开发中的一个重要的问题，解决这个问题可以提升开发速度，不过要在生产环境中随便使用migrate操作数据库还是很危险的，有时候需要手动修改数据库。

手动修改数据库

当处理模型修改的时候：

• 如果模型包含一个未曾在数据库里建立的字段，Django会报出错信息。 当你第一次用Django的数据库API请求表中不存在的字段时会导致错误。

• Django不关心数据库表中是否存在未在模型中定义的列。

• Django不关心数据库中是否存在未被模型表示的table。

添加字段

1. 在你的模型里添加字段。下例向Book模型添加num_pages字段：

   1 2 3 4 5 6 7 8 9

   class  Book(models.Model):      title  =  models.CharField(max_length = 100 )      authors  =  models.ManyToManyField(Author)      publisher  =  models.ForeignKey(Publisher)      publication_date  =  models.DateField()      * * num_pages  =  models.IntegerField(blank = True , null = True ) * *        def  __unicode__( self ):          return  self .title

2. 运行manage.py sqlall yourappname来测试模型新的CREATE TABLE语句。 

   1 2 3 4 5 6 7

   CREATE TABLE  "books_book"  (      "id"  serial NOT NULL PRIMARY KEY,      "title"  varchar( 100 ) NOT NULL,      "publisher_id"  integer NOT NULL REFERENCES  "books_publisher"  ( "id" ),      "publication_date"  date NOT NULL,      "num_pages"  integer NULL );

3. 开启你的数据库的交互命令界面(比如,psql或者mysql，或者可以使用manage.py dbshell。 执行ALTER TABLE语句来添加新列。

   1	ALTER TABLE books_book ADD COLUMN num_pages integer;

添加 非NULL 字段

先创建 NULL 型的字段，然后将该字段的值填充为某个默认值，然后再将该字段改为 NOT NULL 型

1 2 3 4 5

BEGIN; ALTER TABLE books_book ADD COLUMN num_pages integer; UPDATE books_book  SET  num_pages = 0 ; UPDATE books_book  SET  num_pages  =  NULL; COMMIT;

或者

1	ALTER TABLE <YourTable> ADD <NewColumn> <NewColumnType> NOT NULL DEFAULT <DefaultValue>;

添加ForeignKey或ManyToManyField

添加外键即是添加key_id的integer字段，添加多对多字段是创建一个新的数据表。

删除字段

比较简单，将表中的某列删掉即可

1	ALTER TABLE books_book DROP COLUMN num_pages;

使用sqlite3时，会有些麻烦，sqlite3不支持删除列操作，只有有限地 ALTER TABLE 支持。你可以使用它来在表的末尾增加一列，可更改表的名称。 如果需要对表结构做更复杂的改变，则必须重新建表。重建时可以先将已存在的数据放到一个临时表中，删除原表， 创建新表，然后将数据从临时表中复制回来。

如，假设有一个 t1 表，其中有 "a", "b", "c" 三列， 如果要删除列 c ：

1 2 3 4 5 6 7 8

BEGIN TRANSACTION; CREATE TEMPORARY TABLE t1_backup(a,b); INSERT INTO t1_backup SELECT a,b FROM t1; DROP TABLE t1; CREATE TABLE t1(a,b); INSERT INTO t1 SELECT a,b FROM t1_backup; DROP TABLE t1_backup; COMMIT;

删除多对多关联字段

删掉多对多关联的数据表即可

1	DROP TABLE books_book_authors;

删除模型

删除数据表即可

1	DROP TABLE books_book;

数据迁移

django 项目提供了一个导出的方法 python manage.py dumpdata, 不指定 appname 时默认为导出所有的app

1	python manage.py dumpdata myapp > myapp.json

导出的文件内容格式：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

[    {      "model" :  "myapp.person" ,      "pk" :  1 ,      "fields" : {        "first_name" :  "John" ,        "last_name" :  "Lennon"      }    },    {      "model" :  "myapp.person" ,      "pk" :  2 ,      "fields" : {        "first_name" :  "Paul" ,        "last_name" :  "McCartney"      }    } ]

数据导入：

1	python manage.py loaddata myapp.json

导出用户数据：

1	python manage.py dumpdata auth > auth.json

　　

最后：

数据库的命令稍有不慎可能就会掉坑。特别是migrate命令，由于django的数据库中包含了migrations的记录，如果migrations文件丢失，很可能造成migrate失败。所以有必要将migrations文件加入版本控制，保证开发时的migrations记录和文件相匹配。 
如果migrate出现了失败，很可能是因为migration文件包含的变更信息由于当前数据库的约束无法完完成。这时就应该去数据中找到这些记录或键的位置，删掉重做即可。一般这些数据存在的表为：外键约束对应的表、auth_permission、django_content_type和django_migrations.