""" Версионируемые миграции: migrations/NNNN_name.sql. - Таблица schema_migrations хранит применённые версии → повторный запуск ничего не дублирует (идемпотентно). - Каждая миграция применяется в своей транзакции: либо целиком, либо никак. - pg_advisory_lock: если стартуют несколько API одновременно, миграции выполнит только один, остальные подождут. Запуск вручную: python -m app.migrate """ from __future__ import annotations import asyncio import logging from pathlib import Path import psycopg from .config import settings log = logging.getLogger("messenger.migrate") MIGRATIONS_DIR = Path(__file__).resolve().parent.parent / "migrations" LOCK_ID = 824_113_2026 # произвольная константа для advisory lock async def migrate(conninfo: str | None = None) -> list[str]: applied_now: list[str] = [] async with await psycopg.AsyncConnection.connect( conninfo or settings.database_url, connect_timeout=settings.db_connect_timeout, autocommit=True) as conn: await conn.execute("SELECT pg_advisory_lock(%s)", (LOCK_ID,)) try: await conn.execute( "CREATE TABLE IF NOT EXISTS schema_migrations (" " version text PRIMARY KEY," " applied_at timestamptz NOT NULL DEFAULT now())") cur = await conn.execute("SELECT version FROM schema_migrations") done = {row[0] for row in await cur.fetchall()} for path in sorted(MIGRATIONS_DIR.glob("*.sql")): version = path.stem if version in done: continue async with conn.transaction(): await conn.execute(path.read_text(encoding="utf-8")) await conn.execute( "INSERT INTO schema_migrations (version) VALUES (%s)", (version,)) applied_now.append(version) log.info("migration applied: %s", version) finally: await conn.execute("SELECT pg_advisory_unlock(%s)", (LOCK_ID,)) return applied_now if __name__ == "__main__": logging.basicConfig(level=logging.INFO) result = asyncio.run(migrate()) print("applied:", result or "nothing (up to date)")