Метод notin_

Метод notin_ класса ColumnElement создает SQL-выражение NOT IN. Оно проверяет, что значение столбца не входит в переданный набор значений. Метод принимает один параметр other - это может быть список, кортеж, подзапрос или другой объект ColumnElement. Метод возвращает новый объект BinaryExpression, который можно использовать в условиях where, filter и других конструкциях языка запросов.

Синтаксис

column_element.notin_(other)

Пример

Давайте создадим простое условие с методом notin_ и выведем его в виде SQL-запроса:

from sqlalchemy import 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]
	text: Mapped[str]
	status: Mapped[str]
	num: Mapped[int]

stmt = select(Article).where(
	Article.status.notin_(['draft', 'archived'])
)
print(stmt)

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

"SELECT articles.id, articles.title, articles.text, articles.status, articles.num 
FROM articles 
WHERE articles.status NOT IN (__[POSTCOMPILE_status_1])"

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

SELECT articles.id, articles.title, articles.text, articles.status, articles.num 
FROM articles 
WHERE articles.status NOT IN ('draft', 'archived')

Пример

Давайте применим метод notin_ в запросе к базе данных и выведем найденные записи:

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='published', num=1),
		Article(title='article 2', text='text 2', status='draft', num=2),
		Article(title='article 3', text='text 3', status='archived', num=3),
		Article(title='article 4', text='text 4', status='published', num=4),
	])
	session.commit()
	
	stmt = select(Article).where(
		Article.status.notin_(['draft', 'archived'])
	)
	res = session.scalars(stmt).all()
	for article in res:
		print(article.title, article.status)

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

"article 1 published
article 4 published"

Пример

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

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='published', num=10),
		Article(title='article 2', text='text 2', status='published', num=20),
		Article(title='article 3', text='text 3', status='published', num=30),
		Article(title='article 4', text='text 4', status='published', num=40),
	])
	session.commit()
	
	stmt = select(Article).where(
		Article.num.notin_((10, 30))
	)
	res = session.scalars(stmt).all()
	for article in res:
		print(article.title, article.num)

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

"article 2 20
article 4 40"

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

метод in_,
который создает выражение IN для проверки вхождения значения
класс ColumnElement,
который представляет базовый элемент столбца
метод is_not,
который создает выражение IS NOT для сравнения с NULL
метод between,
который создает выражение BETWEEN для проверки диапазона