什么是 Alembic?
Alembic 是 SQLAlchemy 官方推荐的 数据库迁移工具,主要作用是:
-
跟踪数据库的结构(表、字段、索引)变化
-
生成迁移脚本(如创建新表、字段)
-
应用这些脚本到数据库中
https://www.49855.net/sqlalchemy
安装 Alembic
pip install alembic
典型使用流程举例
1、初始化 Alembic(仅第一次)
alembic init alembic
2、修改模型(如添加字段)
3、生成迁移脚本
alembic revision –autogenerate -m “add user table”
4、升级数据库结构
alembic upgrade head
这条命令的意思是:
把数据库“升级”到最新的迁移版本(也就是
head
版本)
-
upgrade
:表示“向前迁移” -
head
:表示“迁移历史中最新的版本头”
它会执行项目中 alembic/versions/
目录下的所有迁移脚本,直到最新版为止。
基础指令
命令 | 含义 |
---|---|
alembic upgrade head |
把数据库结构更新到最新版本 |
alembic downgrade -1 |
回退上一个版本 |
alembic history |
查看迁移历史 |
alembic current |
显示当前数据库的版本状态 |