龙哥盟

原文：docs.sqlalchemy.org/en/20/intro.htmlSQLAlchemy SQL 工具包和对象关系映射器是一套全面的用于处理数据库和 Python 的工具集。它有几个不同的功能区域，可以单独使用或组合在一起。其主要组件如下图所示，组件依赖关系组织成层次结构：上面，SQLAlchemy 最重要的两个面向用户的部分是对象关系映射器（ORM）和核心（Core）。核心部分包含了 SQLAlchemy 的 SQL 和数据库集成以及描述服务，其中最突出的部分是SQL 表达式语言。

原文：docs.sqlalchemy.org/en/20/contents.htmlOracledocs.sqlalchemy.org/en/20/dialects/oracle.html支持 Oracle 数据库。下表总结了数据库发布版本的当前支持级别。支持的 Oracle 版本支持类型版本CI 完全测试通过18c正常支持11+尽力而为9+DBAPI 支持下列方言/DBAPI 选项可用。请参考各个 DBAPI 部分获取连接信息。cx-

原文：docs.sqlalchemy.org/en/20/contents.html第三方集成问题原文：docs.sqlalchemy.org/en/20/faq/thirdparty.html我遇到了与“numpy.int64”、“numpy.bool_”等相关的错误。预期为 WHERE/HAVING 角色的 SQL 表达式，实际得到了 True我遇到了与“numpy.int64”、“numpy.bool_”等相关的错误。numpy包具有其自己的数字数据类型，它们是从 Py

原文：docs.sqlalchemy.org/en/20/contents.htmlORM 配置原文：docs.sqlalchemy.org/en/20/faq/ormconfiguration.html如何映射没有主键的表？如何配置一个与 Python 保留字或类似的列？如何在给定映射类的情况下获取所有列、关系、映射属性等的列表？我收到关于“在属性 Y 下隐式组合列 X”的警告或错误我正在使用声明式并使用 and_() 或 or_() 设置 primaryjoin

调用可以通过另请参见自定义 DBAPI connect() 参数 / 连接时例程调用可以通过另请参见自定义 DBAPI connect() 参数 / 连接时例程q -> p在上面的情况下，我们可能想要。对于这种情况的解决方案是设置运算符的优先级，使用我们还可以通常通过使用。

原文：docs.sqlalchemy.org/en/20/contents.htmlSQLAlchemy 2.0 有哪些新功能？原文：docs.sqlalchemy.org/en/20/changelog/whatsnew_20.html读者注意事项SQLAlchemy 2.0 的过渡文档分为 两个 文档 - 一个详细说明了从 1.x 到 2.x 系列的主要 API 转换，另一个详细说明了与 SQLAlchemy 1.4 相关的新功能和行为：SQLAlchemy 2.0 - Major

原文：docs.sqlalchemy.org/en/20/contents.html变更和迁移原文：docs.sqlalchemy.org/en/20/changelog/index.htmlSQLAlchemy 变更日志和迁移指南现在已集成到主要文档中。当前迁移指南对于 SQLAlchemy 2.0，有两个单独的文档；"主要迁移指南"详细介绍了如何将 SQLAlchemy 1.4 应用程序更新为兼容 SQLAlchemy 2.0。"有什么新内容？"文档详细介绍了 SQLAlchemy 2

原文：docs.sqlalchemy.org/en/20/contents.html1.4 更新日志原文：docs.sqlalchemy.org/en/20/changelog/changelog_14.html本文详细介绍了 1.4 版本中进行的单个问题级别的更改。有关 1.4 中的新内容的叙述性概述，请参阅 SQLAlchemy 1.4 有什么新功能？。1.4.53无发布日期1.4.52发布日期：2024 年 3 月 4 日orm[orm] [bug]修复了 ORM 中

原文：docs.sqlalchemy.org/en/20/contents.html。

原文：docs.sqlalchemy.org/en/20/contents.html2.0 更新日志原文：docs.sqlalchemy.org/en/20/changelog/changelog_20.html2.0.30无发布日期orm[orm] [bug]添加了新的属性 ORMExecuteState.is_from_statement，用于检测形式为 select().from_statement() 的语句，并且还增强了FromStatement以设置 ORMExecut

