当前位置：首页 > news >正文

Flask SQLAlchemy 技术指南

news 2025/8/5 10:28:04

文章目录

- - 什么是 Flask SQLAlchemy？
  - 安装 Flask SQLAlchemy
  - 创建 Flask 应用和数据库模型
  - 添加和查询数据
  - 运行 Flask 应用
  - 总结
  - - **数据库迁移（Database Migrations）**
    - **复杂查询**
    - **关系模型**
    - **事务处理**
    - **性能优化**
    - **安全性**
    - **扩展功能**

Flask SQLAlchemy 是 Flask 框架的一个扩展，它提供了 ORM（对象关系映射）功能，使得在 Flask 应用中与数据库交互变得更加简单和直观。本文将介绍 Flask SQLAlchemy 的基本用法，并通过示例代码展示如何使用它进行数据库建模和查询操作。
在这里插入图片描述

什么是 Flask SQLAlchemy？

Flask SQLAlchemy 是一个将 SQLAlchemy 集成到 Flask 应用中的扩展。SQLAlchemy 是一个功能强大的 ORM 库，支持多种数据库后端，包括 SQLite、PostgreSQL、MySQL 等。通过 Flask SQLAlchemy，我们可以使用 Python 类和对象来操作数据库，而无需编写大量的 SQL 语句。

安装 Flask SQLAlchemy

在开始之前，我们需要安装 Flask 和 Flask SQLAlchemy：

pip install Flask
pip install Flask-SQLAlchemy

创建 Flask 应用和数据库模型

我们将创建一个简单的 Flask 应用，并定义一个用户（User）模型，该模型包含用户的姓名和年龄等信息。

from flask import Flask
from flask_sqlalchemy import SQLAlchemyapp = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///example.db'  # 使用 SQLite 数据库
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False  # 关闭跟踪修改db = SQLAlchemy(app)# 定义 User 模型
class User(db.Model):__tablename__ = 'users'  # 表名id = db.Column(db.Integer, primary_key=True)  # 主键name = db.Column(db.String(50), nullable=False)  # 用户姓名age = db.Column(db.Integer)  # 用户年龄def __repr__(self):return f'<User {self.name}>'  # 重写字符串表示# 创建数据库和表
@app.before_first_request
def create_tables():db.create_all()  # 创建所有表

添加和查询数据

现在我们可以向数据库中添加数据，并查询数据。在下面的示例中，我们将添加一个用户，并查询所有用户。

@app.route('/add_user/<name>/<int:age>')
def add_user(name, age):user = User(name=name, age=age)  # 创建 User 对象db.session.add(user)  # 添加到会话db.session.commit()  # 提交到数据库return f'Added user {name} with age {age}'@app.route('/get_users')
def get_users():users = User.query.all()  # 查询所有用户users_list = [f'Name: {user.name}, Age: {user.age}' for user in users]  # 转换为字符串列表return '<br>'.join(users_list)  # 返回 HTML 格式的用户列表