Официальная документация SQLAlchemy 2.x
-
SQLAlchemy 2.0 Documentation
— главная страница. Убедитесь, что читаете версию 2.x (не 1.4): адрес содержит
/en/20/. - ORM Quick Start — быстрый старт с ORM: создание движка, моделей, сессии, добавление данных. Отличная точка входа.
- Engine Configuration — подробно о create_engine: строки подключения для всех СУБД, параметры пула соединений.
- Using the Session — жизненный цикл сессии, состояния объектов (Transient, Pending, Persistent, Detached, Deleted), commit/rollback/close.
-
Declarative Tables
— декларативный стиль объявления моделей:
DeclarativeBase,Mapped,mapped_column. - ORM Mapper Configuration — все стили маппинга: Declarative ORM, Core Table, Imperative, Hybrid, Dataclass. Соответствует разделу «Стили маппинга» в теории.
- Column and Data Types — полный список типов: Integer, String, Float, Boolean, Numeric, DateTime и другие.
Логирование событий
- SQLAlchemy — Configuring Logging — как настроить вывод SQL-запросов через модуль logging.
- Python — модуль logging — официальная документация стандартного модуля логирования Python.
Миграция 1.x → 2.x
- SQLAlchemy 2.0 Migration Guide — если работаете с легаси-проектом на 1.x. Объясняет все изменения синтаксиса.
SQLite
- SQLite Documentation — официальная документация SQLite.
- DB Browser for SQLite — бесплатная GUI-программа для просмотра .db файлов. Полезна для отладки.
⚠️ При поиске примеров в интернете проверяйте версию SQLAlchemy. Признаки кода на 1.x:
declarative_base(), Column(Integer, ...), sessionmaker(bind=engine), session.query(). В курсе используем 2.x.