alembic 如何使用？

在之前的数据库操作中，我们新增一个字段是不是每次都得删除数据库表，然后再重新将新创建的数据库表映射到数据库中。这样操作是不是很蛋疼？是吧？于是sqlalchemy作者拜尔为了解决这一问题，开发了alembic这一迁移工具。

alembic 作用：

方便数据库与ORM模型的迁移与映射。

alembic 安装：

pip install alembic

alembic 用法：

1、第一步

先创建好ORM模型（alembic跟sqlalchemy一样，独立于flask而存在的！所以，我们创建一个纯python文件即可），代码如下：

from sqlalchemy import create_engine,Column,String,Integer
from sqlalchemy.ext.declarative import declarative_base

DIALCT = "mysql"
DRIVER = "pymysql"
USERNAME = "root"
PASSWORD = "admin"
HOST = "127.0.0.1"
PORT = "3306"
DATABASE = "alembic_demo"

DB_URI = "{}+{}://{}:{}@{}:{}/{}?charset=utf8".format(DIALCT,DRIVER,USERNAME,PASSWORD,HOST,PORT,DATABASE)
engine = create_engine(DB_URI)
Base = declarative_base(engine)

class User(Base):
    __tablename__ = "user"
    id = Column(Integer , primary_key=True , autoincrement=True)
    name = Column(String(50) , nullable=False)

Base.metadata.drop_all()
Base.metadata.create_all()

2、第二步

打开CMD窗口，进入到我们当前项目虚拟环境中，截图如下：

3、第三步

创建一个alembic仓库，输入以下命令：

alembic init alembic

注：第一个alembic是alembic语法，类似git。第二个init代表初始化，第三个alembic代表仓库名，你也可以命名其它名字，这里为了方便理解，所以采用了alembic这一名字

完成上述命令后，然后进入pycharm编辑器中，我们就可以看到我们的项目下多了一个alembic文件和alembic.ini文件

4、第四步

找到alembic.ini配置文件，修改sqlalchemy.url，代码如下：

sqlalchemy.url = mysql+pymysql://root:admin@localhost/alembic_demo

注：和数据库连接信息一样

5、第五步

找到env.py文件，修改target_metadata参数

代码如下：

import os
import sys
import alembic_demo

# 把当前项目路径加入到path中
sys.path.append(os.path.dirname(os.path.dirname(__file__)))

target_metadata = alembic_demo.Base.metadata

6、第六步：

创建数据库迁移文件，命令如下：

alembic revision --autogenerate -m "first commit"

运行该命令，出现下方信息说明迁移文件创建成功

创建成功会在version目录下创建一个迁移文件，截图如下（前面377...ad这段代表迁移版本号，后面first_commit代表迁移信息）：

注：alembic映射到数据库流程如下

ORM模型 ——迁移文件——映射到数据库中

7、第七步：

将迁移文件映射到数据库中，命令如下：

alembic upgrade head

运行上述命令，如果出现下方信息，说明成功映射到表中

不信，我们再查查查看下数据库表，结果如下：

OK，数据库表已成功映射到数据库中。

步骤很多，但只要你多敲几遍，你就会熟悉掌握alembic的用法。当然，如果你实在记不住，再看看我的这篇博文。