django-south

本文主要是介绍django-south，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

pull的新工程(可行)：

第一步：python manage.py syncdb

第二步：python  manage.py convert_to_south youappname

第三步 ： ./manage.py migrate youappname （没必要）

对于新的整个工程，数据表未建立，但代码齐全（部署时），只需要 python manage.py syncdb 即可建立所有的表(看提示是否有app，initial)

1、安装完South之后，要在django项目中使用South，先要将South作为一个App导入项目，所以设置INSTALL_APP添加south 第一次使用South。

2、manage.py syncdb 用来创建south_migrationhistory表。

3、manage.py convert_to_south youappname #在youappname目录下面创建migrations目录以及第一次迁移需要的0001_initial.py文件

4、如果改变了model里的内容，./manage.py schemamigration youappname --auto #检测对models的更改

manage.py migrate youappnam #将更改反应到数据库（如果出现表已存在的错误，后面加 --fake）

如果第一次使用：
1、./manage.py schemamigration youappname --initial # youappname目录下面创建一个migrations的子目录（注意！！就算有多个app，也只要initial一个就可以）
2、./manage.py syncdb #初始化数据表等

#以后每次对models更改后，可以运行以下两条命令同步到数据库
3、./manage.py schemamigration youappname --auto #检测对models的更改
4、./manage.py migrate youappnam #将更改反应到数据库（如果出现表已存在的错误，后面加 --fake）

使用South之前铭记：请你一定要相信他的能力，抛弃对他的不信任感。因为South给人的第一印象就是好像每个操作都在抛异常。

South概述

* 针对django自带的syncdb同步models和数据库的缺陷开发的数据迁移工具，可以作为syncdb的替代，South能够检测对models的更改并同步到数据库.

South基本用法

* 安装完South之后，要在django项目中使用South，先要将South作为一个App导入项目，所以设置INSTALL_APP添加south

* 第一次使用South（对于已存在的项目转用South见下一步的介绍）

 

迁移到South

* 对于一个已存在的项目（定义了models，创建了相应的数据库，保存了响应的数据），这时想要使用South替代原来的syncdb只需要一些简单的步骤：

* 同样需要现在INSTALL_APP里面添加south，然后 python manage.py syncdb #syncdb已经被South更改，用来创建south_migrationhistory表

 

* 以后在这个项目中就可以正常使用South了

South同步原理

* 对应每次 models的更改执行schemamigration后会在migrations目录下面生成对应此次更改的py文件（South称之为 migrate），文件名形如0002_autodel_field_notes_create_user.py，同步数据库的时候会顺序（文件名 ASCII排序）执行这些py文件，文件里包含一个Migration的类，里面有两个方法forwards和backwards，将更改同步到数据库会 执行forwards方法，数据库操作失败会调用backwards实现rollback，South还提供了类似回溯的功能。

You can also specify a specific migration to migrate:* python manage.py migrate 0002_autodel_field_notes_create_user.pyNote that, if the system has already migrated past the specified migration, 
it will roll back to it instead. If you want to migrate all the way back, 
specify the special migration name zero:* python manage.py migrate zero 

常见问题

1. 添加和删除字段时可能会要求输入 default value（django里面models里面的许多字段默认都是null=False）
     对于添加字段，输入的默认值必须和models定义的类型匹配，否则同步数据库的时候会报错
     对于删除字段的情况，可以随意输入一个value而不管字段的默认类型，可以实现删除，但是并不可取，具体原因可以参见South的实现机制(rollback到删除字段之前会失败）。

2. 杀手锏
     如果South在同步数据库的过程中出现错误，则migrations目录下面对应此次更改的python文件不会被执行，可以运行python manage.py migrate --list查看没有执行的py文件，文件名前面没有*表示该文件对应的更改没有反应到数据库，只需删除掉这些有问题的migrate，参照错误提示修改 models再同步即可，也可以直接更改对应的py文件修复错误

这篇关于django-south的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

---