理论课ch05配套实践:lab06_sqlalchemy_crud / lab07_flask_migrate(端口 5115 / 5129)

第5章 数据库存储(SQLAlchemy / 迁移)

授课:谢福财 · 每个知识点按「是什么 → 生活案例 → 代码对照 → 易错点」四步讲,课后对照同章的实践课手册动手。

一、这节课要学会什么

  1. 会用模型类描述一张表
  2. 掌握增删改查与分页
  3. 理解为什么需要迁移
  4. 会跑 init / migrate / upgrade

二、知识点逐个讲

1. 模型即表

一个类=一张表,一个属性=一列;db.create_all() 第一次运行把表建出来。

生活案例:Excel 表:表名是工作表,字段是表头,每行是一条记录。
class Student(db.Model): id = db.Column(db.Integer, primary_key=True) name = db.Column(db.String(20))
改了模型不迁移,旧库不会自己变。

2. 增删改查

add/commit 增,query 查,delete 删,改就是查到对象后改属性再 commit。

生活案例:记账本:写一行(add)、翻账(query)、划掉(delete),改数字要再签一次字(commit)。
db.session.add(s); db.session.commit() Student.query.filter_by(cls='Z260602').all()
忘记 commit,页面刷新数据就没了。

3. 分页

db.paginate(page=page, per_page=10) 只取当前页,模板里渲染上一页/下一页。

生活案例:看小说:一次只印 10 页,翻页按钮决定看哪 10 页。
page = db.paginate(db.select(Student).order_by(Student.id), page=p, per_page=10)
per_page 传 0 会报错;页数超出返回空列表。

4. 为什么需要迁移

直接改模型,已存在的表不会变;迁移把“改结构”变成可重复执行的脚本,还能回退。

生活案例:装修:不能把墙砸了重盖,要按图纸一步步改,还要留底稿(versions 文件)。
flask db init flask db migrate -m 'add email' flask db upgrade
线上库不要用 create_all 覆盖,会丢数据。

5. 迁移脚本长什么样

upgrade() 写“怎么加”,downgrade() 写“怎么退”,成对出现。

生活案例:电梯上/下行按钮:上去有路,下来也有路。
def upgrade(): op.add_column('students', sa.Column('email', sa.String(50))) def downgrade(): op.drop_column('students', 'email')
手改表结构后再 migrate 会冲突,先 downgrade 或重建。

三、课堂演示(本机实拍)

课堂演示:打开 lab06/app.py
课堂演示:没跑 upgrade 就访问,运行面板报 no such table

四、课堂练习

  1. 在 shell 里插入一条学生记录,刷新页面确认
  2. 把 per_page 改成 5,看分页变化
  3. 给模型加一个 age 字段,走一遍 migrate + upgrade
做完对着实践课手册第六节的报错实战自查一遍:能自己看懂红字,才算真的会。

五、小结与下一节

本节要点:会用模型类描述一张表、掌握增删改查与分页、理解为什么需要迁移。

下一节:第6章:代码怎么才能维护——工厂、蓝图、登录