《SQLAlchemy 2 In Practice》读后感
一、 为什么读这本书?
1.平时工作中用的都是 SQLAlchemy 1 的语法,因为 SQLAlchemy 2 发布已经有好长一段时间了,也是未来的趋势,所以想了解一下SQLAlchemy 2 的语法。
2.个人觉得 SQLAlchemy 的文档很混乱,经常找不到自己想要的内容,想了解一下其它人是怎么使用文档的。
基于以上两个目的,鉴于作者(Miguel Grinberg) 之前写过一本《Flask Web Development》(中译版是《Flask Web开发:基于Python的Web应用开发实战》),个人觉得还行,所以就选择该书作为了解 SQLAlchemy 2 语法的切入点。
二、这本书写了什么?
本书总共包含 8 个章节。
第 1 章:Database Setup
介绍如何在项目中使用常见的关系型数据库,如:SQLite, MySQL, PostgreSQL。
第 2 章:Database Tables
介绍数据库表的操作,以及常见的 CRUD 操作。个人觉得本章是本书写得最好的一章,也是最具有实战意义的一章。查询操作示例:
SQLAlchemy 1 版本的查询语句是:
from models import Productproducts = Product.query.all()
SQLAlchemy 2 版本的查询语句是:
from sqlalchemy import select
from models import Productquery = select(Product)
result = session.execute(query)
products = result.scalars().all()
第 3 章: One-To-Many Relationships
介绍一对多关系,平时工作中用的最多。
第 4 章: Many-To-Many Relationships
介绍多对多关系,中规中矩。
第 5 章: Advanced Many-To-Many Relationships
介绍一些高级的多对多关系用法,平时工作中用的相对较少。
第 6 章: A Page Analytics Solution
本章写得不好,在实际项目中或者复杂的项目中很少这样使用。
第 7 章:Asynchronous SQLAlchemy
鉴于本人在实际工作中并未这样实用过,无法判断其用法是好的还是不好的,本章不评价。
第 8 章: SQLAlchemy and the Web
介绍在 Flask、FastAPI 中集成 SQLAlchemy,写得不好,在实际项目中或者复杂的项目中很少这样使用。
从 2025 年 6 月 21 日至 2025 年 7 月 2 日,期间断断续续花了 8 天阅读完《SQLAlchemy 2 In Practice》。
三、这本书特点
1.逻辑结构清晰,行文流畅
虽然这本书是作者自己出版的,但是作者是一个很负责的人,整本书逻辑结构清晰,总共 8 个章节,由易到难,逐渐递进。行文流畅,让读者阅读起来非常丝滑,基本讲明白了“为什么有这个东西,怎么用这个东西”。所以整本书 200 多页,我只花了 8 天就读完了。
2.内容简单
正因为第一个特点——“逻辑结构清晰,行文流畅”,所以其实我个人希望作者能多写一点,能更深入一点。这可能跟作者对本书的定位有关,可能作者想写的就是一本入门书。
3.缺乏工程性
以最后一章为例,如果后端使用 Flask, 那么最好是使用 flask-migrate, 不然数据库迁移就会变成非常麻烦。这也是作者所有的书给我的一种感觉,作者的很多写法没有错,但严格来说,充其量只能算作 demo,缺乏工程性,很难应用到大型项目中(或者说在大型项目中这样的代码还需要优化)。
四、这本书适合什么样的人?
在阅读本书的过程中,解决了我一直以来非常不理解的两个问题:
1.flask-sqlalchemy 文档开头的两行代码到底想表达什么?
class Base(DeclarativeBase):pass
因为之前在 Flask 项目中直接使用的是 Flask-SQLAlchemy, 一直没看到这两行代码的应用,导致我一直不理解这两行的代码想表达什么。看完这本书我懂了,其实 Base 就是 Model,在 SQLAlchemy 中 model 必须显示继承 DeclarativeBase,至于 Flask-SQLAlchemy 为什么要在开头加这两句,不得而知,个人觉得没有必要。不过这已经不重要了,已经知道 sqlalchemy 的规则就可以了。
2.既然已经提供了 ForeignKey, 为什么还要使用 relationship() 呢?
ForeignKey 作用于数据库层面, relationship() 作用于 ORM 层面。
回到“为什么读这本书?”,对于“想了解一下SQLAlchemy 2 的语法”——本书已经解决了我的问题;对于“想了解一下其它人是怎么使用文档的”——个人还是觉得 SQLAlchemy 文档的返回和排版做得不好,阅读的时候,应该牢牢抓住“Content”这个页面(https://docs.sqlalchemy.org/en/20/contents.html)。
总体而言,本书写得还行,相对简洁,属于入门级教材,适合想对 SQLAlchemy 语法有所了解的初学者。
五、推荐指数
按照 5 星的标准,本书推荐指数 3 颗星。
六、参考资料
1. 编程
(1)豆瓣,Miguel Grinberg,《SQLAlchemy 2 In Practice》:https://book.douban.com/subject/36482906/
(2)源码,Github:https://github.com/miguelgrinberg/retrofun
2. 英语
(1) Etymology Dictionary:https://www.etymonline.com
(2) Cambridge Dictionary:https://dictionary.cambridge.org
欢迎搜索及关注:编程人(a_codists)