Django模型层之字段查询参数及聚合函数

拼搏现实的明天。 2022-10-01 14:57 121阅读 0赞

字段查询是指如何指定SQL WHERE子句的内容。它们用作QuerySet的filter(), exclude()和get()方法的关键字参数。

**默认查找类型为exact。**

下表列出了所有的字段查询参数：

![1240][]

**1. exact**

精确匹配。 默认的查找类型！

![1240][1240 1]

**2. iexact**

不区分大小写的精确匹配。

![1240][1240 2]

第一个查询将匹配 'Beatles Blog', 'beatles blog', 'BeAtLes BLoG'等等。

**3. contains**

大小写敏感的包含关系匹配。

Entry.objects.get(headline\_\_contains='Lennon')

这将匹配标题'Lennon honored today'，但不匹配'lennon honored today'。

**4. icontains**

不区分大小写的包含关系匹配。

Entry.objects.get(headline\_\_icontains='Lennon')

**5. in**

在给定的列表里查找。

Entry.objects.filter(id\_\_in=\[1,3,4\])

还可以使用动态查询集，而不是提供文字值列表：

![1240][1240 3]

或者从values()或values\_list()中获取的QuerySet作为比对的对象：

![1240][1240 4]

下面的例子将产生一个异常，因为试图提取两个字段的值，但是查询语句只需要一个字段的值：

![1240][1240 5]

**6. gt**

大于

Entry.objects.filter(id\_\_gt=4)

**7. gte**

大于或等于

**8. lt**

小于

**9. lte**

小于或等于

**10. startswith**

区分大小写，从开始位置匹配。

Entry.objects.filter(headline\_\_startswith='Lennon')

**11. istartswith**

不区分大小写，从开始位置匹配。

Entry.objects.filter(headline\_\_istartswith='Lennon')

**12. endswith**

区分大小写，从结束未知开始匹配。

Entry.objects.filter(headline\_\_endswith='Lennon')

**13. iendswith**

不区分大小写，从结束未知开始匹配。

Entry.objects.filter(headline\_\_iendswith='Lennon')

**14. range**

范围测试（包含于之中）。

![1240][1240 6]

警告:过滤具有日期的DateTimeField不会包含最后一天，因为边界被解释为“给定日期的0am”。

**15. date**

进行日期对比。

![1240][1240 7]

当USE\_TZ为True时，字段将转换为当前时区，然后进行过滤。

**16. year**

对年份进行匹配。

![1240][1240 8]

当USE\_TZ为True时，在过滤之前，datetime字段将转换为当前时区。

**17. month**

对月份进行匹配。取整数1（1月）至12（12月）。

![1240][1240 9]

当USE\_TZ为True时，在过滤之前，datetime字段将转换为当前时区。

**18. day**

对具体到某一天的匹配。

![1240][1240 10]

当USE\_TZ为True时，在过滤之前，datetime字段将转换为当前时区。

**19. week**

Django1.11中的新功能。根据ISO-8601返回周号（1-52或53），即星期一开始的星期，星期四或之前的第一周。

![1240][1240 11]

当USE\_TZ为True时，字段将转换为当前时区，然后进行过滤。

**20. week\_day**

进行“星期几”匹配。 取整数值，星期日为1，星期一为2，星期六为7。

![1240][1240 12]

当USE\_TZ为True时，在过滤之前，datetime字段将转换为当前时区。

**21. time**

Django1.11中的新功能。

将字段的值转为datetime.time格式并进行对比。

![1240][1240 13]

USE\_TZ为True时，字段将转换为当前时区，然后进行过滤。

**22. hour**

对小时进行匹配。 取0和23之间的整数。

![1240][1240 14]

当USE\_TZ为True时，值将过滤前转换为当前时区。

**23. minute**

对分钟匹配。取0和59之间的整数。

![1240][1240 15]

当USE\_TZ为True时，值将被过滤前转换为当前时区。

**24. second**

对秒数进行匹配。取0和59之间的整数。

![1240][1240 16]

当USE\_TZ为True时，值将过滤前转换为当前时区。

**25. isnull**

值为False或True, 相当于SQL语句IS NULL和IS NOT NULL.

