1. SQLAlchemy 入门
版本要求
本教程针对 SQLAlchemy 2.x+，如果需要 SQLAlchemy 1.x 的教程请访问官方文档。
本教程要求使用 Python 3.7+，最佳版本是 Python 3.10+，请使用尽可能新的 Python 以确保特性支持。
1.1 什么是 SQLAlchemy
SQLAlchemy 是 Python 生态中久经考验的数据库驱动和 ORM 框架，自 SQLAlchemy 1.4 开始，SQLAlchemy 就支持了异步操作。2022 年 11 月，SQLAlchemy 发布了 2.0 版本，其中大量 API 进行更改，C 扩展全部用 Cython 重写，相比以前对类型注解、异步等有更好的支持。
SQLAlchemy 的 asyncio 支持依赖于 greenlet 项目。这个依赖将默认安装在常见的机器平台上，但不是每个架构都支持，也可能不会默认安装在不太常见的架构上。
SQLAlchemy 的核心功能包括 ORM 模块 和 Core 模块。
通过 pip 安装 SQLAlchemy：
pip install SQLAlchemy
查看当前安装的版本：
python -c "import sqlalchemy;print(sqlalchemy.__version__)"
或者
pip list | grep SQLAlchemy
1.2 SQLAlchemy 支持的数据库
SQLAlchemy 对常见数据库均有支持，下表截至 2.0.4 版本[1]
| 数据库 | 测试通过的版本 | 常规支持 | 最佳 |
|---|---|---|---|
| Microsoft SQL Server | 2017 | 2012+ | 2005+ |
| MySQL / MariaDB | 5.6, 5.7, 8.0 / 10.4, 10.5 | 5.6+ / 10+ | 5.0.2+ |
| Oracle | 11.2, 18c | 11+ | 9+ |
| PostgreSQL | 9.6, 10, 11, 12, 13, 14 | 9.6+ | 9+ |
| SQLite | 3.21, 3.28+ | 3.12+ | 3.7.16+ |
Dialects，SQLAlchemy，https://docs.sqlalchemy.org/en/20/dialects/index.html ↩︎