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

Метод op класса ColumnElement позволяет сформировать бинарное выражение с произвольным SQL-оператором. Первым параметром метод принимает строку с оператором, вторым - правый операнд, а именованные параметры return_type, is_comparison и is_order_by управляют типом результата и семантикой выражения. Метод полезен, когда нужен оператор, не покрытый стандартными методами вроде like или in_.

Синтаксис

ColumnElement.op(op, *other, **kwargs)

Пример

Давайте создадим модель и применим произвольный оператор ~ для поиска заголовков по регулярному выражению:

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]

engine = create_engine('sqlite:///:memory:')
Base.metadata.create_all(engine)

with Session(engine) as session:
	session.add_all([
		Article(title='article 1'),
		Article(title='article 2'),
		Article(title='user 1'),
	])
	session.commit()
	
	stmt = select(Article).where(Article.title.op('~')('article'))
	res = session.scalars(stmt).all()
	print([a.title for a in res])

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

['article 1', 'article 2']

Пример

Давайте передадим параметр is_comparison=True, чтобы выражение участвовало в сравнении:

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]

engine = create_engine('sqlite:///:memory:')
Base.metadata.create_all(engine)

with Session(engine) as session:
	session.add_all([
		Article(title='article 1'),
		Article(title='article 2'),
		Article(title='user 1'),
	])
	session.commit()
	
	expr = Article.title.op('GLOB', is_comparison=True)('article*')
	stmt = select(Article).where(expr)
	res = session.scalars(stmt).all()
	print([a.title for a in res])

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

['article 1', 'article 2']

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

класс ColumnElement,
который представляет элемент SQL-выражения
метод like,
который выполняет поиск по шаблону
метод in_,
который проверяет вхождение в список
метод bool_op,
который создает булево операторное выражение