Функция null
Функция null создает SQL-выражение, представляющее
значение NULL. Функция не принимает параметров.
Полученное выражение можно использовать в запросах
для вставки, обновления или сравнения значений,
а также для построения условных выражений.
Синтаксис
null()
Пример
Давайте создадим выражение NULL и выведем его:
from sqlalchemy import null
expr = null()
print(expr)
Результат выполнения кода:
"NULL"
Пример
Давайте вставим значение NULL в колонку
text таблицы articles:
from sqlalchemy import create_engine, null
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]
engine = create_engine('sqlite:///:memory:')
Base.metadata.create_all(engine)
with Session(engine) as session:
article = Article(title='article', text=None)
session.add(article)
session.commit()
print(article.text)
Результат выполнения кода:
None
Пример
Давайте обновим колонку status таблицы
articles, установив ей значение NULL
через SQL-выражение:
from sqlalchemy import create_engine, null, update
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]
engine = create_engine('sqlite:///:memory:')
Base.metadata.create_all(engine)
with Session(engine) as session:
article = Article(title='article', status='user')
session.add(article)
session.commit()
stmt = update(Article).values(status=null())
session.execute(stmt)
session.commit()
session.refresh(article)
print(article.status)
Результат выполнения кода:
None
Пример
Давайте сравним значение колонки num
с выражением NULL через оператор is_:
from sqlalchemy import create_engine, null, 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=None),
Article(title='article 2', num=10),
])
session.commit()
stmt = select(Article.title).where(Article.num.is_(null()))
res = session.execute(stmt).scalars().all()
print(res)
Результат выполнения кода:
['article 1']
