【后端开发-Flask】Windows 开发环境下使用 Flask-Migrate 和工厂模式实现数据库迁移

在 Flask 应用开发中，数据库迁移是维护和更新数据库模式的重要部分。Flask-Migrate 提供了一个高效的方式来处理 SQLAlchemy 数据库迁移。本文将深入讨论如何在 Windows 开发环境下，结合 Flask 应用工厂模式使用 Flask-Migrate，同时介绍 alembic_version 表的作用。

工厂模式简介

工厂模式是 Flask 中一种常用的应用结构，它允许你以函数的形式创建和配置 Flask 应用。这种模式提供了更高的灵活性，特别是在大型应用或需要多个配置环境时。

一个简单的工厂函数示例如下：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

migrate = Migrate()
db = SQLAlchemy()

def create_app(config_filename):
    app = Flask(__name__)
    app.config.from_pyfile(config_filename)

    db.init_app(app)
    migrate.init_app(app, db)

    # 在此处注册蓝图、插件等

    return app

在这个结构中，db 和 migrate 实例在应用外部创建并通过工厂函数初始化，这有助于实现更好的应用配置管理和重用。

设置环境变量

在 Windows 环境中，使用命令提示符或 PowerShell 设置 FLASK_APP 环境变量，指向你的 Flask 应用。例如，如果你的应用入口文件名为 run.py：

在命令提示符中：

set FLASK_APP=app.py

在PowerShell中：

$env:FLASK_APP = "app.py"

使用Flask-Migrate

在应用中集成 Flask-Migrate 后，使用以下命令初始化迁移目录，生成迁移脚本，并应用迁移：

初始化迁移环境，这将创建一个 migrations 目录，用于存放迁移脚本：

flask db init
当数据模型发生变化时，通过以下命令生成迁移脚本：
flask db migrate -m "Initial migration."
将生成一个新的迁移脚本在 migrations/versions 目录下。
将迁移应用到数据库，执行：
flask db upgrade

理解 alembic_version 表

数据库中发现了一个不属于数据模型的表——
alembic_version 表是由 Alembic（Flask-Migrate 的底层库）自动创建的，用于跟踪数据库迁移的版本。每当你执行一个迁移操作时，Alembic 会更新这个表中的 version_num 字段，以记录当前数据库模式的版本。

这个机制使得 Alembic 能够识别当前数据库模式与迁移脚本之间的差异，从而决定需要执行哪些迁移来更新或回滚数据库模式。这对于维护数据库的一致性以及跟踪历史变更至关重要。

总结

使用 Flask-Migrate 结合工厂模式可以有效管理 Flask 应用的数据库迁移。通过合理使用 alembic_version 表来跟踪迁移历史，你可以确保数据库模式的一致性和可追溯性。在 Windows 环境下设置正确的环境变量并遵循上述步骤，将帮助你顺利实现数据库迁移，为你的 Flask 应用提供坚实的数据支持。