2023.2 Series Release Notes

14.1.0

Upgrade Notes

• The ability to create engine facades that used autocommit, which was removed in 13.0.0, has been re-added temporarily to allow a longer transition time for projects. It is still deprecated and requires SQLAlchemy < 2.x. It will be removed again in a future release.

• The oslo_db.sqlalchemy.migration module and WalkVersionsMixin test mixin in the oslo_db.sqlalchemy.test_migrations, which were removed in 13.0.0, have been re-added temporarily to allow a longer transition time for projects. These are still deprecated as SQLAlchemy-Migrate is not compatible with SQLAlchemy 2.x. They will be removed again in a future release.

14.0.0

Upgrade Notes

• MySQL NDB Cluster support has been removed.

13.0.0

New Features

• oslo.db now supports SQLAlchemy 2.0.

• A new oslo_db.compat module has been added. This provides a number of shims for handling differences between SQLAlchemy 1.x and 2.x.

Upgrade Notes

• The following test fixtures and base test classes were deprecated and have now been removed:

  • oslo_db.sqlalchemy.test_base.DbFixture

  • oslo_db.sqlalchemy.test_base.DbTestCase

  • oslo_db.sqlalchemy.test_base.OpportunisticTestCase

  • oslo_db.sqlalchemy.test_base.MySQLOpportunisticFixture

  • oslo_db.sqlalchemy.test_base.PostgreSQLOpportunisticFixture

  • oslo_db.sqlalchemy.test_base.MySQLOpportunisticTestCase

  • oslo_db.sqlalchemy.test_base.PostgreSQLOpportunisticTestCase

  They have all been replaced by equivalent test fixtures and test class mixins in oslo_db.sqlalchemy.test_fixtures.

  In addition, the following test cases were being inadvertently used publicly despite being private to oslo.db. They were also deprecated and have now been removed:

  • oslo_db.tests.sqlalchemy.base.DbTestCase

  • oslo_db.tests.sqlalchemy.base.MySQLOpportunisticTestCase

  • oslo_db.tests.sqlalchemy.base.PostgreSQLOpportunisticTestCase

• The oslo_db.sqlalchemy.migration module and migrate backend for the oslo_db.sqalchemy.migration_cli module, both of which were first deprecated in the 8.5.0 release, have now been removed. sqlalchemy-migrate is no longer under active development, does not support SQLAlchemy 2.0, and has been effectively replaced by alembic.

• The ability to create engine facades that used autocommit, first deprecated in 12.1.0, has now been removed. This is not supported in SQLAlchemy 2.x.