Python的Flask框架中使用Flask-Migrate擴(kuò)展遷移數(shù)據(jù)庫的教程
我們?cè)谏?jí)系統(tǒng)的時(shí)候，經(jīng)常碰到需要更新服務(wù)器端數(shù)據(jù)結(jié)構(gòu)等操作，之前的方式是通過手工編寫alter sql腳本處理，經(jīng)常會(huì)發(fā)現(xiàn)遺漏，導(dǎo)致程序發(fā)布到服務(wù)器上后無法正常使用。
現(xiàn)在我們可以使用Flask-Migrate插件來解決之，F(xiàn)lask-Migrate插件是基于Alembic，Alembic是由大名鼎鼎的SQLAlchemy作者開發(fā)數(shù)據(jù)遷移工具。
具體操作如下：
1. 安裝Flask-Migrate插件
$ pip install Flask-Migrate
db = SQLAlchemy(app)
migrate = Migrate(app, db)
manager = Manager(app)
manager.add_command('db', MigrateCommand)
3. 初始化
$ python app.py db init
使用Flask-Migrate遷移數(shù)據(jù)庫
隨著開發(fā)進(jìn)度不斷向前，你會(huì)發(fā)現(xiàn)你的數(shù)據(jù)庫模型需要更改，而當(dāng)這種情況發(fā)生時(shí)需要更新數(shù)據(jù)庫。
Flask-SQLAlchemy只有當(dāng)數(shù)據(jù)庫表不存在了才從模型創(chuàng)建它們，所以更新表的唯一途徑就是銷毀舊的表，當(dāng)然這將導(dǎo)致所有數(shù)據(jù)庫中的數(shù)據(jù)丟失。
有個(gè)更好的解決方案就是使用數(shù)據(jù)庫遷移框架。和源碼版本控制工具跟蹤更改源碼文件一樣，數(shù)據(jù)庫遷移框架跟蹤更改數(shù)據(jù)庫模型，然后將增量變化應(yīng)用到數(shù)據(jù)庫中。
SQLAlchemy的主要開發(fā)人員寫了一個(gè)Alembic遷移框架，但我們不直接使用Alembic，F(xiàn)lask應(yīng)用可以使用Flask-Migrate擴(kuò)展，一個(gè)集成了Flask-Script來提供所有操作命令的輕量級(jí)Alembic包。
4. 創(chuàng)建遷移倉(cāng)庫
首先，F(xiàn)lask-Migrate必須已經(jīng)安裝到虛擬環(huán)境中：
(venv) $ pip install flask-migrate
下面展示擴(kuò)展如何初始化：
from flask.ext.migrate import Migrate, MigrateCommand
# ...
migrate = Migrate(app, db)
manager.add_command('db', MigrateCommand)
為了可以使用數(shù)據(jù)庫遷移命令，F(xiàn)lask-Migrate提供MigrateCommand類來連接Flask-Script的manager對(duì)象。在這個(gè)示例中使用db來連接到命令。
在數(shù)據(jù)庫遷移可以維護(hù)之前，必須通過init子命令來創(chuàng)建一個(gè)遷移庫：
(venv) $ python hello.py db init
Creating directory /home/flask/flasky/migrations...done Creating directory /home/flask/flasky/migrations/versions...done Generating /home/flask/flasky/migrations/alembic.ini...done Generating /home/flask/flasky/migrations/env.py...done Generating /home/flask/flasky/migrations/env.pyc...done Generating /home/flask/flasky/migrations/README...done Generating /home/flask/flasky/migrations/script.py.mako...done Please edit configuration/connection/logging settings in '/home/flask/flasky/migrations/alembic.ini' before proceeding.
這個(gè)命令創(chuàng)建一個(gè)migrations文件夾，里面存放了所有遷移腳本。
建議：如果你有克隆在GitHub上的應(yīng)用程序，你現(xiàn)在可以運(yùn)行g(shù)it checkout 5c來切換到這個(gè)版本的應(yīng)用程序。
5. 創(chuàng)建遷移腳本
在Alembic，數(shù)據(jù)庫遷移工作由遷移腳本完成。這個(gè)腳本有兩個(gè)函數(shù)，分別叫做upgrade()和downgrade()。upgrade()函數(shù)實(shí)施數(shù)據(jù)庫更改，是遷移的一部分，downgrade()函數(shù)則刪除它們。通過添加和刪除數(shù)據(jù)庫變化的能力，Alembic可以重新配置數(shù)據(jù)庫從歷史記錄中的任何時(shí)間點(diǎn)。
Alembic遷移可以分別使用revision和migrate命令手動(dòng)或自動(dòng)創(chuàng)建。手動(dòng)遷移通過由開發(fā)人員使用Alembic的Operations對(duì)象指令實(shí)現(xiàn)的空upgrade()和downgrade()函數(shù)創(chuàng)建遷移框架腳本。另一方面，自動(dòng)遷移通過尋找模型定義和數(shù)據(jù)庫當(dāng)前狀態(tài)間的不同為upgrade()和downgrade()生成代碼。
警告：自動(dòng)遷移并不總是準(zhǔn)確的，可以忽略一些細(xì)節(jié)。所以應(yīng)該經(jīng)常審查一下自動(dòng)生成的遷移腳本。
migrate子命令創(chuàng)建自動(dòng)遷移腳本：
(venv) $ python hello.py db migrate -m "initial migration"
INFO [alembic.migration] Context impl SQLiteImpl. INFO [alembic.migration] Will assume non-transactional DDL. INFO [alembic.autogenerate] Detected added table 'roles' INFO [alembic.autogenerate] Detected added table 'users' INFO [alembic.autogenerate.compare] Detected added index 'ix_users_username' on '['username']' Generating /home/flask/flasky/migrations/versions/1bc 594146bb5_initial_migration.py...done
建議：如果你有克隆在GitHub上的應(yīng)用程序，你現(xiàn)在可以運(yùn)行g(shù)it checkout 5c來切換到這個(gè)版本的應(yīng)用程序。注意，你不需要為這個(gè)應(yīng)用生成migrations，所有的遷移腳本都包含在版本庫中。
6. 更新數(shù)據(jù)庫
一旦遷移腳本被審查且接受，就可以使用db upgrade命令更新到數(shù)據(jù)庫中：
(venv) $ python hello.py db upgrade
INFO [alembic.migration] Context impl SQLiteImpl. INFO [alembic.migration] Will assume non-transactional DDL. INFO [alembic.migration] Running upgrade None -> 1bc594146bb5, initial migration
第一次遷移實(shí)際上相當(dāng)于調(diào)用db.create_all()，但在后續(xù)遷移中，upgrade命令對(duì)表實(shí)施更新操作但不影響表中的內(nèi)容。
相關(guān)文章
基于Python編寫監(jiān)控視頻存儲(chǔ)計(jì)算器
這篇文章主要為大家詳細(xì)介紹了如何基于Python編寫一個(gè)監(jiān)控視頻存儲(chǔ)計(jì)算器,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2024-12-12
這篇文章主要為大家詳細(xì)介紹了如何通過Python語言實(shí)現(xiàn)一個(gè)簡(jiǎn)單的圖片背景移除工具，文中的示例代碼講解詳細(xì)，感興趣的小伙伴可以了解一下2023-02-02
Python xlrd excel文件操作代碼實(shí)例
這篇文章主要介紹了Python xlrd excel文件操作代碼實(shí)例,文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-03-03
PyCharm中關(guān)于安裝第三方包的三個(gè)建議
這篇文章主要介紹了PyCharm中關(guān)于安裝第三方包的三個(gè)建議，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-09-09
Pandas檢測(cè)None和Nan的實(shí)現(xiàn)方式
文章總結(jié)：Pandas中None（空值）和NaN（非數(shù)）需區(qū)分檢測(cè),isnull/isna用于識(shí)別缺失值,math.isnan檢測(cè)NaN,is運(yùn)算符或==檢測(cè)None,兩者概念不同,需根據(jù)場(chǎng)景選擇合適方法2025-09-09
這篇文章主要介紹了無法找到VS?Code?Python解釋器的幾種解決辦法,文中介紹了三種方法,并對(duì)比Python3.12.5與3.9.6版本的優(yōu)劣,需要的朋友可以參考下2025-05-05
這篇文章主要介紹了Python動(dòng)態(tài)語言與鴨子類型詳解,文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2019-07-07
Python+Selenium+PIL+Tesseract自動(dòng)識(shí)別驗(yàn)證碼進(jìn)行一鍵登錄
本篇文章主要介紹了Python+Selenium+PIL+Tesseract自動(dòng)識(shí)別驗(yàn)證碼進(jìn)行一鍵登錄，具有一定的參考價(jià)值，有興趣的可以了解下2017-09-09
django開發(fā)教程之利用緩存文件進(jìn)行頁面緩存的方法
緩存相信對(duì)各位程序員們來說都不陌生，下面這篇文章主要給大家介紹了關(guān)于django開發(fā)教程之利用緩存文件進(jìn)行頁面緩存的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，需要的朋友們可以參考借鑒，下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧。2017-11-11
Python單體模式的幾種常見實(shí)現(xiàn)方法詳解
這篇文章主要介紹了Python單體模式的幾種常見實(shí)現(xiàn)方法,結(jié)合實(shí)例形式分析了Python單體模式的實(shí)現(xiàn)方法、原理與相關(guān)注意事項(xiàng),需要的朋友可以參考下2017-07-07