Alembic 是一个轻量级的数据库迁移工具，用于 SQLAlchemy。它允许开发者编写和执行对数据库模式的更改，这样可以跟踪和管理数据库的版本。

功能说明：

1. 版本控制：Alembic 允许你为数据库模式创建版本。每次你更改模式时，都会创建一个新的版本。
2. 自动检测模型更改：Alembic 可以自动检测模型与当前数据库模式之间的差异，并为你生成迁移脚本。
3. 手动编辑迁移：生成的迁移脚本可以手动编辑，以满足特定的需求或修复自动生成的代码。
4. 支持多个数据库后端：Alembic 支持 SQLAlchemy 支持的所有主要数据库。
5. 支持分支和合并：你可以创建多个独立的迁移路径，并在需要时合并它们。

基本用法：

1.初始化：首先，你需要初始化 Alembic 配置。

alembic init alembic

2.配置：编辑生成的 alembic.ini 文件，特别是 SQLAlchemy 的数据库 URL。

3.生成迁移：当你的模型发生更改时，使用以下命令生成一个迁移脚本。

alembic revision --autogenerate -m "Description of changes"

4.编辑迁移：在 versions 目录下，你会找到一个新生成的迁移文件。你可以打开它并进行任何必要的编辑。

5.应用迁移：使用以下命令应用迁移到数据库。

alembic upgrade head

6.回滚迁移：如果需要撤销迁移，可以使用以下命令。

alembic downgrade -1

7.查看历史：要查看迁移历史，使用：

alembic history

8.创建新的迁移

自动生成迁移：如果你已经更改了 SQLAlchemy 模型并希望 Alembic 自动生成与这些更改相对应的迁移，可以使用以下命令：

alembic revision --autogenerate -m "Description of your changes"

这将会检查你的模型与当前数据库的差异，并为这些更改创建一个新的迁移脚本

手动创建迁移：如果你想手动创建一个迁移，而不是基于模型的自动更改，可以使用：

alembic revision -m "Description of your changes"

这将创建一个新的迁移文件，但不会自动填充任何更改。你需要手动编辑这个文件，添加你想要的迁移操作。

编辑迁移脚本：无论是自动生成还是手动创建，新的迁移脚本都会在 versions 目录下生成。你可以打开这个文件并查看或编辑 upgrade() 和 downgrade() 函数。upgrade() 函数定义了如何应用这个迁移，而 downgrade() 函数定义了如何撤销它。

应用迁移：创建迁移后，你可以使用以下命令将其应用到数据库：

alembic upgrade head

记住，每次创建新的迁移时，都要为其提供描述性的消息（通过 -m 选项），这有助于其他开发者了解每个迁移的目的和内容。