理论课ch05配套实践:lab06_sqlalchemy_crud / lab07_flask_migrate(端口 5115 / 5129)
第5章 数据库存储(SQLAlchemy / 迁移)
授课:谢福财 · 每个知识点按「是什么 → 生活案例 → 代码对照 → 易错点」四步讲,课后对照同章的实践课手册动手。
一、这节课要学会什么
- 会用模型类描述一张表
- 掌握增删改查与分页
- 理解为什么需要迁移
- 会跑 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
四、课堂练习
- 在 shell 里插入一条学生记录,刷新页面确认
- 把 per_page 改成 5,看分页变化
- 给模型加一个 age 字段,走一遍 migrate + upgrade
做完对着实践课手册第六节的报错实战自查一遍:能自己看懂红字,才算真的会。
五、小结与下一节
本节要点:会用模型类描述一张表、掌握增删改查与分页、理解为什么需要迁移。
下一节:第6章:代码怎么才能维护——工厂、蓝图、登录