Flask-SQLAlchemy

Flask-SQLAlchemy 是 Flask 的一个扩展，它为你的应用程序添加了对 SQLAlchemy 的支持。该扩展旨在通过提供实用的默认设置和额外的辅助工具来简化在 Flask 中使用 SQLAlchemy 的过程，从而让完成常见任务变得更加容易。

Pallets 社区生态系统

[!IMPORTANT]
该项目属于 Pallets 社区生态系统的一部分。Pallets 是负责维护 Flask 的开源组织；而 Pallets-Eco 则旨在让社区能够共同维护 Flask 的扩展功能。如果您有兴趣参与该项目的维护工作，请通过 Pallets Discord 服务器 与我们联系。

简单示例

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column

app = Flask(__name__)
app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///example.sqlite"

class Base(DeclarativeBase):
  pass

db = SQLAlchemy(app, model_class=Base)

class User(db.Model):
    id: Mapped[int] = mapped_column(primary_key=True)
    username: Mapped[str] = mapped_column(unique=True)

with app.app_context():
    db.create_all()

    db.session.add(User(username="example"))
    db.session.commit()

    users = db.session.scalars(db.select(User))