Метод order_by класса Select
Метод order_by класса Select
задает сортировку строк в результирующем
наборе запроса. Первым параметром метод
принимает одно или несколько выражений
сортировки, например колонки таблицы или
результаты функций. По умолчанию сортировка
выполняется по возрастанию, а для убывания
используется метод desc колонки.
Метод можно вызывать несколько раз, при этом каждый новый вызов добавляет выражение сортировки к уже существующим. Порядок выражений определяет приоритет сортировки.
Синтаксис
select(Model).order_by(column, [column, ...])
Пример
Давайте создадим модель Article и
отсортируем статьи по заголовку по
возрастанию:
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 2', text='text 2', status='ok', num=20),
Article(title='article 1', text='text 1', status='ok', num=10),
Article(title='article 3', text='text 3', status='ok', num=30),
])
session.commit()
stmt = select(Article).order_by(Article.title)
res = session.scalars(stmt).all()
for article in res:
print(article.title)
Результат выполнения кода:
article 1
article 2
article 3
Итоговый SQL запрос:
SELECT articles.id, articles.title, articles.text, articles.status, articles.num
FROM articles
ORDER BY articles.title
Пример
Давайте отсортируем статьи по колонке
num по убыванию с помощью метода
desc:
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='ok', num=10),
Article(title='article 2', text='text 2', status='ok', num=30),
Article(title='article 3', text='text 3', status='ok', num=20),
])
session.commit()
stmt = select(Article).order_by(Article.num.desc())
res = session.scalars(stmt).all()
for article in res:
print(article.num)
Результат выполнения кода:
30
20
10
Итоговый SQL запрос:
SELECT articles.id, articles.title, articles.text, articles.status, articles.num
FROM articles
ORDER BY articles.num DESC
Пример
Давайте отсортируем статьи сразу по двум
колонкам: сначала по status, затем по
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='ok', num=30),
Article(title='article 2', text='text 2', status='new', num=10),
Article(title='article 3', text='text 3', status='ok', num=20),
])
session.commit()
stmt = select(Article).order_by(Article.status, Article.num)
res = session.scalars(stmt).all()
for article in res:
print(article.status, article.num)
Результат выполнения кода:
new 10
ok 20
ok 30
Итоговый SQL запрос:
SELECT articles.id, articles.title, articles.text, articles.status, articles.num
FROM articles
ORDER BY articles.status, articles.num
