Метод filter класса Select
Метод filter класса Select добавляет
условие фильтрации к SQL-запросу, которое
преобразуется в секцию WHERE. Первым параметром
метод принимает критерий фильтрации в виде
SQL-выражения. Можно передавать несколько
критериев, которые объединяются оператором AND.
Синтаксис
select(Model).filter(*criterion)
Пример
Давайте создадим модель и отфильтруем статьи по статусу:
from sqlalchemy import create_engine, select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, Session
class Base(DeclarativeBase):
pass
class Article(Base):
__tablename__ = 'articles'
id: Mapped[int] = mapped_column(primary_key=True)
title: Mapped[str]
text: Mapped[str]
status: Mapped[str]
num: Mapped[int]
engine = create_engine('sqlite:///:memory:')
Base.metadata.create_all(engine)
with Session(engine) as session:
session.add_all([
Article(title='article 1', text='text 1', status='published', num=1),
Article(title='article 2', text='text 2', status='draft', num=2),
Article(title='article 3', text='text 3', status='published', num=3),
])
session.commit()
stmt = select(Article).filter(Article.status == 'published')
res = session.scalars(stmt).all()
for article in res:
print(article.title)
Результат выполнения кода:
article 1
article 3
Пример
Давайте передадим несколько критериев
в метод filter, которые объединятся
оператором AND:
from sqlalchemy import create_engine, select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, Session
class Base(DeclarativeBase):
pass
class Article(Base):
__tablename__ = 'articles'
id: Mapped[int] = mapped_column(primary_key=True)
title: Mapped[str]
text: Mapped[str]
status: Mapped[str]
num: Mapped[int]
engine = create_engine('sqlite:///:memory:')
Base.metadata.create_all(engine)
with Session(engine) as session:
session.add_all([
Article(title='article 1', text='text 1', status='published', num=1),
Article(title='article 2', text='text 2', status='draft', num=2),
Article(title='article 3', text='text 3', status='published', num=3),
])
session.commit()
stmt = select(Article).filter(
Article.status == 'published',
Article.num > 1
)
res = session.scalars(stmt).all()
for article in res:
print(article.title)
Результат выполнения кода:
article 3
Пример
Давайте посмотрим итоговый SQL-запрос,
который генерирует метод filter:
from sqlalchemy import create_engine, select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
class Base(DeclarativeBase):
pass
class Article(Base):
__tablename__ = 'articles'
id: Mapped[int] = mapped_column(primary_key=True)
title: Mapped[str]
text: Mapped[str]
status: Mapped[str]
num: Mapped[int]
stmt = select(Article).filter(Article.status == 'published')
print(stmt)
Итоговый SQL запрос:
SELECT articles.id, articles.title, articles.text, articles.status, articles.num
FROM articles
WHERE articles.status = :status_1
