Класс Coalesce

Класс Coalesce применяется в запросах Django для возврата первого не-NULL значения из переданных выражений. Он принимает два или более аргументов и возвращает значение первого аргумента, который не равен NULL. Это особенно полезно при работе с полями, которые могут содержать пустые значения, позволяя задать значение по умолчанию или выбрать первый доступный вариант из нескольких полей.

Класс Coalesce импортируется из модуля django.db.models. Он может использоваться вместе с методами annotate, aggregate, filter и другими для построения сложных запросов. В выражении можно использовать как поля модели, так и значения Value или другие выражения.

Синтаксис

pythonfrom django.db.models import Coalesce, Value

Coalesce(expression1, expression2, ..., default_value)

Пример

Рассмотрим простой пример использования Coalesce для замены NULL значений в поле:

pythonfrom django.db.models import Coalesce, Value
from myapp.models import Article

# Если поле summary равно NULL, используем пустую строку
articles = Article.objects.annotate(
  display_summary=Coalesce('summary', Value(''))
)

for article in articles:
  print(article.display_summary)

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

python"Short article summary"
""
"Another summary text"

Пример

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

pythonfrom django.db.models import Coalesce, Value
from myapp.models import User

# Приоритет полей: nickname, first_name, username
users = User.objects.annotate(
  display_name=Coalesce(
    'nickname',
    'first_name',
    'username',
    Value('Anonymous')
  )
)

for user in users:
  print(user.display_name)

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

python"john_doe"
"Anonymous"
"alice_w"
"bob"

Пример

Используем Coalesce в сочетании с другими выражениями для построения более сложной логики:

pythonfrom django.db.models import Coalesce, F, Value, Sum
from datetime import date
from myapp.models import Order

# Если дата оплаты не установлена, используем дату создания
orders = Order.objects.annotate(
  effective_date=Coalesce(
    'paid_at',
    'created_at',
    Value(date.today())
  )
).filter(
  effective_date__gte=date(2025, 1, 1)
)

for order in orders:
  print(order.id, order.effective_date)

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

python(1, datetime.date(2025, 1, 15))
(2, datetime.date(2025, 1, 20))
(3, datetime.date(2025, 2, 1))

Пример

Используем Coalesce с агрегацией для обработки суммарных значений:

pythonfrom django.db.models import Coalesce, Sum, Value
from myapp.models import Product

# Если сумма продаж равна NULL, заменяем на 0
result = Product.objects.aggregate(
  total_sales=Coalesce(Sum('sales'), Value(0))
)

print(result['total_sales'])

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

python"15750"

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