SQLAlchemy 文档

开始

SQLAlchemy 新手？从这里开始：

• 
  对于 Python 初学者：安装指南 - 使用 pip 等进行安装的基本指导

• 
  对于 Python 资深人士：SQLAlchemy 概述 - 简要架构概述

教程

SQLAlchemy 的新用户，以及旧 SQLAlchemy 的老手 release 系列，应以 SQLAlchemy Unified Tutorial，涵盖了 Alchemist 在使用 ORM 或仅使用 Core 时需要了解的所有内容。

• 
  快速浏览：ORM 快速入门 - 使用 ORM 是什么样子的一瞥

• 
  对于所有用户：SQLAlchemy Unified Tutorial - Core 和 ORM 的深入教程

迁移说明

来自旧版本 SQLAlchemy 的用户，尤其是那些从 1.x 工作风格过渡的用户，将需要查看此文档。

• 
  迁移到 SQLAlchemy 2.0 - 从 1.3 或 1.4 迁移到 2.0 的完整背景

• 
  SQLAlchemy 2.0 中有什么新功能？- 1.x 迁移之后的 2.0 新功能和行为

• 
  Changelog catalog - 所有 SQLAlchemy 版本的详细更改日志

参考和操作方法

SQLAlchemy ORM - 使用 ORM 的详细指南和 API 参考

• 
  映射类：映射 Python 类 | 关系配置

• 
  使用 ORM：使用 ORM 会话 | ORM 查询指南 | 使用 AsyncIO

• 
  配置扩展：关联代理 | 混合属性 | 可变标量 | 自动地图 | 所有扩展

• 
  扩展 ORM：ORM 事件和内部

• 
  其他：实例介绍

SQLAlchemy Core - 使用 Core 的详细指南和 API 参考

• 
  引擎、连接、池：引擎配置 | 连接、交易、结果 | AsyncIO 支持 | 连接池

• 
  Schema 定义：概述 | 表和列 | 数据库自省 （Reflection） | 插入/更新默认值 | 约束和索引 | 使用数据定义语言 （DDL）

• 
  SQL 语句：SQL 表达式元素 | 运算符参考 | SELECT 和相关结构 | 插入、更新、删除 | SQL 函数 | 目录

• 
  数据类型：概述 | 构建自定义类型 | 类型 API 参考

• 
  核心基础知识：概述 | 运行时检查 API | 活动系统 | 核心事件接口 | 创建自定义 SQL 构造

Dialect 文档

方言是 SQLAlchemy 用来与各种类型的 DBAPI 和数据库通信的系统。本节介绍有关各个方言的注释、选项和使用模式。

PostgreSQL 格式 | MySQL 和 MariaDB | SQLite | Oracle 数据库 | Microsoft SQL 服务器

更多方言 ...

补充的

• 
  常见问题 - 常见问题和解决方案的集合

• 
  词汇表 - SQLAlchemy 文档中使用的术语

• 
  错误消息指南 - 许多 SQLAlchemy 错误的解释

• 
  完整目录

• 
  指数