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

Метод is_not класса ColumnElement создает выражение для проверки, что значение столбца не равно указанному значению, в том числе позволяет проверять неравенство с NULL. В отличие от обычного оператора сравнения !=, метод is_not корректно генерирует SQL-конструкцию IS NOT. Первым параметром метод принимает значение, с которым сравнивается столбец. Метод не принимает дополнительных параметров.

Синтаксис

column_element.is_not(other)

Пример

Давайте создадим модель и проверим, что значение столбца не равно NULL:

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)

stmt = select(Article).where(Article.text.is_not(None))
print(stmt)

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

SELECT articles.id, articles.title, articles.text, articles.status, articles.num 
FROM articles 
WHERE articles.text IS NOT NULL

Пример

Давайте проверим, что значение столбца не равно конкретной строке:

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)

stmt = select(Article).where(Article.status.is_not('article'))
print(stmt)

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

SELECT articles.id, articles.title, articles.text, articles.status, articles.num 
FROM articles 
WHERE articles.status IS NOT ?

Пример

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

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='article', num=1),
		Article(title='article 2', text=None, status='user', num=2),
		Article(title='article 3', text='text 3', status='article', num=3),
	])
	session.commit()
	
	stmt = select(Article.title).where(Article.text.is_not(None))
	res = session.execute(stmt).scalars().all()
	print(res)

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

['article 1', 'article 3']

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

класс ColumnElement,
который представляет базовый класс для элементов столбцов
метод is_,
который создает выражение для проверки равенства с NULL
метод is_distinct_from,
который создает выражение для проверки различия значений
метод is_not_distinct_from,
который создает выражение для проверки совпадения значений