aiosqlite 扩展了 pysqlite 以支持异步，因此我们可以在 Python 中创建自定义用户定义的函数 (UDFs)，并直接在 SQLite 查询中使用它们，如此处所述：用户定义的函数。### Serializable isolation / Savepoints / Transactional DDL (asyncio 版本)类似于 pysqlite，aiosqlite 不支持 SAVEPOINT 功能。

原文：docs.sqlalchemy.org/en/20/contents.html使用声明性的映射类原文：docs.sqlalchemy.org/en/20/orm/declarative_mapping.html声明性映射风格是 SQLAlchemy 中主要使用的映射风格。请参阅 声明性映射 部分进行顶层介绍。声明性映射风格使用声明性基类使用装饰器进行声明性映射（无声明性基类）使用声明性的表配置具有mapped_column() 的声明性表使用带注释

原文：docs.sqlalchemy.org/en/20/contents.html自定义 DDL原文：docs.sqlalchemy.org/en/20/core/ddl.html在前面的章节中，我们讨论了各种模式构造，包括 Table、ForeignKeyConstraint、CheckConstraint 和 Sequence。在整个过程中，我们依赖于 Table 和 MetaData 的 create() 和 create_all() 方法来为所有构造发出数据定义语言 (DDL)。当发

请参阅自定义 DBAPI connect()参数 / on-connect routines 一节，了解各种连接定制例程。仅包含单个rollback()的“归还时重置”对于某些用例可能不足够；特别是，使用临时表的应用程序可能希望在连接归还时自动删除这些表。一些（但并非所有）后端包括可以在数据库连接范围内“重置”这些表的功能，这可能是连接池重置的理想行为。其他服务器资源，如准备好的语句句柄和服务器端语句缓存，可能会在归还过程之后持续存在，具体取决于具体情况是否希望这样。

原文：docs.sqlalchemy.org/en/20/contents.html使用引擎和连接原文：docs.sqlalchemy.org/en/20/core/connections.html本节详细介绍了 Engine、Connection 和相关对象的直接用法。值得注意的是，在使用 SQLAlchemy ORM 时，通常不直接访问这些对象；相反，Session 对象用作与数据库的接口。但是，对于以直接使用文本 SQL 语句和/或 SQL 表达式构造为中心，而不涉及 ORM 的高级管理

原文：docs.sqlalchemy.org/en/20/contents.html基本类型 API原文：docs.sqlalchemy.org/en/20/core/type_api.html对象名称描述Concatenable标记类型支持“串联”的混合类型，通常用于字符串。ExternalType定义特定于第三方数据类型的属性和行为的混合类型。Indexable标记类型支持索引操作的混合类型，例如数组或 JSON 结构。NullType未知类型

原文：docs.sqlalchemy.org/en/20/contents.html核心 API 基础原文：docs.sqlalchemy.org/en/20/core/api_basics.html事件事件注册命名参数风格目标修饰符事件和多进程事件参考API 参考运行时检查 APIinspect()可用的检查目标核心异常AmbiguousForeignKeysErrorArgumentErrorA

原文：docs.sqlalchemy.org/en/20/contents.html核心事件原文：docs.sqlalchemy.org/en/20/core/events.html本节描述了 SQLAlchemy Core 中提供的事件接口。有关事件监听 API 的介绍，请参阅 Events。ORM 事件在 ORM Events 中描述。对象名称描述Events为特定目标类型定义事件监听函数。class sqlalchemy.event.base.Events

原文：docs.sqlalchemy.org/en/20/contents.htmlMySQL 和 MariaDB原文：docs.sqlalchemy.org/en/20/dialects/mysql.html支持 MySQL / MariaDB 数据库。以下表总结了数据库发布版本的当前支持级别。支持的 MySQL / MariaDB 版本支持类型版本CI 中完全测试5.6, 5.7, 8.0 / 10.8, 10.9正常支持5.6+ / 10+尽力而

原文：docs.sqlalchemy.org/en/20/core/custom_types.html存在各种方法来重新定义现有类型的行为以及提供新类型。在使用 注释式声明表 映射声明 ORM 映射时，可以通过将其添加到 类型注解映射 中，将上述自定义GUID类型与 Pythonuuid.UUID数据类型相关联，该类型通常定义在通过上述配置，继承自Base的 ORM 映射类可以在注解中引用 Pythonuuid.UUID，这将自动使用GUID另请参见自定义类型映射。

