Как работают миграции в SQLAlchemy 2.0?

Question

[Харо]

Есть две таблицы для ТГ бота, описаны через SQLAlchemy 2.0.31:

...
DB_USER = getenv('POSTGRES_USER')
DB_PASS = getenv('POSTGRES_PASSWORD')
DB_NAME = getenv('POSTGRES_DB')
DB_HOST = getenv('DB_HOST')

DATABASE_URL = f'postgresql+psycopg2://{DB_USER}:{DB_PASS}@{DB_HOST}/{DB_NAME}'

engine = create_engine(DATABASE_URL, echo=True)


class Base(DeclarativeBase):
    pass


class User(Base):
    __tablename__ = 'Users'

    id: Mapped[int] = mapped_column(primary_key=True, autoincrement=True)
    chat_id: Mapped[int] = mapped_column(unique=True)
    username: Mapped[str] = mapped_column(String(32))
    last_tarot_date: Mapped[str] = mapped_column(String(20))

    messages = relationship('Message', back_populates='user')


class Message(Base):
    __tablename__ = 'Message_ids'

    id: Mapped[int] = mapped_column(primary_key=True, autoincrement=True)
    chat_id: Mapped[int] = mapped_column(ForeignKey('Users.id'))
    message_id: Mapped[int] = mapped_column()
    date_added: Mapped[str] = mapped_column(String(20))

    user = relationship('User', back_populates='messages')

Вопрос такой - когда мы деплоим бота, как правильно создавать миграции?

Как вариант:
Base.metadata.create_all(engine)
но может есть что-то по типу manage.py migrate как у Джанго? Чтобы не через код всё это делать, а через консоль.

Answer 1

[Everything_is_bad]

В SQLAlchemy нет миграций, create_all это создание таблиц с нуля, обычно это требуется очень редко. Да и вообще, DDL запросы сами по себе очень редко вызываются внутри рабочего сервиса, это обычно делается извне. А для миграций используют отдельную библиотеку Alembic.

Comments

[Харо]

Представим ситуацию, код на сервере, БД (пустая через Докер) запущена, как правильнее создать таблицы и связи, чтобы каждый раз не вызывать:

Base.metadata.create_all(engine)

Через Alembic? Просьба объяснить насколько это возможно подробнее и проще - только только взялся осваивать алхимию.

[Everything_is_bad]

Харо, create_all по факту у тебя только один раз нужен, он не ничего не знает про изменения структуры, или ты каждый раз собираешься базу с нуля создавать? И да, Alembic это как раз про миграции, когда тебе надо перенести именно изменения структуры, а не создавать с нуля.

[Харо]

Everything_is_bad, на данный момент учусь - часто сношу код и базы, плюс хочется сделать красиво на будущее - вдруг нужно будет внести изменения в существующую базу, а у меня изначально сделано криво-косо.

Как я понял - нужно подключать Alembic, чтобы было правильно и удобно. Я просто с Django привык, что копируем код с Гита, мигрируем - готово. Причём мигрируем через консоль - один раз во время деплоя, поэтому мне показалось странным, что в доках/гайде была указана команда:

Base.metadata.create_all(engine)

Которую мы включаем в тело кода, который может и будет перезапускаться при ребутах сервера.

[Everything_is_bad]

Харо, Alembic не такой как миграция в джанго, с ним надо больше разбираться и он меньше умеет отслеживать изменений, некоторый миграции надо руками писать, а create_all это просто create table и подобное.