《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 版本的查询语句是：

1. from models import Product
3. products = Product.query.all()

复制代码

SQLAlchemy 2 版本的查询语句是：

1. from sqlalchemy import select
2. from models import Product
4. query = select(Product)
5. result = session.execute(query)
6. 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 文档开头的两行代码到底想表达什么？

1. class Base(DeclarativeBase):
2.   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)