SuperAPI AI 工具集

alembic

通用与其它

查看项目

更新于 10-16 08:42

技能介绍

用途:Alembic 是面向 SQLAlchemy 项目的数据库迁移工具,为数据库 schema 提供版本控制,适合需要跟踪和管理数据库结构变更的 Python 项目。

主要能力:支持从模型变更自动生成迁移(alembic revision --autogenerate -m "Add user table")、检查待处理变更(alembic check)、升级到最新或指定版本(alembic upgrade head / alembic upgrade ae1027a6acf)、降级(alembic downgrade -1 / alembic downgrade base)、查看当前版本与历史(alembic current / alembic history / alembic show)。支持手动迁移操作,如增删列、重命名表、创建索引和约束;支持 SQLite 的 batch 模式(render_as_batch=True);支持对象过滤(include_object、include_name)、自定义迁移处理(process_revision_directives)、数据迁移、分支迁移与合并。

使用方式:先安装依赖(pip install alembic sqlalchemy,异步 PostgreSQL 需 pip install asyncpg,异步 MySQL 需 pip install aiomysql),在项目中执行 alembic init alembic 初始化,配置 env.py 与 alembic.ini,再生成并应用迁移。也可通过 Python API 以编程方式运行迁移(command.upgrade、command.revision)。

适用场景:SQLAlchemy 项目的 schema 版本管理、异步 SQLAlchemy 环境、多分支开发、需要数据迁移或自定义迁移逻辑的场景。

限制:资料要求 Python 3.8+、SQLAlchemy 2.0+、Alembic 1.8+;支持 PostgreSQL/MySQL/SQLite;SQLite 迁移需启用 batch 模式。其他平台、收费与效果信息暂未提供。