1. SQLAlchemy数据访问工程导论

在真实的后端系统里，数据访问层（Data Access Layer，DAL）承担着把业务逻辑与数据库细节隔离开的职责。它要处理连接、事务、SQL 生成、结果映射、异常转换等一系列问题。如果每个项目都手写这些内容，代码会迅速变得难以维护。SQLAlchemy 正是为解决这类问题而生的 Python 数据库工具包，它既提供接近 SQL 的底层能力，也提供面向对象的高层抽象。本课程的目标，是让你从"会用 SQLAlchemy"进阶到"能工程化地设计和维护数据访问层"。

SQLAlchemy 在数据访问层中的定位

要理解 SQLAlchemy 的价值，先要看清它在整个应用架构中的位置。一个典型的分层结构是：表现层接收请求，业务层处理规则，数据访问层负责持久化，最下面是数据库驱动和数据库本身。SQLAlchemy 位于数据访问层内部，向上为业务代码提供统一的 Python 接口，向下通过 DBAPI（如 psycopg2、pymysql、sqlite3）与具体数据库通信。

它的核心作用可以概括为三点：第一，统一接口，同一套代码可以切换 SQLite、PostgreSQL、MySQL 等不同后端；第二，管理连接与事务，通过连接池和 Session 控制资源生命周期；第三，表达查询与映射，既可以用 Python 表达式构造 SQL，也可以把表行映射为对象。这意味着业务代码不必关心"这条 SQL 是哪个数据库方言"，也不必手动拼接字符串。

Core 与 ORM 双引擎架构

SQLAlchemy 最容易被误解的一点，是把它简单等同于 ORM。实际上它由两个层次组成：Core 和 ORM。Core 是基础，ORM 构建在 Core 之上。

Core 提供的是"SQL 的 Python 表达"。它的关键对象包括：Engine（连接与方言的入口）、Connection（一次数据库会话）、MetaData（表结构集合）、Table（表定义）、Column（列定义），以及 select()、insert()、update()、delete() 等语句构造器。用 Core 写查询，你得到的是显式的 SQL 结构，执行结果以行（Row）的形式返回。它适合批量操作、复杂 SQL、报表查询等场景。

ORM 则在 Core 之上增加了"对象关系映射"。它引入 DeclarativeBase、映射类、Session、relationship() 等概念，把数据库表映射为 Python 类，把行映射为对象实例。ORM 的价值在于：用面向对象的方式表达关联关系、级联操作和身份映射（Identity Map），让业务代码更自然。但 ORM 并不是"不用写 SQL"，它最终仍会生成 SQL 交给 Core 执行。

理解这层关系很重要：ORM 是 Core 的上层封装，而不是替代品。在工程实践中，二者常常混用——常规增删改查用 ORM，复杂统计或批量写入用 Core，甚至直接执行原生 SQL。下面的图展示了这一双引擎结构及其与数据库的衔接关系。

为什么需要"工程化"视角

会写 session.query(User).all() 只是起点。工程化意味着你要回答一系列更实际的问题：连接池该配多大？Session 应该在请求开始时创建还是复用时创建？事务在什么位置提交、什么位置回滚？批量插入一万条数据，用 ORM 逐条 add 还是用 Core 的 insert().values()？查询出现 N+1 时如何定位和消除？这些问题的答案，决定了系统在高并发下是否稳定、在数据量增长后是否还能维护。

本课程会围绕这些真实问题展开，而不是停留在 API 罗列。你会看到具体的配置参数、可运行的代码片段、可观察的执行结果，以及判断"这样写是否合理"的依据。

工程化学习路线

整个课程按"由底层到上层、由单点到系统"的顺序组织，大致分为四个阶段。

第一阶段：Core 基础。先掌握 Engine、Connection、MetaData、Table 和语句构造器。这一阶段的目标是能独立用 Core 完成建表、增删改查和事务控制，理解 SQL 是如何被生成和执行的。这是后面所有内容的地基。

第二阶段：ORM 映射与查询。学习 DeclarativeBase、映射类、Column 类型、relationship 关联、Session 的使用方式，以及 select() 在 ORM 语境下的写法。重点理解身份映射、延迟加载、预加载（joinedload、selectinload）对查询行为的影响。

第三阶段：工程实践。把前两阶段的能力放进真实项目结构里：如何组织 models、repositories、session 工厂；如何管理事务边界；如何做连接池调优；如何处理迁移（Alembic）；如何写可测试的数据访问代码。

第四阶段：性能与排障。学习 SQL 日志观察、慢查询定位、N+1 识别、批量操作优化、锁与隔离级别的实际影响。这一阶段强调"用证据判断"，而不是凭感觉优化。

本课程的目标

完成本课程后，你应该能够：独立设计一个结构清晰的数据访问层；根据场景在 Core 与 ORM 之间做出合理选择；正确管理连接、会话与事务；识别并解决常见的性能问题；写出可测试、可维护、可迁移的持久化代码。换句话说，你收获的不只是 SQLAlchemy 的用法，而是一套构建数据访问层的工程方法。

接下来，我们从最基础的 Core 开始，先建立对 Engine 和 Connection 的准确认识。