flask 数据库迁移migration

本文介绍如何使用Flask-Migrate和Alembic实现数据库迁移,包括创建迁移脚本、应用更改及回滚等操作,并提供了详细的步骤指导。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

迁移

  • 封装随着时间的推移对我们的数据库模式所做的一组更改。

  • 被唯一命名

  • 通常作为 本地文件 存储 在我们的项目仓库中,例如 migrations/ 文件夹

  • 对我们的数据库所做的更改与 migrations/ 文件夹中存在的迁移文件之间应该存在 1-1 映射。

  • 迁移文件为数据库设置了表。

  • 对数据库所做的所有更改都应该作为我们存储库中迁移文件的一部分物理存在。

迁移命令行脚本

一般需要3个脚本,对于

  • migrate :创建迁移脚本模板填写;根据要进行的更改生成迁移文件
  • upgrade :应用尚未应用的迁移(“升级”我们的数据库)
  • rollback :回滚有问题的应用迁移(“降级”我们的数据库)

Flask + SQLAlchemy 的迁移库

Flask-Migrate & Flask-脚本

  • Flask-Migrate :迁移管理器,用于迁移基于 SQLALchemy 的数据库更改

  • Flask-Script :从终端运行我们定义的迁移脚本

进行迁移的步骤

  1. 初始化用于存储迁移的迁移存储库结构
  2. 创建迁移脚本(使用 Flask-Migrate)
  3. (手动)运行迁移脚本(使用 Flask-Script)

资源

迁移migration步骤:

  1. from flask_migrate import Migrate
  2. migrate = Migrate(app,db)
  3. 保存之后终端运行命令:flask db init 生成migration文件夹
  4. 去掉create_all()语句
  5. 修改数据库/数据表
  6. 运行命令行:flask db migrate
  7. 之后 自动在migration/version文件夹下生成哈希码为名字的文件
  8. 打开看看,选择合适的版本, flask db upgrade 或 flask db downgrade

总结

设置和运行迁移的总体步骤

  1. 数据库迁移命令 :migrate = Migrate(app,db),链接到 Flask 应用程序模型和数据库,链接到用于运行迁移的命令行脚本,设置文件夹以存储迁移(作为数据库的版本)
  2. 运行初始迁移为 SQLAlchemy 模型创建表 ,记录初始模式:flask db init ,替换使用 db.create_all()
  3. 迁移对我们的数据模型的更改
    • 更改 SQLAlchemy 模型
    • 运行 flask db migrate 以允许 Flask-Migrate 根据更改自动生成迁移脚本
    • 微调迁移脚本:migration/version文件夹下生成哈希码为名字的脚本
    • 运行迁移,也就是通过“upgrade”“downgrade”改变数据库

帮助文档

### 构建基于 Flask 的任务管理器应用程序 要构建一个带有数据库支持的任务管理器应用程序,可以通过以下方式实现: #### 1. 安装必要的依赖 首先需要安装 Flask 及其扩展来连接数据库并操作模型。以下是所需的包及其用途: - `Flask`:用于创建 Web 应用程序的核心框架。 - `SQLAlchemy`:作为 ORM 工具,简化数据库的操作。 - `pymysql` 或其他数据库驱动:用于连接特定类型的数据库。 通过以下命令安装这些依赖项[^3]: ```bash pip install Flask SQLAlchemy pymysql Flask-SQLAlchemy ``` --- #### 2. 配置 Flask 应用程序和数据库 在项目根目录下创建一个名为 `app.py` 的文件,并设置基本的 Flask数据库配置。例如: ```python from flask import Flask, render_template, request, redirect, url_for, flash from flask_sqlalchemy import SQLAlchemy from flask_migrate import Migrate # 初始化 Flask 应用 app = Flask(__name__) app.config['SECRET_KEY'] = 'your_secret_key_here' # 设置 SQLite 数据库 URL (可以根据需求替换为 MySQL/PostgreSQL) app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///tasks.db' app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False # 初始化数据库对象 db = SQLAlchemy(app) # 使用 Flask-Migrate 实现数据库迁移 migrate = Migrate(app, db) ``` 在此部分中,定义了一个 SQLite 数据库 URI 并禁用了修改跟踪功能[^2]。 --- #### 3. 定义任务模型 接下来,在同一文件中定义一个表示任务的数据模型类。该类继承自 `db.Model`,并通过 SQLAlchemy 提供的功能映射到数据库中的表格。 ```python class Task(db.Model): id = db.Column(db.Integer, primary_key=True) title = db.Column(db.String(80), nullable=False) description = db.Column(db.Text, nullable=True) completed = db.Column(db.Boolean, default=False) def __repr__(self): return f'<Task {self.title}>' ``` 此代码片段定义了一张包含任务 ID、标题、描述以及完成状态字段的表[^4]。 --- #### 4. 创建初始数据库 为了初始化数据库结构,需先导入上述模型,再运行以下命令以生成实际的 SQL 文件或更新现有架构: ```bash flask db init flask db migrate -m "Initial migration." flask db upgrade ``` 这组命令会自动根据模型的变化调整数据库布局。 --- #### 5. 添加路由逻辑 最后一步是在应用中加入若干视图函数以便于用户增删改查任务记录。比如新增一条待办事项可这样写: ```python @app.route('/add', methods=['POST']) def add_task(): title = request.form.get('title') description = request.form.get('description') new_task = Task(title=title, description=description) db.session.add(new_task) db.session.commit() flash(f'Task "{new_task.title}" added successfully!', category='success') return redirect(url_for('index')) ``` 同时也要设计前端页面配合提交表单等功能[^1]。 --- ### 总结 综上所述,利用 Flask 框架结合 SQLAlchemy 能够快速搭建起具备基础 CRUD 功能的任务管理系统。整个过程涉及环境准备、后端服务开发以及简单的界面渲染等多个方面。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值