Flask数据库迁移简单介绍

沈亦白
沈亦白
发布时间:2026-10-13| 4人浏览过
原创

本文介绍如何在Flask项目中利用Flask-Migrate插件实现数据库迁移。通过集成Flask-Script与Flask-SQLAlchemy,开发者可以像Django一样管理数据库结构变更。文章详细讲解了初始化迁移目录、提交修改以及升级和回退数据库的具体命令操作,并特别提示了SQLite3在列删除方面的限制。

前言

熟悉Django的开发者都知道,Django内置了ORM框架,功能丰富且集成了数据库迁移等特性。所谓ORM(对象关系映射),其核心在于简化SQL语句的编写,将关系型数据库中的表映射为Python类。这种方式显著降低了学习门槛,即使不熟悉SQL的程序员也能顺畅操作数据库,同时天然具备防止SQL注入的安全优势。在Flask中,我们可以使用flask-sqlalchemy包来实现这一功能。具体的使用方法官方文档已有清晰说明,读者可直接参考文档上手,本文重点在于讲解如何进行数据库迁移。

flask的小工具

从Django转向Flask时,最直观的差异在于服务启动方式:Flask可以直接运行代码启动服务,而Django通常需要使用runserver命令。至于哪种方式更优,取决于具体场景。这里推荐一个插件:flask-script,通过pip安装即可使用。

from flask_script import Manager
......
manager = Manager(app)
......
#app.run() #注释这句
manager.run()

使用该插件后,启动服务的命令变为:python main.py runserver

这看似多余,实则与下文要介绍的数据库迁移紧密相关。

数据库迁移

我们需要使用的插件是flask-migrate,安装该插件即可。

main.py

from flask import Flask
from flask_script import Manager
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate,MigrateCommand

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////opt/db.sqlite' #使用sqlite3数据库
db = SQLAlchemy(app) #ORM

migrate = Migrate(app,db)
manager = Manager(app)
manager.add_comman('db',MigrateCommand) #添加db 命令(runserver的用法)

#一个用户表
class User(db.Model):
...
...
省略

if __name__ == '__main__':
 manager.run()

至此,准备工作已完成。运行命令python main.py db init以创建数据表,这会在项目目录下生成migrations/目录,用于保存数据库每次变更的历史记录。

修改User类定义。

执行python main.py db migrate提交修改,随后运行python main.py db upgrade执行这些修改。

此时查看User表,结构已发生变化。

若需回退修改,可执行python main.py db downgrade。

需要注意一点:SQLite3无法删除包含数据的列,因此建议避免执行删除列的操作。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。