常见问题解答

常见问题解答部分是一个不断增长的集合，其中包含一些常见问题和已知问题的解决方法。

• 安装
  • 当我尝试使用 asyncio 时，出现关于 greenlet 未安装的错误
• 连接 / 引擎
  • 如何配置日志记录？
  • 如何连接数据库池？我的连接是否已池化？
  • 如何将自定义连接参数传递给我的数据库 API？
  • “MySQL 服务器已断开连接”
  • “命令不同步；您现在无法运行此命令” / “此结果对象不返回行。它已自动关闭”
  • 如何自动“重试”语句执行？
  • 为什么 SQLAlchemy 会发出如此多的 ROLLBACK？
  • 我使用多个连接与 SQLite 数据库（通常用于测试事务操作），但我的测试程序无法正常工作！
  • 如何获取使用引擎时的原始 DBAPI 连接？
  • 如何使用引擎 / 连接 / 会话与 Python 多进程或 os.fork()？
• 元数据 / 模式
  • 当我说 table.drop() / metadata.drop_all() 时，我的程序挂起了。
  • SQLAlchemy 是否支持 ALTER TABLE、CREATE VIEW、CREATE TRIGGER、模式升级功能？
  • 如何按依赖关系顺序对 Table 对象进行排序？
  • 如何获取 CREATE TABLE/ DROP TABLE 输出作为字符串？
  • 如何对 Table/Column 进行子类化以提供某些行为/配置？
• SQL 表达式
  • 如何将 SQL 表达式呈现为字符串，可能包含内联的绑定参数？
  • 为什么在将 SQL 语句转换为字符串时百分号会被加倍？
  • 我使用 op() 生成自定义运算符，但我的括号没有正确显示。
• ORM 配置
  • 如何映射没有主键的表？
  • 如何配置作为 Python 保留字或类似的 Column？
  • 如何获取给定映射类的所有列、关系、映射属性等列表？
  • 我收到有关“隐式组合属性 Y 下的列 X”的警告或错误。
  • 我使用的是 Declarative 并使用 and_() 或 or_() 设置 primaryjoin/secondaryjoin，但我收到有关外键的错误消息。
  • 为什么建议在 LIMIT（尤其是在 subqueryload() 中）中使用 ORDER BY？
  • default、default_factory 和 insert_default 是什么，我应该使用哪个？
• 性能
  • 为什么我的应用程序在升级到 1.4 和/或 2.x 后变慢了？
  • 如何分析基于 SQLAlchemy 的应用程序？
  • 我使用 ORM 插入 400,000 行，但速度很慢！
• 会话 / 查询
  • 我使用 Session 重新加载数据，但它没有看到我在其他地方提交的更改。
  • “此 Session 的事务已回滚，因为在刷新期间发生了先前的异常。”（或类似信息）
  • 如何创建一个始终向每个查询添加特定过滤器的 Query？
  • 我的 Query 返回的对象数量与 query.count() 告诉我的数量不同 - 为什么？
  • 我针对外部连接创建了映射，虽然查询返回了行，但没有返回任何对象。为什么？
  • 我使用 joinedload() 或 lazy=False 创建 JOIN/OUTER JOIN，而当我尝试添加 WHERE、ORDER BY、LIMIT 等（依赖于（外部）JOIN）时，SQLAlchemy 没有构造正确的查询。
  • Query 没有 __len__()，为什么？
  • 如何将文本 SQL 与 ORM 查询一起使用？
  • 我调用 Session.delete(myobject)，但它没有从父集合中删除！
  • 为什么当我加载对象时我的 __init__() 没有被调用？
  • 如何使用 SA 的 ORM 实现 ON DELETE CASCADE？
  • 我在实例上将“foo_id”属性设置为“7”，但“foo”属性仍然是 None - 它不应该加载 ID 为 7 的 Foo 吗？
  • 如何遍历与给定对象相关的所有对象？
  • 是否有方法自动获得唯一的关键字（或其他类型的对象），而无需查询关键字并获取包含该关键字的行？
  • 为什么 post_update 会除了第一个 UPDATE 之外还发出 UPDATE？
• 第三方集成问题
  • 我遇到与“numpy.int64”、“numpy.bool_”等相关的错误。
  • WHERE/HAVING 角色期待 SQL 表达式，但得到 True。