第 7 章:数据库:模型、会话与迁移
ORM 省掉的是拼 SQL,不是替你管事务。会话什么时候提交、什么时候关,才是真正要盯的地方。
学习目标
- 会定义模型与关系,并选对字段类型
- 明白
db.session与请求的关系,不再到处手动 commit - 会用 Flask-Migrate 做版本化迁移,而不是
create_all - 认出 N+1、会话泄漏这两个最常见的问题
7.1 先决定用不用 ORM
| 用 ORM | 直接写 SQL |
|---|---|
| 表结构随代码演进,需要迁移 | 复杂报表、多表联查、窗口函数 |
| 数据操作以对象方式表达 | 性能敏感的热点查询 |
| 中小规模、团队协作 | 已有 DBA 与 SQL 规范 |
两者可以共存:主流程用 ORM,复杂查询用 text() 写原生 SQL。
python
from sqlalchemy import text
rows = db.session.execute(text("SELECT region, SUM(amount) FROM orders GROUP BY region"))7.2 初始化
python
# app/extensions.py
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate
db = SQLAlchemy()
migrate = Migrate()python
# app/__init__.py
app.config["SQLALCHEMY_DATABASE_URI"] = os.environ.get("DATABASE_URL", "sqlite:///app.db")
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False
db.init_app(app)
migrate.init_app(app, db)
SQLALCHEMY_DATABASE_URI的驱动写法随 SQLAlchemy 2.x 有变化(如postgresql+psycopg://),以官方文档为准。SQLite 只适合开发与小型单机。
7.3 模型与关系
python
class User(db.Model):
__tablename__ = "users"
id = db.Column(db.Integer, primary_key=True)
email = db.Column(db.String(120), unique=True, nullable=False, index=True)
created_at = db.Column(db.DateTime, server_default=db.func.now())
orders = db.relationship("Order", back_populates="user", lazy="select")
class Order(db.Model):
__tablename__ = "orders"
id = db.Column(db.Integer, primary_key=True)
user_id = db.Column(db.Integer, db.ForeignKey("users.id"), nullable=False, index=True)
amount_cents = db.Column(db.Integer, nullable=False)
user = db.relationship("User", back_populates="orders")四条经验:
- 表名显式写:
__tablename__不写会用类名推导,改名时容易和迁移对不上; - 外键一定加索引:联查与过滤都靠它;
- 金额用整数存分,别用浮点;
- 时间用
DateTime+ 服务端默认值,别在 Python 里算时区。
7.4 会话:什么时候提交
Flask-SQLAlchemy 3.x 的默认行为:
- 每个请求一个 session,请求结束自动
remove; - 不会自动 commit(autocommit 模式早已废弃)。
所以要么显式提交,要么在请求结束时统一提交:
python
@app.post("/orders")
def create_order():
order = Order(user_id=1, amount_cents=9900)
db.session.add(order)
db.session.commit() # 显式
return {"id": order.id}, 201事务边界建议:一个业务动作一次 commit。别在循环里 commit,也别把整个请求包成一个巨型事务。
7.5 查询
python
from sqlalchemy import select
# 单条
user = db.session.execute(select(User).where(User.email == "a@b.com")).scalar_one_or_none()
# 列表 + 排序 + 限制
orders = db.session.execute(
select(Order).where(Order.user_id == 1).order_by(Order.id.desc()).limit(20)
).scalars().all()
# 分页(Flask-SQLAlchemy 提供)
page = db.paginate(select(Order).order_by(Order.id.desc()), page=1, per_page=20)User.query 这种老写法仍可用,但 3.x 官方推荐 select() 风格,新代码别再用旧的。
7.6 迁移:别再 create_all
bash
flask db init # 只做一次,生成 migrations/
flask db migrate -m "add orders table"
flask db upgrade # 应用到数据库三条纪律:
- 迁移脚本要进仓库,它和代码是同一份历史;
- 自动生成的脚本必须人工看:删列、改类型它经常猜错;
- 生产升级前先备份,
upgrade不是可逆的。
create_all 只适合"本地一次性造表",它不会记录版本,也没法应付后续变更。
7.7 两个高频问题
| 问题 | 表现 | 修法 |
|---|---|---|
| N+1 查询 | 页面一慢,日志里同一条 SQL 刷几十次 | 提前 selectinload / joinedload 预加载关系 |
| 连接泄漏 | 跑一阵开始报 too many connections | 检查是否有自己建 session 的后台线程;确认 teardown 会 remove |
N+1 的写法对比:
python
# 差:每条 order 都再查一次 user
orders = db.session.execute(select(Order)).scalars().all()
for o in orders:
print(o.user.email) # 每次触发一次查询
# 好:一次带出来
orders = db.session.execute(
select(Order).options(db.joinedload(Order.user)
).scalars().all()本章小结
| 要点 | 说明 |
|---|---|
| ORM 选择 | 主流程 ORM,复杂查询用原生 SQL |
| 模型 | 显式表名、外键索引、金额存分、时间用 DateTime |
| 会话 | 每请求一个,不自动 commit,显式提交 |
| 事务 | 一个业务动作一次 commit,失败要 rollback |
| 查询 | select() 风格,分页用 db.paginate |
| 迁移 | init / migrate / upgrade,脚本进仓库并人工检查 |
| 性能 | 用 joinedload / selectinload 避免 N+1 |
下一章
测试与部署:怎么给这套结构写测试,以及从 Gunicorn 到 Nginx 的上线流程。