flask_migrate

flask_migrate

1.      flask_migrate

doc: https://flask-migrate.readthedocs.io/en/latest/

1.1.    简介

在使用falsk_sqlalchemy时，采用db.create_all()创建表，但在后期修改数据库表字段的时候，修改部分不会自动的映射到数据库中，必须删除表然后重新创建；否则就只能手动sql修改表结构了。

这样当然不好用，flask-migrate就是为了解决这个问题。它可以在每次修改模型（class）后，执行相应命令将修改的字段映射到数据库中。

1.2.    install/uninstall

pip install Flask-Migrate

pip uninstall Flask-Migrate

1.3.    使用

有两种调用方式，flask db init,  python manage.py db init

后一种方式用得比较多。

案例：

#!/usr/bin/env python

#coding:utf-8

 

from app import create_app, db

from flask_migrate import Migrate, MigrateCommand

from flask_script import Manager

import app.models # 没有循环引用，可以直接引用

app = create_app()

manager = Manager(app)

migrate = Migrate(app, db)

manager.add_command('db', MigrateCommand)

if __name__ == '__main__':

manager.run()

pass

    #run_app()

然后执行以下3条命令：

创建迁移仓库(migrations目录)，就是初始化：

python manager.py  db init

读取类的内容, 生成版本文件, 并没有真正在数据库中添加或删除;

python manage.py  db migrate -m "添加性别"

python manage.py db migrate

在数据库中增删改;

python manage.py  db upgrade

其它命令：

去查看改变的历史状态;

python manage.py  db history

返回指定的版本状态;

python manage.py  db downgrade  base

2.      实验

2.1.    修改models.py并同步到数据库

修改roles，添加字段

add_comments = db.Column(db.String(200), nullable=True)

执行命令：

python manage.py db migrate

可以查看日志中有

INFO  [alembic.autogenerate.compare] Detected added column 'roles.add_comments'

提交到数据库, python manage.py db upgrade 输出日志

INFO  [alembic.runtime.migration] Running upgrade 136f6a80c853 -> cc904c7ceb92, empty mes

sage

结果验证：

sql_txt = "show columns from roles;"

[('id', 'int(11)', 'NO', 'PRI', None, 'auto_increment'), ('name', 'varchar(64)', 'YES', 'UNI', None, ''), ('add_comments', 'varchar(200)', 'YES', '', None, '')]

结果验证2：python manage.py  db history

136f6a80c853 -> cc904c7ceb92 (head), empty message

<base> -> 136f6a80c853, empty message