●Change8

Migrating to Alembic rel_1_17_1

Version rel_1_17_1 introduces 1 breaking change. This guide details how to update your code.

Released: 10/29/2025

1
Breaking Changes
1
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

alembic.command.currentalembic.command.current.check_headsalembic.revision

Breaking Changes

●Issue #1

Custom revision identifiers may no longer contain ':'; existing revisions that include ':' will cause errors. Rename such revisions to remove ':' and update any references in migration scripts.

Migration Steps

  1. 1
    Search for revision IDs containing ':' in your Alembic history, rename them to IDs without ':', and update any scripts or dependencies that reference the old IDs.

Release Summary

Version 1.17.1 introduces a new `--check-heads` option for `alembic current` and tightens revision ID validation by rejecting ':' characters, requiring migration of any existing colon‑containing IDs.

Need More Details?

View the full release notes and all changes for Alembic rel_1_17_1.

View Full Changelog