Функция func.max

Функция func.max представляет собой агрегатную SQL-функцию MAX и возвращает максимальное значение по указанному столбцу. Первым параметром передается выражение столбца, по которому нужно найти максимум. Функция часто применяется вместе с group_by для поиска максимума в каждой группе строк.

Синтаксис

func.max(column, [filter])

Пример

Давайте создадим таблицу articles и найдем максимальное значение столбца num:

from sqlalchemy import create_engine, func, 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]
	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', num=10),
		Article(title='article 2', num=25),
		Article(title='article 3', num=7),
	])
	session.commit()
	
	res = session.execute(select(func.max(Article.num))).scalar()
	print(res)

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

25

Пример

Давайте присвоим результату функции псевдоним через метод label и выведем его:

from sqlalchemy import create_engine, func, 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]
	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', status='published', num=10),
		Article(title='article 2', status='draft', num=25),
		Article(title='article 3', status='published', num=7),
	])
	session.commit()
	
	stmt = select(func.max(Article.num).label('max_num'))
	res = session.execute(stmt).scalar()
	print(res)

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

25

Пример

Давайте найдем максимальное значение столбца num для каждой группы строк по столбцу status с помощью group_by:

from sqlalchemy import create_engine, func, 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]
	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', status='published', num=10),
		Article(title='article 2', status='draft', num=25),
		Article(title='article 3', status='published', num=7),
	])
	session.commit()
	
	stmt = select(Article.status, func.max(Article.num))
	stmt = stmt.group_by(Article.status)
	res = session.execute(stmt).all()
	print(res)

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

[('draft', 25), ('published', 10)]

Пример

Давайте посмотрим итоговый SQL-запрос, который строит функция func.max:

from sqlalchemy import create_engine, func, 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]
	num: Mapped[int]

stmt = select(func.max(Article.num))
print(stmt)

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

SELECT max(articles.num) AS max_1
FROM articles

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

функцию func.min,
которая возвращает минимальное значение по столбцу
функцию func.sum,
которая возвращает сумму значений по столбцу
функцию func.avg,
которая возвращает среднее значение по столбцу
функцию func.count,
которая возвращает количество строк