Метод asc класса ColumnElement

Метод asc класса ColumnElement создает модификатор сортировки по возрастанию. Он применяется к столбцу или выражению и возвращает объект, который можно передать в метод order_by для упорядочивания результатов запроса от меньшего значения к большему.

Синтаксис

column.asc()

Пример

Давайте создадим простую модель и отсортируем записи по возрастанию значения поля id:

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 3', text='text 3', status='new', num=30),
		Article(title='article 1', text='text 1', status='new', num=10),
		Article(title='article 2', text='text 2', status='old', num=20),
	])
	session.commit()
	
	stmt = select(Article).order_by(Article.id.asc())
	res = session.scalars(stmt).all()
	
	for article in res:
		print(article.title)

Результат выполнения кода:

"article 3"
"article 1"
"article 2"

Итоговый SQL запрос:

SELECT articles.id, articles.title, articles.text, articles.status, articles.num
FROM articles
ORDER BY articles.id ASC

Пример

Давайте отсортируем статьи по возрастанию значения поля 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 3', text='text 3', status='new', num=30),
		Article(title='article 1', text='text 1', status='new', num=10),
		Article(title='article 2', text='text 2', status='old', num=20),
	])
	session.commit()
	
	stmt = select(Article).order_by(Article.num.asc())
	res = session.scalars(stmt).all()
	
	for article in res:
		print(article.num, article.title)

Результат выполнения кода:

"10 article 1"
"20 article 2"
"30 article 3"

Пример

Метод asc можно применять к произвольному выражению, например к функции длины строки:

from sqlalchemy import create_engine, select, func
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='long article', text='text 3', status='new', num=30),
		Article(title='article', text='text 1', status='new', num=10),
		Article(title='mid', text='text 2', status='old', num=20),
	])
	session.commit()
	
	stmt = select(Article).order_by(func.length(Article.title).asc())
	res = session.scalars(stmt).all()
	
	for article in res:
		print(article.title)

Результат выполнения кода:

"mid"
"article"
"long article"

Смотрите также

класс ColumnElement,
который представляет элемент столбца
метод desc,
который создает сортировку по убыванию
метод nulls_first,
который размещает NULL-значения в начале
метод nulls_last,
который размещает NULL-значения в конце