原文：docs.sqlalchemy.org/en/20/contents.html方言原文：docs.sqlalchemy.org/en/20/dialects/index.html方言 是 SQLAlchemy 用来与各种类型的 DBAPI 实现和数据库通信的系统。以下各节包含每个后端使用的特定用法的参考文档和说明，以及各种 DBAPI 的说明。所有方言都要求安装适当的 DBAPI 驱动程序。包含的方言PostgreSQLMySQL 和 MariaDBSQLite

原文：docs.sqlalchemy.org/en/20/contents.html列的插入/更新默认值原文：docs.sqlalchemy.org/en/20/core/defaults.html列的插入和更新默认值是指在针对该行进行插入或更新语句时，为该列创建默认值的函数，前提是对该列的插入或更新语句未提供任何值。也就是说，如果一个表有一个名为“timestamp”的列，并且进行了不包含该列值的插入语句，那么插入默认值将创建一个新值，例如当前时间，该值将用作要插入到“timestamp”列

原文：docs.sqlalchemy.org/en/20/contents.html进一步阅读原文：docs.sqlalchemy.org/en/20/tutorial/further_reading.html下面的章节是讨论本教程中概念的主要顶级章节，更详细地描述了每个子系统的许多其他特性。核心基础参考与引擎和连接工作模式定义语言SQL 语句和表达式 APISQL 数据类型对象ORM 基础参考ORM 映射类配置关系配置使用会话ORM 查

原文：docs.sqlalchemy.org/en/20/contents.html。

原文：docs.sqlalchemy.org/en/20/contents.html特殊的关系持久性模式原文：docs.sqlalchemy.org/en/20/orm/relationship_persistence.html指向自身的行 / 相互依赖的行这是一种非常特殊的情况，其中 relationship()必须执行一个 INSERT 和一个第二个 UPDATE，以正确填充一行（反之亦然，为了删除而执行一个 UPDATE 和 DELETE，而不违反外键约束）。这两种用例是：一个表

原文：docs.sqlalchemy.org/en/20/contents.html集合自定义和 API 详情原文：docs.sqlalchemy.org/en/20/orm/collection_api.htmlrelationship() 函数定义了两个类之间的链接。当链接定义了一对多或多对多的关系时，在加载和操作对象时，它被表示为 Python 集合。本节介绍了有关集合配置和技术的其他信息。自定义集合访问将一对多或多对多的关系映射为一组可通过父实例上的属性访问的值的集合。对于这些关系

原文：docs.sqlalchemy.org/en/20/contents.html。

原文：docs.sqlalchemy.org/en/20/contents.htmlORM-启用的 INSERT、UPDATE 和 DELETE 语句原文：docs.sqlalchemy.org/en/20/orm/queryguide/dml.html关于本文档本节利用了首次在 SQLAlchemy 统一教程中展示的 ORM 映射，如声明映射类一节所示，以及映射类继承层次结构一节中展示的继承映射。查看此页面的 ORM 设置。除了处理 ORM 启用的Select对象外，Session.e

原文：docs.sqlalchemy.org/en/20/contents.html编写继承映射的 SELECT 语句原文：docs.sqlalchemy.org/en/20/orm/queryguide/inheritance.html关于本文档本节利用了使用 ORM 继承 功能配置的 ORM 映射，描述在 映射类继承层次结构 中。重点将放在 连接表继承，因为这是最复杂的 ORM 查询情况。查看此页面的 ORM 设置。从基类 vs. 特定子类进行 SELECT构建在连接继承层次结构中

原文：docs.sqlalchemy.org/en/20/contents.html关系加载技术原文：docs.sqlalchemy.org/en/20/orm/queryguide/relationships.html关于本文档本节详细介绍了如何加载相关对象。读者应熟悉关系配置和基本用法。大多数示例假定“用户/地址”映射设置类似于在选择设置中所示的设置。SQLAlchemy 的一个重要部分是在查询时提供对相关对象加载方式的广泛控制。所谓“相关对象”是指在映射器上使用relationsh

