Метод nulls_last

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

Синтаксис

column.nulls_last()

Пример

Давайте создадим модель и добавим в таблицу несколько записей, часть из которых содержит NULL в столбце num:

from sqlalchemy import create_engine, Integer, String
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] = mapped_column(String(50))
	text: Mapped[str] = mapped_column(String(200))
	status: Mapped[str] = mapped_column(String(20))
	num: Mapped[int] = mapped_column(Integer, nullable=True)

Теперь заполним таблицу данными и применим метод nulls_last к столбцу num:

from sqlalchemy import create_engine, select
from sqlalchemy.orm import Session
from models import Base, Article

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='draft', num=30),
		Article(title='article 2', text='text 2', status='published', num=None),
		Article(title='article 3', text='text 3', status='draft', num=10),
		Article(title='article 4', text='text 4', status='published', num=None),
	])
	session.commit()
	
	stmt = select(Article.title, Article.num).order_by(Article.num.nulls_last())
	res = session.execute(stmt).all()
	print(res)

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

[('article 3', 10), ('article 1', 30), ('article 2', None), ('article 4', None)]

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

SELECT articles.title, articles.num
FROM articles
ORDER BY articles.num NULLS LAST

Пример

Метод nulls_last удобно комбинировать с методом desc, чтобы отсортировать значения по убыванию, а NULL все равно оказались в конце:

from sqlalchemy import create_engine, select
from sqlalchemy.orm import Session
from models import Base, Article

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='draft', num=30),
		Article(title='article 2', text='text 2', status='published', num=None),
		Article(title='article 3', text='text 3', status='draft', num=10),
		Article(title='article 4', text='text 4', status='published', num=None),
	])
	session.commit()
	
	stmt = (
		select(Article.title, Article.num)
		.order_by(Article.num.desc().nulls_last())
	)
	res = session.execute(stmt).all()
	print(res)

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

[('article 1', 30), ('article 3', 10), ('article 2', None), ('article 4', None)]

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

SELECT articles.title, articles.num
FROM articles
ORDER BY articles.num DESC NULLS LAST

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

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