Alembic 是一个由 SQLAlchemy 的作者创建的数据库迁移工具，主要用于 Python 应用程序中的数据库表结构的版本控制。Alembic 支持数据库表结构的更新，并且能够处理表结构的迁移（如添加、删除、修改表和列等）。

使用 Alembic，你可以：

  • 版本控制：跟踪数据库结构的变化，每次变更都会记录为一个版本。
  • 迁移脚本：编写迁移脚本来详细描述数据库结构的变化。这些脚本定义了如何从一个版本迁移到另一个版本，包括如何应用更新（升级）或如何撤销更新（降级）。
  • 自动化和手动迁移：Alembic 支持自动生成迁移脚本的功能，可以检测模型与数据库之间的差异并生成相应的迁移代码。然而，对于复杂的数据库变更，手动编写迁移脚本通常是必要的，以确保数据完整性和迁移的准确性。
  • 多环境部署：支持不同的数据库配置，适用于开发、测试和生产等多种环境。

Alembic 特别适合于动态和持续变化的数据库结构管理，它通过详细的迁移历史记录确保开发者可以准确地控制和追踪数据库结构的每一次变动。

使用 Alembic 更新数据库表结构通常包括以下步骤：

1. 初始化 Alembic

如果你的项目还没有使用 Alembic，你需要先初始化它。在项目的根目录下执行：

alembic init alembic

这个命令会创建一个名为 alembic 的目录，里面包含配置文件和迁移脚本目录。

2. 配置 Alembic

编辑 alembic.ini 文件以配置数据库的连接字符串。你可能还需要修改 env.py 文件来包含你的模型定义，这样 Alembic 可以在生成迁移脚本时访问你的模型。

3. 创建迁移脚本

当你的数据库模型（通常是 SQLAlchemy 模型）发生变化时，你需要创建一个新的迁移脚本来反映这些变化。这可以通过以下命令自动生成：

alembic revision --autogenerate -m "Add new column"

这个命令会检查当前数据库模型与数据库的现有结构之间的差异，并自动生成描述这些差异的迁移脚本。-m 参数用于为迁移提供一个描述性消息。

4. 编辑迁移脚本

自动生成的迁移脚本可能需要手动编辑以解决复杂的迁移需求或添加数据迁移逻辑。打开生成的迁移脚本文件（在 alembic/versions 目录下），根据需要修改 upgrade() 和 downgrade() 函数。

5. 应用迁移

一旦迁移脚本准备就绪，你可以使用以下命令应用迁移至数据库：

alembic upgrade head

这个命令将会运行所有未执行的迁移脚本，将数据库结构更新至最新版本。

6. 检查和验证

迁移完成后，你应该检查数据库确保所有变更都正确应用，并且没有数据丢失。可以通过运行测试或直接查询数据库来完成验证。

7. 版本回滚（可选）

如果需要撤销某个迁移，可以使用 downgrade 命令：

alembic downgrade -1

这将撤销最近的一次迁移。你可以通过指定具体的版本号来撤销到特定的版本。

这些步骤为你提供了使用 Alembic 管理和更新数据库结构的基本流程。在实际操作中，确保在正式环境之前在开发或测试环境中充分测试所有迁移。