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)典錯誤:
