Files
mtusi2026lab2-fork/app/core/database.py
T

56 lines
2.3 KiB
Python

"""Engine и фабрика сессий SQLAlchemy.
Живёт рядом с config.py, но отдельно: Settings только описывает параметры,
а создание ресурсов (engine, пул) — здесь, чтобы тесты могли подменять Settings.
"""
import logging
from sqlalchemy import Engine, create_engine, text
from sqlalchemy.exc import SQLAlchemyError
from sqlalchemy.orm import Session, sessionmaker
from app.core.config import Settings
logger = logging.getLogger(__name__)
def create_db_engine(settings: Settings) -> Engine:
"""Создаёт engine с ограниченным пулом и таймаутами.
create_engine ленивый: подключение к БД происходит при первом запросе,
поэтому приложение стартует и без доступной БД (ready вернёт 503).
"""
return create_engine(
settings.get_database_url(),
pool_size=settings.db_pool_size,
max_overflow=settings.db_max_overflow,
pool_timeout=settings.db_pool_timeout_seconds,
pool_pre_ping=True,
connect_args={
"connect_timeout": settings.db_connect_timeout_seconds,
"options": f"-c statement_timeout={settings.db_statement_timeout_ms}",
},
)
def create_session_factory(engine: Engine) -> sessionmaker[Session]:
"""Фабрика сессий: одна сессия на HTTP-запрос (см. endpoints/dependencies.py).
expire_on_commit=False — после commit объекты остаются читаемыми, и domain
может собрать ответ без повторного SELECT.
autoflush=False — flush вызываем явно, поведение предсказуемо.
"""
return sessionmaker(bind=engine, expire_on_commit=False, autoflush=False)
def check_database(engine: Engine) -> bool:
"""True, если БД отвечает на SELECT 1. Используется в /health/ready."""
try:
with engine.connect() as connection:
connection.execute(text("SELECT 1"))
except SQLAlchemyError:
logger.warning("database readiness check failed", exc_info=True)
return False
return True