主要连接条件的另一个元素是如何确定那些被认为是“外部”的列的。通常，一些Column对象的子集将指定ForeignKey，或者是的一部分，这与连接条件相关。查看这个外键状态，以确定它应该如何为这个关系加载和持久化数据。然而，参数可以用来创建一个不涉及任何“模式”级外键的连接条件。我们可以显式地结合以及和来建立这样一个连接。下面，一个HostEntry类与自身连接，将字符串content列等同于ip_address列，这是一个名为INET的 PostgreSQL 类型。我们需要使用cast()pass。

原文：docs.sqlalchemy.org/en/20/contents.html列加载选项原文：docs.sqlalchemy.org/en/20/orm/queryguide/columns.html关于本文档本节介绍了有关加载列的其他选项。使用的映射包括将存储大字符串值的列，我们可能希望限制它们何时加载。查看此页面的 ORM 设置。以下示例中的一些将重新定义 Book 映射器以修改某些列定义。使用列推迟限制加载的列列推迟 指的是在查询该类型的对象时，从 SELECT 语句中省略

原文：docs.sqlalchemy.org/en/20/contents.html非传统映射原文：docs.sqlalchemy.org/en/20/orm/nonstandard_mappings.html将类映射到多个表映射器可以构造与任意关系单元（称为 selectables）相对应的类，除了普通表之外。例如，join() 函数创建了一个包含多个表的可选择单元，具有自己的复合主键，可以与 Table 相同的方式映射：from sqlalchemy import Table, Col

原文：docs.sqlalchemy.org/en/20/contents.html声明式扩展原文：docs.sqlalchemy.org/en/20/orm/extensions/declarative/index.html声明式映射 API 特定的扩展。1.4 版本更改：绝大部分声明式扩展现在已整合到 SQLAlchemy ORM 中，并可从 sqlalchemy.orm 命名空间导入。请参阅声明式映射的文档以获取新文档。有关更改的概述，请参阅声明式现已与 ORM 整合，并带有新功能。

原文：docs.sqlalchemy.org/en/20/contents.html运算符参考原文：docs.sqlalchemy.org/en/20/core/operators.html本节详细介绍了用于构建 SQL 表达式的运算符的用法。这些方法按照 Operators 和 ColumnOperators 基类的方式呈现。然后这些方法可用于这些类的后代，包括：Column 对象ColumnElement 对象更一般地，这些对象是所有 Core SQL 表达式语言列级表达式的

原文：docs.sqlalchemy.org/en/20/contents.htmlSQLAlchemy 核心原文：docs.sqlalchemy.org/en/20/core/index.htmlSQLAlchemy 的 SQL 渲染引擎、DBAPI 集成、事务集成以及模式描述服务在这里有所记录。与 ORM 的面向领域的使用方式相反，SQL 表达语言提供了一种以模式为中心的使用范式。SQL 语句和表达式 API列元素和表达式操作符参考SELECT 及相关结构插入

原文：docs.sqlalchemy.org/en/20/contents.html。

原文：docs.sqlalchemy.org/en/20/core/compiler.html提供了用于创建自定义 ClauseElements 和编译器的 API。compiler参数是正在使用的Compiled对象。可以检查此对象的任何有关进行中编译的信息，包括等。和都包括一个process()注意上述的构造仅是一个示例，这种实际功能已经可以使用方法。

原文：docs.sqlalchemy.org/en/20/contents.html插入，更新，删除原文：docs.sqlalchemy.org/en/20/core/dml.htmlINSERT、UPDATE 和 DELETE 语句是基于从 UpdateBase 开始的层次结构构建的。Insert 和 Update 构造基于中介 ValuesBase 构建。DML 基础构造函数最顶层的“INSERT”，“UPDATE”，“DELETE”构造函数。对象名称描述dele

原文：docs.sqlalchemy.org/en/20/contents.html反射数据库对象原文：docs.sqlalchemy.org/en/20/core/reflection.html可以命令Table对象从数据库中已经存在的相应数据库架构对象中加载关于自身的信息。这个过程称为反射。在最简单的情况下，您只需要指定表名、一个MetaData对象和autoload_with参数：>>> messages = Table("messages", metadata_ob