線上更新

1. alembic init <YOUR_DIR># 此處，我用的是alembic_v

2.修改alembic.ini。如下：

sqlalchemy.url = driver://user:[email protected]:port/dbname
	具體例項：
	sqlalchemy.url = mysql+mysqldb://storage:[email protected]/storagemgmt
解釋：
此部分替換成對應的資料庫連線，這個資料庫連線的寫法是與SQLAlchemy建立engine時是一樣的。

比如使用SQLAlchemy與mysqldb，那資料庫連線就是如上“具體例項所示”。
 

import osimport sys# 此處需要將專案路徑新增到sys.path，否則from import時找不到
modelssys.path.append(os.path.dirname(os.path.abspath(__file__)) + "/../")
from models.base import Base
Modeltarget_metadata = BaseModel.metadata

解釋：在env.py中，將target_metadata設定成專案的model，使alembic能獲取到專案中model定義的資訊
 

/usr/lib/python2.7/site-packages/storagemgmt/storage/sqlalchemy/models.py

4. 建立新的版本。

alembic revision --autogenerate -m "init db"

解釋：用 alembic revision -m+註釋 建立資料庫版本. “版本號+註釋”就是版本檔案的名字。
	這個命名規則是在配置檔案中定義的。

5.更新資料庫。

alembic upgrade head

6.將資料庫降級到最初版本.

alembic downgrade base
 

7.將資料庫降級到執行版本，

使用alembic downgrade+版本號，不包含註釋部分.

alembic downgrade <version>
如: alembic downgrade 0e8e73745ff2

離線更新

在某些不適合線上更新的情況，可以採用生成sql指令碼的形式，進行離線更新：

alembic upgrade <version> --sql > migration.sql
如：

alembic upgrade ae1027a6acf --sql > migration.sql
從特定起始版本生成sql指令碼：

alembic upgrade <vsersion>:<vsersion> --sql > migration.sql
如：

alembic upgrade 1975ea83b712:ae1027a6acf --sql > migration.sql
如果是資料庫降級操作，把upgrade替換為downgrade。

Reference: