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