В чем ключевые различия между SQLAlchemy 1.4 и 2.0

Ключевое различие заключается в том, что SQLAlchemy 2.0 вводит новый, полностью типизированный и унифицированный API (т.н. "2.0 style"), который стал стандартом. Версия 1.4 была переходной и поддерживала оба стиля (старый 1.x и новый 2.0) для обратной совместимости.

Основные отличия SQLAlchemy 2.0:

1. Унифицированный Core API: Метод session.query() был заменен на select(), что унифицирует работу с Core и ORM.
2. Полная поддержка типизации: Введены Mapped и mapped_column для явного объявления колонок модели, что обеспечивает полную поддержку статических анализаторов, таких как Mypy.
3. Нативная поддержка asyncio: API для асинхронной работы был полностью переработан и стал более стабильным и интуитивным.

Сравнение синтаксиса:

• Стиль 1.4 (и ранее):

  from sqlalchemy import Column, Integer, String
  from sqlalchemy.ext.declarative import declarative_base
  
  Base = declarative_base()
  
  class User(Base):
      __tablename__ = 'users'
      id = Column(Integer, primary_key=True)
      name = Column(String(50))
  
  # Запрос
  # users = session.query(User).filter_by(name='John').all()

• Стиль 2.0 (рекомендуемый):

  from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
  
  class Base(DeclarativeBase):
      pass
  
  class User(Base):
      __tablename__ = 'users'
      id: Mapped[int] = mapped_column(primary_key=True)
      name: Mapped[str] = mapped_column(String(50))
  
  # Запрос
  # from sqlalchemy import select
  # statement = select(User).where(User.name == 'John')
  # users = session.scalars(statement).all()

Рекомендация: Для всех новых проектов следует использовать исключительно синтаксис SQLAlchemy 2.0.