获取 SQLAlchemy

修订版本发布

修订版本发布是最常见的发布系列，对于活跃的项目，通常每隔几周或更短时间发生一次。**对于任何项目，只要给定特定的主/次版本系列，修订版本发布应始终完全兼容，无需任何更改即可升级到该版本。**。这意味着，如果一个项目正在使用 SQLAlchemy 的 1.2.3 版本，在理想情况下，该项目应该能够直接升级到最新的 1.2.x 系列，例如 1.2.19，而无需升级到中间版本。

修订版本发布包括三个类别的更改

• 错误修复 - 修订版本发布的主要目的是发布错误修复，而不会进行向后不兼容的更改。如果错误修复被认为对向后兼容性风险过高，则会将其推迟到次版本发布中。
• 用例添加 - “用例”是介于“错误修复”和“功能”之间的一类更改，它们最常用于支持新的数据库功能。由于用户不断创建或请求新的数据库功能，并且通常指的是特定的数据类型或小的 SQL 语法，因此只要这些功能不破坏 SQLAlchemy 或 Alembic 迁移中的向后兼容性，通常会将其添加到修订版本发布中。较大的用例添加会在次版本发布中发布。
• 小型功能添加 - 由于修订版本发布的周期为每隔几周，而次版本发布的周期通常至少为一年或更长，因此对任何当前代码或 API 没有影响的功能添加通常会包含在修订版本发布中；一个例子是 在 ORM 加载器选项上创建子选项的能力。

请注意，虽然修订版本发布是最保守和频繁的发布流，但始终有可能引入意外的回归。建议项目在升级到任何 SQLAlchemy 组织软件的新版本时，始终充分测试其软件，包括使用测试套件和/或暂存环境。

重要的次版本发布

SQLAlchemy 中的次版本发布实际上是“重大”事件，因为它们通常需要一年才能产生；对于相关项目，次版本发布可能不那么频繁。我们可以将它们称为重要的次版本发布，以表明它们是重大事件，同时又不会将它们与“主版本号”的名称混淆，因为“主版本号”通常指的是版本编号方案中最左边的数字。次版本号的更改意味着该项目包含的更改通常在先前未弃用的 API 和当前 Python 版本的范围内向后兼容，但存在一些不向后兼容的风险，尤其是在 SQLAlchemy 本身中；这种风险通常是不可避免的，因为更改的性质如此。

因此，对于 SQLAlchemy 本身而言，“重要的次版本发布”实际上并不是那么“次要”，并且始终有一个 详细的迁移说明部分，其中非常详细地描述了可能需要识别的每个 API 调整和行为更改。对于其他项目，次版本发布通常指的是 Python 版本支持的更改，例如放弃对 Python 2.6 的支持，或 Alembic 放弃对 SQLAlchemy 0.9 的支持；有关新功能的一般概念可以在更新日志中找到。

重要的次版本发布，尤其是在 SQLAlchemy 本身中，将包括

• 主要新功能 - 新的 API 功能和特性，以及结构和性能改进，是 SQLAlchemy 本身以及相关项目的每个次版本发布的一部分。这些添加通常是完全向后兼容的，但是由于它们通常会在内部更改大量代码，因此存在较高的回归风险，尤其是在 SQLAlchemy 中；这些回归通常会在新次版本发布的前几个修订版本发布中解决。与往常一样，下游应用程序应运行其测试套件并报告新次版本发布的任何问题。

• 行为更改 - 大多数行为更改都是细微的，不太可能在一般情况下引起问题。但是，这些更改可能与最终用户代码不向后兼容，这些代码要么依赖于以前损坏的行为，要么是绕过旧行为，而旧行为将不再产生相同的结果。一个典型的例子是以前未正确引用或转义的 SQL 渲染，然后对其进行修复；下游应用程序通常会通过手动应用引用来解决此问题，一旦 SQLAlchemy 修复了此问题，手动引用就会变得多余。此类更改的一个示例是 列级 COLLATE 关键字现在引用排序规则名称，它为必须以区分大小写的方式指定的数据库排序规则名称添加了引号。

  预计不会引起问题的行为更改也记录在案，以防出现一些无法预料的问题；一个例子是 FOR UPDATE 子句在连接的预先加载子查询以及外部呈现¶，它修改了在包含连接的预先加载的 SELECT 中“FOR UPDATE”的呈现方式。此更改对 MySQL 用户的影响最大，因为它解决了已知的 MySQL 问题，并将突然开始锁定连接的预先加载中的相关表中的表行，而以前在此特定后端上并非如此。

• API 弃用 - SQLAlchemy 和相关项目尝试仅在次版本发布中添加新的弃用，而不是在修订版本发布中添加。任何弃用的 API 都应在最大程度上发出DeprecationWarning当使用该 API 时。虽然对于旧版本并非总是如此，但目标是仅在次版本发布中添加弃用，并且在使用时应发出警告。这样做的目的是使项目拥有整个次版本发布周期来迁移旧 API，并且弃用易于识别。

• 删除先前弃用的 API - 在特定次版本发布中弃用的 API 可能会在下一个次版本发布后立即删除，尽管通常弃用的 API 会保留多个次版本发布。在现代版本中，弃用的 API 在特定次版本发布的整个期间内使用时应发出警告。

主版本发布

主版本发布指的是项目的总体成熟度状态，这是一个多年的状态。一个项目从 0 开始，例如 sqlalchemy-collectd-0.0.4，这表示从初始 alpha 版本到长期稳定版本的成熟度范围，其概念是跨每个次版本发布可能会发生重大的破坏性更改。在主版本 1 中，该项目被认为是成熟的。主版本 2 及更高版本分别表示项目的重大新转变，其性质类似于 Python 2 到 Python 3 的转变。