一、 为什么读这本书？

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 Product
products = Product.query.all()

SQLAlchemy 2 版本的查询语句是：

from sqlalchemy import selectfrom models import Product
query = 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)