4.3 數據庫遷移

在開發過程中，需要修改數據庫模型，而且還要在修改之後更新數據庫。最直接的方式就是刪除舊表，但這樣會丟失數據。

更好的解決辦法是使用數據庫遷移框架，它可以追蹤數據庫模式的變化，然後把變動應用到數據庫中。

在Flask中可以使用Flask-Migrate擴展，來實現數據遷移。並且集成到Flask-Script中，所有操作通過命令就能完成。

為了導出數據庫遷移命令，Flask-Migrate提供了一個MigrateCommand類，可以附加到flask-script的manager對象上。

首先要在虛擬環境中安裝Flask-Migrate。

pip install flask-migrate

文件：database.py

#coding=utf-8
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate,MigrateCommand
from flask_script import Shell,Manager

app = Flask(__name__)
manager = Manager(app)

app.config[‘SQLALCHEMY_DATABASE_URI‘] = ‘mysql://root:[email protected]:3306/Flask_test
 
‘
app.config[‘SQLALCHEMY_COMMIT_ON_TEARDOWN‘] = True
app.config[‘SQLALCHEMY_TRACK_MODIFICATIONS‘] = True
db = SQLAlchemy(app)

#第一個參數是Flask的實例，第二個參數是Sqlalchemy數據庫實例
migrate = Migrate(app,db) 

#manager是Flask-Script的實例，這條語句在flask-Script中添加一個db命令
manager.add_command(‘db‘,MigrateCommand)

#定義模型Role
class
 
 Role(db.Model):
    # 定義表名
    __tablename__ = ‘roles‘
    # 定義列對象
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(64), unique=True)
    def __repr__(self):
        return ‘Role:‘.format(self.name)

#定義用戶
class User(db.Model):
    __tablename__ = ‘users‘
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(64), unique=True, index=True)
    def __repr__(self):
        return ‘User:‘.format(self.username)
if __name__ == ‘__main__‘:
    manager.run()

創建遷移倉庫

#這個命令會創建migrations文件夾，所有遷移文件都放在裏面。
python database.py db init

創建遷移腳本

自動創建遷移腳本有兩個函數，upgrade()函數把遷移中的改動應用到數據庫中。downgrade()函數則將改動刪除。自動創建的遷移腳本會根據模型定義和數據庫當前狀態的差異，生成upgrade()和downgrade()函數的內容。對比不一定完全正確，有可能會遺漏一些細節，需要進行檢查

#創建自動遷移腳本
python database.py db migrate -m ‘initial migration‘

更新數據庫

python database.py db upgrade

回退數據庫

回退數據庫時，需要指定回退版本號，由於版本號是隨機字符串，為避免出錯，建議先使用python database.py db history命令查看歷史版本的具體版本號，然後復制具體版本號執行回退。

python database.py db downgrade 版本號

Flask之數據庫遷徙