SQLAlchemy 2.0.39 版本发布:ORM与SQL功能增强解析
SQLAlchemy 是一个流行的 Python SQL 工具包和对象关系映射(ORM)框架,它提供了完整的SQL功能和强大的ORM层。最新发布的2.0.39版本带来了一系列重要的改进和修复,主要集中在ORM功能增强、SQL语句处理优化以及特定数据库方言的支持上。
ORM功能改进
本次版本对ORM层进行了多项重要修复。首先是解决了使用DML返回语句(如Insert.returning())时,当ORM模型包含带有子查询的column_property()构造时会失败的问题。这个修复使得开发者可以更灵活地在ORM操作中使用返回子句,同时结合复杂的属性定义。
另一个重要改进是修复了多表DML语句(如UPDATE和DELETE)中,当使用RETURNING子句时无法正确返回非主表映射列的问题。这意味着现在可以在ORM操作中更自由地跨多表进行数据修改,并获取相关表的返回结果。
版本还优化了ORM语句的识别机制,现在即使在使用复杂的多部分操作符表达式(如Cls.attr + Cls.attr + Cls.attr)时,也能正确识别为ORM语句并应用相应的ORM行为。
SQL语句处理优化
在SQL核心层,2.0.39版本引入了对AddConstraint和DropConstraint构造的新参数isolate_from_table,这个参数控制约束是否应该从"CREATE TABLE"序列中分离出来。这一改变使得开发者可以更精确地控制约束的创建方式,特别是在需要单独添加或删除约束的场景下。
数据库方言特定改进
对于PostgreSQL用户,这个版本修复了多个重要问题:
- 修复了网络类型(INET、CIDR、MACADDR等)比较时的不必要VARCHAR转换问题,提高了查询效率
- 改进了FOR UPDATE OF子句在子查询中的处理
- 修复了PostgreSQL 17.3及以上版本中域(domain)反射的问题
SQLite用户则会注意到修复了同时配置WITH ROWID和STRICT表选项时的语法生成问题,现在会正确生成逗号分隔的选项列表。
异步支持改进
在异步(asyncio)支持方面,修复了AsyncResult的scalar()、scalar_one_or_none()和scalar_one()方法因缺少内部属性而引发的AttributeError问题,使得异步查询更加稳定可靠。
类型注解增强
类型提示方面,现在支持了复合查询(如union、union_all等)的泛型类型,返回类型会正确地匹配第一个查询的类型,为开发者提供了更好的类型检查支持。
总结
SQLAlchemy 2.0.39版本虽然是一个小版本更新,但包含了多项对开发者体验有实质性提升的改进。从ORM层的DML操作增强,到SQL语句生成的优化,再到特定数据库方言的修复,这些改进都使得SQLAlchemy在数据访问层的表现更加稳定和强大。对于正在使用SQLAlchemy的项目,特别是那些依赖复杂ORM操作或多数据库支持的项目,升级到这个版本将能获得更好的开发体验和运行时稳定性。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0213
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0138
uni-appA cross-platform framework using Vue.jsJavaScript08
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03