Как происходит создание миграции в Alembic

Для создания миграции в Alembic используется команда revision с флагом -m для указания сообщения:

alembic revision -m "create users table"

После выполнения команды в папке versions появится файл миграции с шаблоном для ручного описания изменений. Пример миграции:

def upgrade():
    op.create_table(
        'users',
        sa.Column('id', sa.Integer, primary_key=True),
        sa.Column('name', sa.String(50), nullable=False)
    )

def downgrade():
    op.drop_table('users')

Основные моменты:

1. upgrade() - содержит изменения для применения миграции
2. downgrade() - откатывает изменения
3. Для работы с БД используются операции op.* (create_table, add_column и т.д.)
4. Для применения миграции используется alembic upgrade head