summaryrefslogtreecommitdiff
path: root/releasenotes/notes/switch-to-alembic-7af6f8e71e4bf56b.yaml
blob: 883f74db363d43b81778c2efe5e27ef667e4cdeb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
---
upgrade:
  - |
    The database migration engine has changed from `sqlalchemy-migrate`__ to
    `alembic`__. For most deployments, this should have minimal to no impact
    and the switch should be mostly transparent. The main user-facing impact is
    the change in schema versioning. While sqlalchemy-migrate used a linear,
    integer-based versioning scheme, which required placeholder migrations to
    allow for potential migration backports, alembic uses a distributed version
    control-like schema where a migration's ancestor is encoded in the file and
    branches are possible. The alembic migration files therefore use a
    arbitrary UUID-like naming scheme and the ``heat-manage db_sync`` command
    now expects such an version when manually specifying the version that should
    be applied. For example::

        $ heat-manage db_sync c6214ca60943

    Attempting to specify an sqlalchemy-migrate-based version will result in an
    error.

    .. __: https://sqlalchemy-migrate.readthedocs.io/en/latest/
    .. __: https://alembic.sqlalchemy.org/en/latest/