1. 介绍

• Cast 转换类型
• Coalesce 优先取值
• Greatest 返回较大值
• Nullif 值相同返回 None

1. models准备

一般来说，对于 CharField 字段，我们是不推荐允许 null=True 存在的，因为这样的话，在数据库中就会存在两个空值，一个是 null，一个是空字符串 ‘’。

在这里允许这样操作是为了方便的介绍下面的功能。

注意下，数据库相关函数都是在 django.db.models.functions 模块下

class Author(models.Model):
    name = models.CharField(max_length=200)
    email = models.EmailField(null=True, default=None)
    age = models.IntegerField(null=True, blank=True)
    alias = models.CharField(max_length=50, null=True, blank=True)
    goes_by = models.CharField(max_length=50, null=True, blank=True)

2、Cast 转换类型

介绍

Cast 的作用，我们可以将其理解成转换数据类型，比如在 Author 中，age 字段是一个 Integer 数据。

但是如果我们想要获取数据的时候想要将其直接变成浮点型数据，就可以使用 Cast() 函数，通过 output_field=FloatField() 参数来指定输出类型。

测试

创建数据

# 先创建数据
from blog.models import Author
Author.objects.create(name='hunter', age=25)

返回一个新字段，通过 Cast() 函数来指定输出类型：

最后的输出就是一个浮点型数据了。

from django.db.models import FloatField
from django.db.models.functions import Cast

author = Author.objects.annotate(float_age=Cast('age', output_field=FloatField())).get(id=1)
print(author.float_age)

3、Coalesce 优先取值

介绍

Coalesce 的单词的含义是 合并、联合，但是在这里函数表现出的意义是，优先取值。

Coalesce() 接受多个字段或者表达式作为参数，至少为两个字段名称，然后会返回第一个非 null 的字段的值（注意： 空字符串 ‘’ 不被认为是 null 值）

每个元素都必须是相似的类型，否则会引起报错。

对于 Author 这个model，我们想要按照 alias, goes_by, name 三个字段的这个顺序来取值。

也就是说 有alias 字段就取 alias 的内容，否则取 goes_by 的字段值，goes_by 也没有 就取 name 字段，这种情况就可以使用 Coalesce() 来操作。

测试

先来创建几条数据：

Author.objects.create(alias="alias-1", goes_by='goes-by-1', name='name-1')
Author.objects.create(goes_by='goes-by-2', name='name-2')
Author.objects.create(name='name-3')
Author.objects.create(alias="", goes_by='goes-by-4', name='name-4')

接下来可以测试一下 Coalesce() 这个函数

from django.db.models.functions import Coalesce

author = Author.objects.annotate(new_field=Coalesce('alias', 'goes_by', 'name')).get(id=2)
print(author.new_field)
# 输出 alias-1

author = Author.objects.annotate(new_field=Coalesce('alias', 'goes_by', 'name')).get(id=3)
print(author.new_field)
# 输出 goes-by-2

author = Author.objects.annotate(new_field=Coalesce('alias', 'goes_by', 'name')).get(id=4)
print(author.new_field)
# 输出 name-3

author = Author.objects.annotate(new_field=Coalesce('alias', 'goes_by', 'name')).get(id=5)
print(author.new_field)
# 输出 空字符串 ''

空值的默认值

介绍

以上几个例子，我们就测试出了新建字段的取值优先顺序，以及空字符串和 null 在这个函数里的区别（会跳过值为 null 的数据，但是会取空字符串的字段值）。

测试

其实用到这里，我们可以发现这个函数的另一个用法，那就是 null 值下替换的默认值。

假设我们有一个字段，我们在取值的时候，想实现，如果该字段是 null，那么我们在取值的时候就想将其替换成另一个默认值，而不是返回 null 或者后续在内存中操作替换默认值，可以这样操作：

from django.db.models import Value
author = Author.objects.annotate(new_field=Coalesce('email', Value('xxx'))).get(id=5)
print(author.new_field)

# id 等于 5 的 Author 数据，email 字段为空，所以 new_field 的值被替换成了 'xxx'

默认值的处理也可以用在聚合中，比如聚合 Sum() 的时候，如果没有满足条件的数据，聚合的结果会是一个 null，但是我们可以自动将其变为 0：

from django.db.models import Sum, Value
Author.objects.aggregate(age_sum=Coalesce(Sum('age'), Value(0)))

4、Greatest 返回较大值

介绍

Greatest() 的用法与 Coalesce 相同，接受两个或多个类型相同的元素，返回最大的一个。

可以比较数字，和时间等字段类型。

这里示例我们使用 Entry model，我们只用两个整型字段：

class Entry(models.Model):
    number_of_comments = models.IntegerField()
    number_of_pingbacks = models.IntegerField()

用法如下：

from blog.models import Entry
from django.db.models.functions import Greatest

Entry.objects.annotate(max_value=Greatest("number_of_comments", "number_of_pingbacks")).get(id=2).max_value

# max_value 字段取值就会是number_of_comments 和 number_of_pingbacks 之间最大的

取值的下限

这里我们也可以挖掘出一个骚操作，那就是取值的下限

比如这两个字段的值都没有达到我们想要的阈值，比如说是2，我们希望返回的值至少是2，可以这样设计程序：

注意：

在MySQL 和 Oracle 中，如果 Greatest 中，只要有一个字段值为 null，那么结果就会返回 null，这一点一定要注意

Least() 这个取的是最小值，与 Greatest 作用是相反的，但用法是一样的，不多介绍

Entry.objects.annotate(max_value=Greatest("number_of_comments", "number_of_pingbacks", Value(2))).get(id=2).max_value

5、Nullif 值相同返回 None

介绍

获取两个字段，也可以是表达式的结果，或者是 Value() 的值，但两者的数据类型得一致，用于判断两者的值是否相同。

如果两者的值相同，则返回 Python 里的 None，不相同的话返回第一个表达式的值

用法示例如下：

Entry.objects.annotate(new_field=NullIf("number_of_comments", "number_of_pingbacks")).get(id=1).new_field

Entry.objects.annotate(new_field=NullIf("number_of_comments", Value(2))).get(id=1).new_field