【Python】Flask框架系列（四）：Flask-Migrate数据库迁移

参考：flask数据库迁移理解及命令

Flask-Migrate

使用数据库迁移，可以直接建表，而不用我们自己写sql语句用来建表。就是将关系型数据库的一张张表转化成了Python的一个个类。

在开发中经常会遇到需要修改原来的数据库模型，修改之后更新数据库，最简单粗暴的方式就是删除旧表，然后在增加新表，这样做的缺点是会造成数据丢失。

使用数据库迁移，可以追踪数据库模式的变化，然后把变动应用到数据库中。

在flask中使用Flask-Migrate来实现数据库迁移，并且集成到Flask-Script中，所有的操作通过命令来完成。

为了导出数据库迁移命令，Flask-Migrate使用了一个MigrateCommand类，可以附加到Flask-Script的manager对象上。

迁移示例

1、创建迁移仓库

原始food表

希望新增一列

class Food(UserMixin, db.Model):__tablename__ = 'food'id = db.Column(db.Integer, primary_key=True)name = db.Column(db.String(64))addcol = db.column(db.String(64)) # 新增

全部代码 app.py

#coding:utf-8
from flask import Flask
from flask_migrate import Migrate, MigrateCommand
from flask_script import Managerfrom flask_sqlalchemy import SQLAlchemyfrom flask_login import UserMixinapp = Flask(__name__)
app.config['SECRET_KEY'] = 'hard to guess string'
app.config['SQLALCHEMY_DATABASE_URI'] ='mysql+pymysql://root:g67108864@127.0.0.1:3306/flask1?charset=utf8'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = Falsedb = SQLAlchemy(app)
manager = Manager(app)# 第一个参数是flask实例，第二个参数SQLAlchemy实例
Migrate(app, db)#manager是Flask-Script的实例，这条语句在flask-Script中添加一个db命令
manager.add_command("db", MigrateCommand)class Role(db.Model):__tablename__ = 'roles'id = db.Column(db.Integer, primary_key=True)name = db.Column(db.String(64), unique=True)users = db.relationship('User', backref='role', lazy='dynamic')class User(UserMixin, db.Model):__tablename__ = 'users'id = db.Column(db.Integer, primary_key=True)email = db.Column(db.String(64), unique=True, index=True)username = db.Column(db.String(64), unique=True, index=True)role_id = db.Column(db.Integer, db.ForeignKey('roles.id'))password_hash = db.Column(db.String(128))class Food(UserMixin, db.Model):__tablename__ = 'food'id = db.Column(db.Integer, primary_key=True)name = db.Column(db.String(64))addcol = db.Column(db.String(64)) addcol1 = db.Column(db.String(64))# db.create_all()@app.route("/")
def index():return "index"if __name__ == '__main__':manager.run()

运行python app.py db init
命令中的db是上面24行manager.add_command("db", MigrateCommand)设置的，也可以将db改成其他名称
这个命令会创建migrations文件夹，所有迁移文件都放在里面。只是创建了迁移仓库，表还没创建。
（配图因为我之前init过一次了，所以最后一行error）

运行后，看到生成migrations

2、创建迁移脚本

自动创建迁移脚本有两个函数
upgrade()：函数把迁移中的改动应用到数据库中。
downgrade()：函数则将改动删除。
自动创建的迁移脚本会根据模型定义和数据库当前状态的差异，生成upgrade()和downgrade()函数的内容。
对比不一定完全正确，有可能会遗漏一些细节，需要进行检查

运行：python app.py db migrate -m 'XXX注释'

运行命令之后，只是在migrations文件夹中新增了数据库迁移的版本文件并没有在数据库也只是创建了版本号，并没有生成对应的表。

文件内容如下

3、更新数据库

更新数据库命令：python app.py db upgrade

数据库中可以看到已经创建表成功了。同时生成了一个alembic_version表，貌似是版本控制的。

总结

一点小坑和心得

一个大小写错误，查了半小时

不要看到错误就复制去百度搜，得自己阅读一下错误信息啊

而且，不要总是忽略warning，有时候warning也很重要啊。。