在开发过程中,由于需求变更或者自我重构,需要清理migrations,以保持代码整洁和后续的可维护性。
场景一
不考虑数据库数据表,可以完全清空数据库里面的表的数据。
步骤:
删除所有migrations
find . -path "/migrations/.py" -not -name "init.py" -delete
find . -path "/migrations/.pyc" -delete
删除数据库的相关表
python manage.py makemigrations yourappname
python manage.py migrate yourappname
场景二
保留原有数据表的情况
这个情况是开发中最为常见的,也是操作起来稍微复杂一点的情况,但是只要遵循下面的操作步骤,就不会引发任何错误:
1.检查migrations文件夹下面的修改记录文件是否与数据库保持一致,如若我们执行这个命令
python manage.py makegrations
执行结果显示:
No changes detected
那我们就可以继续执行下面的步骤
2.查看当前项目下所有APP对应的已经生效的(已经成功执行的)migration文件,命令如下:
python manage.py showmigrations
结果如下图所示,前面的[x]表示已经执行过的文件,如:imooc这个APP下执行过两次操作
admin[X] 0001_initial[X] 0002_logentry_remove_auto_add
auth[X] 0001_initial[X] 0002_alter_permission_name_max_length[X] 0003_alter_user_email_max_length[X] 0004_alter_user_username_opts[X] 0005_alter_user_last_login_null[X] 0006_require_contenttypes_0002[X] 0007_alter_validators_add_error_messages[X] 0008_alter_user_username_max_length
contenttypes[X] 0001_initial[X] 0002_remove_content_type_name
imooc[X] 0001_initial[X] 0002_auto_20190122_0929
sessions[X] 0001_initial
3.重置你的APP的操作,使它们恢复到没有执行的状态,这里注意一下fake前面的符号,是两个“-”,另外,imooc是APP的名字,记得将它替换成你的APP名字。还有一点就是不要直接复制,要手敲到终端才不会因格式问题而产生错误。fake参数该怎样理解呢?fake是假装的意思,在这里我们可以理解为假设我们将这些操作设置为没有执行的状态,而不是他们真的没有执行!
python manage.py migrate --fake imooc zero
结果如下,则显示重置成功
(wprkplace) D:\PythonProject\learn>python manage.py migrate --fake imooc zero
Operations to perform:Unapply all migrations: imooc
Running migrations:Rendering model states... DONEUnapplying imooc.0005_hua... FAKEDUnapplying imooc.0004_xiao... FAKEDUnapplying imooc.0003_ming... FAKEDUnapplying imooc.0002_auto_20190122_0929... FAKEDUnapplying imooc.0001_initial... FAKED
然后我们可以再次执行showmigrations的命令,查看一下各个操作的状态
(wprkplace) D:\PythonProject\learn>python manage.py showmigrations
admin[X] 0001_initial[X] 0002_logentry_remove_auto_add
auth[X] 0001_initial[X] 0002_alter_permission_name_max_length[X] 0003_alter_user_email_max_length[X] 0004_alter_user_username_opts[X] 0005_alter_user_last_login_null[X] 0006_require_contenttypes_0002[X] 0007_alter_validators_add_error_messages[X] 0008_alter_user_username_max_length
contenttypes[X] 0001_initial[X] 0002_remove_content_type_name
imooc[ ] 0001_initial[ ] 0002_auto_20190122_0929[ ] 0003_ming[ ] 0004_xiao[ ] 0005_hua
sessions[X] 0001_initial
可以看到imooc这个APP下面的操作全部重置为没有执行的状态,[x]变成了[ ],注意是假设它没有执行!
4.然后放心大胆地删除migrations文件夹下面,除了__init__.py文件,的所有的带有序号的py文件,包括pycache文件夹!
5.执行下面的命令,再次为这个APP 生成 0001_initial.py 之类的文件
python manage.py makemigrations
提示如下则为成功
(wprkplace) D:\PythonProject\learn>python manage.py makemigrations
Migrations for 'imooc':imooc\migrations\0001_initial.py:- Create model Hua- Create model Ming- Create model Post- Create model Tag- Create model Test- Create model Xiao
6.执行下面的命令,使刚刚生成的0001_initial.py文件记录到django_migrations数据表中,这个表是django自动生成的,用于记录每次执行的数据库修改操作,表中有四个字段,name和app是对应的关系,意为某某APP下的某某操作。
python manage.py migrate --fake-initial
结果如下即为成功
(wprkplace) D:\PythonProject\learn>python manage.py migrate --fake-initial
Operations to perform:Apply all migrations: admin, auth, contenttypes, imooc, sessions
Running migrations:Applying imooc.0001_initial... FAKED
如果你再去看一下django_migrations这个表,你会发现这个表添加了一条记录,一般来说如果我们真的执行了数据库的修改操作才会生成这样一条记录,但是我们用了fake这个“假装”的操作,所以其实仅仅是添加了一条记录而已,并没有实际修改数据表,也就是这样,完成了migrations文件夹的重置!
需要保留数据里面的数据,这种场景最为常见,只改结构不改数据
步骤:
使用migrate命令回滚0001_initial的migration history,回滚到最初
python manage.py migrate --fake yourappname zero
重新生成0001_initial,如果能保证已有0001_initial已是最新的,可跳过此步
find . -path "/migrations/.py" -not -name "init.py" -delete
find . -path "/migrations/.pyc" -delete
python manage.py makemigrations yourappname
在数据库中生成新的0001_initial记录
python migrate --fake-initial yourappname
另外,对于已经长期运行的项目,为了保留历史重大版本,不建议回到最初的版本,不利于版本控制。
如果中间有报错:
Django Table xxx already exist
python manage.py migrate --fake appname