Entry.objects.filter(pub\_date\_\_isnull=True)

**26. search**

自1.10版以来已弃用。

**27. regex**

区分大小写的正则表达式匹配。

Entry.objects.get(title\_\_regex=r'^(An?|The) +')

建议使用原始字符串（例如，r'foo'而不是'foo'）来传递正则表达式语法。

**28. iregex**

不区分大小写的正则表达式匹配。

Entry.objects.get(title\_\_iregex=r'^(an?|the) +')

#### 聚合函数 ####

Django的django.db.models模块提供以下聚合函数。

1. expression

引用模型字段的一个字符串，或者一个query expression。

2. output\_field

用来表示返回值的model field，一个可选的参数。

3. \*\*extra

关键字参数可以给聚合函数生成的SQL提供额外的信息。

4. Avg

class Avg(expression, output\_field=FloatField(), \*\*extra)\[source\]

返回给定表达式的平均值，它必须是数值，除非指定不同的output\_field。

![1240][1240 17]

5. Count

class Count(expression, distinct=False, \*\*extra)\[source\]

返回与expression相关的对象的个数。

![1240][1240 18]

6. Max

class Max(expression, output\_field=None, \*\*extra)\[source\]

返回expression的最大值。

![1240][1240 19]

7. Min

class Min(expression, output\_field=None, \*\*extra)\[source\]

返回expression的最小值。

![1240][1240 20]

8. StdDev

class StdDev(expression, sample=False, \*\*extra)\[source\]

返回expression的标准差。

![1240][1240 21]

9. Sum

class Sum(expression, output\_field=None, \*\*extra)\[source\]

计算expression的所有值的和。

![1240][1240 22]

10. Variance

class Variance(expression, sample=False, \*\*extra)\[source\]

返回expression的方差。

![1240][1240 23]

转载于:https://blog.51cto.com/14246112/2385444

[1240]: /images/20220114/adf2b510d35e4facb98dd45f3e814d36.png
[1240 1]: /images/20220114/a2a36d2c540f4eceba5d6d6b10e2b11a.png
[1240 2]: /images/20220114/8732828578d942eb92de135b3d8ea00a.png
[1240 3]: /images/20220114/702744044656445bb7164ec2b0750293.png
[1240 4]: /images/20220114/8b25562ab65f4d2bb97fcfd4c1d9e0b3.png
[1240 5]: /images/20220114/d36d86ea2783400582fa42ec8b85b152.png
[1240 6]: /images/20220114/afe61a10c51b48edbfa51f52d3342bb5.png
[1240 7]: /images/20220114/5cc1d916f5b34b38ad318a2957002bc6.png
[1240 8]: /images/20220114/fe7b87ea70fb4f34b13fafcef499c307.png
[1240 9]: /images/20220114/0c4c17d10ad34bd78d24c9b50b4a5dd5.png
[1240 10]: /images/20220114/17d3e706139a4ba3b20761414268fcd0.png
[1240 11]: /images/20220114/dc036b06c48046209589b6131f229c9c.png
[1240 12]: /images/20220114/147fdd0cde5945449f55594470c88341.png
[1240 13]: /images/20220114/4bcef24dd91146a5b9478dde0d425064.png
[1240 14]: /images/20220114/259d186f477a416587ae0da882833fbe.png
[1240 15]: /images/20220114/af83e4b15ec249cbbcec4816c55a2901.png
[1240 16]: /images/20220114/5bbd6d1d5b0b4e759a688f5c53a4ae49.png
[1240 17]: /images/20220114/5ec6d053e32443d2989207b557cec3c1.png
[1240 18]: /images/20220114/3678b68cf2ff4878954b0baea395f55c.png
[1240 19]: /images/20220114/eb034c0700b9405ea169eb7624e0ad4a.png
[1240 20]: /images/20220114/fe86cc7671cb405cbc4a7aebf9a21a0e.png
[1240 21]: /images/20220114/524ceaead24242eabd0d29a115023725.png
[1240 22]: /images/20220114/6ce7fa7dbea4458ebe6ae6356f7175c1.png
[1240 23]: /images/20220114/55d85cfc6ae64bbf974b139d8979fe9e.png