Метод limit класса Select
Метод limit класса Select ограничивает
количество строк, которые вернет запрос. Первым
параметром метод принимает целое число - максимальное
количество строк в результате. Метод возвращает новый
объект Select, поэтому его можно объединять
в цепочку с другими методами.
Синтаксис
select(...).limit(limit)
Пример
Давайте создадим таблицу articles и добавим
в нее несколько записей:
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),
Article(title='article 4', text='text 4', status='draft', num=4),
Article(title='article 5', text='text 5', status='published', num=5),
])
session.commit()
Пример
Давайте выберем только первые три статьи с помощью
метода limit:
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),
Article(title='article 4', text='text 4', status='draft', num=4),
Article(title='article 5', text='text 5', status='published', num=5),
])
session.commit()
query = select(Article.title).limit(3)
res = session.execute(query).scalars().all()
print(res)
Результат выполнения кода:
['article 1', 'article 2', 'article 3']
Пример
Давайте объединим limit с методом
order_by, чтобы получить три статьи
с наибольшим значением num:
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),
Article(title='article 4', text='text 4', status='draft', num=4),
Article(title='article 5', text='text 5', status='published', num=5),
])
session.commit()
query = select(Article.title).order_by(Article.num.desc()).limit(3)
res = session.execute(query).scalars().all()
print(res)
Результат выполнения кода:
['article 5', 'article 4', 'article 3']
Пример
Давайте посмотрим итоговый SQL-запрос,
который генерирует метод limit:
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]
query = select(Article.title).limit(3)
print(query)
Итоговый SQL запрос:
SELECT articles.title
FROM articles
LIMIT 3
