South - 在 Django 中 Migrate Database

Web 开发避免不了经常修改表结构，手工修改表结构不仅容易出错，而且涉及到多人协作开发时，这么土的做法很不经济。

Django 的第三方 app South 就是专门做数据库表结构自动迁移的。Jacob Kaplan-Moss 曾做过一次调查，South 名列最受欢迎的第三方 app。事实上，它现在已经俨然成为 Django 事实上的数据库表迁移标准，很多第三方 app 都会带 South migrations 脚本。

South 最常用的功能要用起来也非常轻松。

安装配置

安装：

pip install South

修改 Django 项目的 settings 文件，在 INSTALLED_APPS 里追加 'south',。

创建初始版本信息

第 1 步，生成表结构的初始版本，执行下面的命令后，会自动创建 your_app/migrations 目录并生成0001_initial.py 脚本：

./manage.py schemamigration your_app --initial

第 2 步，如果数据库中已经存在 your_app 的表结构，则需要通过 --fake 命令告诉 South：

./manage.py migrate your_app --fake

若不存在，用下面命令在数据库中创建表结构：

./manage.py migrate your_app

增加 Model 字段

为 your_app/models.py 增加字段后，执行下面的命令 South 会自动比对 0001_initial.py 并生成0002_auto__xxxx.py：

./manage.py schemamigration your_app --auto

下面的命令便是立即修改数据库，使新的表结构版本生效：

./manage.py migrate your_app

其它说明

日常使用基本上就是这些命令，South 能做的当然还不只这些，还可以用它来做表格字段的重命名、生成迁移依赖关系图、单元测试集成等等，官方文档写的非常仔细：http://south.readthedocs.org/

另外，原来部署只需要执行 ./manage.py syncdb，集成 South 后需要多做一步 ./manage.py migrate，自动应用所有 app 的表结构迁移脚本。

另一篇博客

我们在用 Django 开发系统的时候常会遇到一个问题， 那就是资料库的栏位在开发的过程中有可能会更动，接著我们执行 syncdb 后会发现，原先存在的 model 在修改栏位后并不会更新到资料库。手动修改资料库栏位太过麻烦，但在资料库中有资料的时候我们又不想整个砍掉重练。这时候 South 就派上用场了。

South 可以自动帮我们搞定资料库 migrate 这件麻烦的工作，且可以让资料库做到版本控制。接下来的内容会简单介绍一下 South 的使用方法。




首先我们需要安装 south 这个模组。

pip install South

设定
把 south 加到 settings.py 的 INSTALLED_APPS 中
建立 south 的歷史纪录
 python manage.py syncdb
在 app 中使用 south
 python manage.py convert_to_south <app_name>
完成后会发现在专案目录下多出一个migrations资料夹，裡面会有个0001_initial.py档案，表示已经成功转换成south了。


使用
当修改完 schema 需要做 migrate 时，执行
 python manage.py schemamigration <app_name> <migration_name> --auto
这个指令会自动检查栏位的更动，并询问一些问题，完成后在 migrations 目录下会出现<version#>_<migration_name>.py
修改到资料库
 python manage.py migrate 


回复之前版本
在每次执行完 schemamigration 后，migrate 目录下的版本号 <version#> 会从 0001, 0002 一直增加上去 。 当需要回复到先前的版本时，只要执行
 python manage.py migrate <app_name> <version#>
完成后，资料库就会回到先前的版本了
但切到栏位少的版本再切回来...资料表中消失的资料当然是不会再回来的XD