South - 在 Django 中 Migrate Database

时间:2023-03-09 18:27:55
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