SuperAPI AI 工具集

alembic

数据与分析

查看项目

更新于 10-15 20:08

技能介绍

用途:Alembic 为 SQLAlchemy 项目提供数据库结构版本控制,管理迁移的生成、应用与回滚。

主要能力:支持自动生成迁移(revision --autogenerate)、检查待处理变更(check)、升级到最新或指定版本(upgrade head / upgrade <rev>)、回滚(downgrade -1 / downgrade base)、查看当前版本与历史(current、history、show)。支持分支迁移与合并(revision --branch-label、merge),支持数据迁移(在 upgrade 中执行 SQL),支持 SQLite 批处理模式(render_as_batch=True),并可通过 include_object、include_name、process_revision_directives 过滤或改写生成的迁移。

使用方式:先初始化 uv run alembic init alembic,配置 env.py 与 alembic.ini,再生成并应用迁移。异步 SQLAlchemy 需在 env.py 中使用 async_engine_from_config 与 asyncio.run。也可通过 Python API 调用 command.upgrade、command.revision 等。

适用场景:需要跟踪数据库结构变更、在团队或部署流程中同步 schema、执行数据回填的 SQLAlchemy 项目。

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