2026 年 SQLAlchemy 版本说明

本文包含 SQLAlchemy 的版本说明，包括以下内容（如果适用）：

  • 行为变更

  • 新功能

  • 面向客户的错误修复

Snowflake 对 SQLAlchemy 更新使用语义版本控制。

有关文档，请参阅 将 Snowflake SQLAlchemy 工具包与 Python Connector 结合使用。

版本 1.9.0（2026 年 3 月 4 日）

新功能和更新

  • 添加了对 DECFLOAT 和 VECTOR 数据类型的支持。

  • 添加了对 server_version_info 支持的支持。

  • 在查询中添加了对 ILIKE 的支持。

  • 引入了一个用于解析完全限定架构名的共享辅助函数，取代了各反射方法中不一致的临时实现模式。

  • 将列反射内部结构重构为专用助手，以在不改变行为的情况下降低复杂性。

  • 通过为每个工作进程提供架构配置的 Hook，增加了对 pytest-xdist 并行测试的支持。

  • 将 sa14 测试环境中 pandas 的下限从 <2.1 to >=2.1.1,<2.2 提高，以确保为 Python 3.12 提供预构建的 wheel 包。

  • 增加了对 timestamp 和 datetime 类型中时区的支持。

错误修复

  • 修复了 SYSDATE() 渲染。

  • 修复和改进了架构反射。

  • 修复了在不指定架构时进行反射会崩溃的问题，该问题由内部架构解析中使用了 :codenowrap: None 实参导致。

  • 修复了当 SHOW TABLES 返回空字符串表名时会导致反射过程中 IndexError 的崩溃问题。

  • 修复了不完整的标识列反射元数据。此列现在包含 SQLAlchemy 2.0+ 要求的所有字段（always、cycle、order 等）。

  • 修复了 SQLAlchemy 版本解析。