Victoria 系列发布说明

8.4.1

错误修复

  • 在 mysql 8.0.19 中，重复键错误信息已扩展为包含键的表名。 之前，重复键错误信息仅包含键值和键名。 这扩展了处理与较新 mysql 版本（自 8.0.19 起）的重复键错误信息变化的能力。

7.0.0

升级说明

  • 已停止对 Python 2.7 的支持。 现在支持的 Python 的最低版本是 Python 3.6。

5.0.0

错误修复

  • 移除了已弃用的数据库选项 min_pool_size。

    此选项没有效果，并且在 Rocky 版本中已弃用。有关更多信息，请参阅 bug 1764786。

4.42.0

新特性

  • 在 enginefacade 上下文管理器和工厂对象中添加了新的 .is_started 布尔标志，以便调用代码可以防止重复配置场景。 此外，在工厂启动后调用 configure 时引发的 TypeError 现在是一个特定的子类 enginefacade.AlreadyStartedError。

4.34.0

新特性

  • 添加了新的选项 connection_parameters，它允许将 SQLAlchemy 查询参数与 URL 分开声明，以便像 Nova cells 这样的 URL 持久化方案可以使用控制器本地查询参数，这些参数不会广播到所有其他服务器。

错误修复

  • 修复了 enginefacade 的“synchronous_reader”修饰符，使其在设置为 True 时引用“writer”引擎，从而允许与 writer 的“同步”行为。当设置为 False 时，则为“异步”，因此应与异步引擎关联。此前该标志的行为相反。

4.30.0

弃用说明

  • PyMySQL 是 oslo.db 以及整个 OpenStack 的默认 MySQL DB API 驱动程序。 迄今为止，可以使用 MySQL-python 作为替代的 DB API 驱动程序。 此驱动程序在本版本中不再进行测试，因此应被认为不受支持。 请切换到 PyMySQL，它是一个合适的替代品。 请参阅 https://wiki.openstack.org/wiki/PyMySQL_evaluation 以获取详细信息。

4.26.0

弃用说明

  • 配置选项 idle_timeout 现在已被弃用，并已重命名为 connection_recycle_time，包括在 oslo.db 的主要选项中，以及在 engines.create_engine()、enginefacade.configure() 和 enginefacade.configure_defaults() 的关键字参数中。 新名称更准确地描述了此选项的作用，即它与连接本身的“空闲”时间无关，也不会在任何特定时间断开连接。 它指的是一条规则，即任何存在于连接池中的时间超过 N 秒的连接都会在下次从池中检出时自动丢弃并替换。

4.22.0

升级说明

  • 当连接 URL 未显式提及驱动程序时，oslo.db 现在会记录警告。 仍然使用默认驱动程序，但在某些情况下，例如 MySQL，默认驱动程序与并发库 eventlet 不兼容。

  • 强烈建议在使用 PyMySQL 驱动程序连接到兼容 MySQL 的数据库，以确保与并发库 eventlet 的最佳兼容性。 要使用 PyMySQL，请确保将连接 URL 指定为 mysql+pymysql:// 作为方案。

4.19.0

升级说明

  • 配置选项 sqlite_db 已删除。 请使用配置选项 connection 或 slave_connection 连接到数据库。

4.15.0

弃用说明

  • 来自 oslo_db.sqlalchemy.utils 模块的 InsertFromSelect 类已被弃用，推荐使用 SQLAlchemy 1.0.0 及更高版本中 Insert 表达式的 sqlalchemy.sql.expression.Insert.from_select() 方法

  • 来自 oslo_db.sqlalchemy.test_base 的基础测试类已被弃用，推荐使用 oslo_db.sqlalchemy.test_fixtures 模块中引入的新 fixtures

4.12.0

错误修复

  • 装饰器 oslo_db.api.wrap_db_retry 现在默认重试 10 次。 之前尝试次数为 0，用户必须显式传递 max_retry_interval 值大于 0 才能实际启用错误重试。

4.9.0

升级说明

  • 选项 connection_debug 的允许值现在限制在 0 到 100（含）之间。 之前可以提供小于 0 或大于 100 的数字而不会出错。 但现在，当选项值超出此范围时，将引发 ConfigFileValueError。

4.8.0

新特性

  • enginefacade 装饰器现在可用于类和实例方法，这些方法隐式接收第一个位置参数。 之前，要求所有装饰的函数都将上下文值作为第一个参数接收。

弃用说明

  • 配置选项 sqlite_db 现在已被弃用，将来将被删除。 请使用配置选项 connection 或 slave_connection 连接到数据库。

4.6.0

升级说明

其他说明

  • 引入 reno 用于部署者版本说明。