alembic教程:

alembic教程:

alembic是sqlalchemy的作者開發(fā)的。用來做OMR模型與數(shù)據(jù)庫的遷移與映射。alembic使用方式跟git有點了類似,表現(xiàn)在兩個方面,第一個,alembic的所有命令都是以alembic開頭;第二,alembic的遷移文件也是通過版本進(jìn)行控制的。首先,通過pip install alembic進(jìn)行安裝。以下將解釋alembic的用法:

1、初始化alembic倉庫:

????在終端中,cd到你的項目目錄中,然后執(zhí)行命令alembic init alembic,創(chuàng)建一個名叫alembic的倉庫。

2、創(chuàng)建模型類:

????創(chuàng)建一個models.py模塊,然后在里面定義你的模型類,示例代碼如下:

from sqlalchemy import Column,Integer,String,create_engine,Text

from sqlalchemy.orm import sessionmaker

from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

classUser(Base):

????__tablename__ ='user'

????id = Column(Integer,primary_key=True)? ?

????username = Column(String(20),nullable=False)? ?

????password = Column(String(100),nullable=False)

classArticle(Base):

????__tablename__ ='article'

????id = Column(Integer,primary_key=True)? ?

????title = Column(String(100),nullable=False)? ?

????content = Column(Text, nullable=False)

3、修改配置文件:

在alembic.ini中設(shè)置數(shù)據(jù)庫的連接,sqlalchemy.url = driver://user:pass@localhost/dbname,比如以mysql數(shù)據(jù)庫為例,則配置后的代碼為:

? sqlalchemy.url = mysql+mysqldb://root:root@localhost/alembic_demo?charset=utf8

為了使用模型類更新數(shù)據(jù)庫,需要在env.py文件中設(shè)置target_metadata,默認(rèn)為target_metadata=None。使用sys模塊把當(dāng)前項目的路徑導(dǎo)入到path中:

import os import sys?

sys.path.append(os.path.dirname(os.path.abspath(__file__)) +"/../")

from models import Base?

...#省略代碼

target_metadata = Base.metadata # 設(shè)置創(chuàng)建模型的元類

...#省略代碼

4、自動生成遷移文件:

使用alembic revision --autogenerate -m "message"將當(dāng)前模型中的狀態(tài)生成遷移文件。

5、更新數(shù)據(jù)庫:

使用alembic upgrade head將剛剛生成的遷移文件,真正映射到數(shù)據(jù)庫中。同理,如果要降級,那么使用alembic downgrade head。

6修改代碼后,重復(fù)4~5的步驟。

7、命令和參數(shù)解釋:

init:創(chuàng)建一個alembic倉庫。

revision:創(chuàng)建一個新的版本文件。

--autogenerate:自動將當(dāng)前模型的修改,生成遷移腳本。

-m:本次遷移做了哪些修改,用戶可以指定這個參數(shù),方便回顧。

upgrade:將指定版本的遷移文件映射到數(shù)據(jù)庫中,會執(zhí)行版本文件中的upgrade函數(shù)。如果有多個遷移腳本沒有被映射到數(shù)據(jù)庫中,那么會執(zhí)行多個遷移腳本。

[head]:代表最新的遷移腳本的版本號。

downgrade:會執(zhí)行指定版本的遷移文件中的downgrade函數(shù)。

heads:展示head指向的腳本文件版本號。

history:列出所有的遷移版本及其信息。

current:展示當(dāng)前數(shù)據(jù)庫中的版本號。

另外,在你第一次執(zhí)行upgrade的時候,就會在數(shù)據(jù)庫中創(chuàng)建一個名叫alembic_version表,這個表只會有一條數(shù)據(jù),記錄當(dāng)前數(shù)據(jù)庫映射的是哪個版本的遷移文件。

經(jīng)典錯誤:


?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容