Django模型層之字段查詢參數(shù)及聚合函數(shù)

字段查詢是指如何指定SQL WHERE子句的內(nèi)容。它們用作QuerySet的filter(), exclude()和get()方法的關(guān)鍵字參數(shù)。

默認(rèn)查找類型為exact。

下表列出了所有的字段查詢參數(shù)：

1. exact

精確匹配。 默認(rèn)的查找類型！

2. iexact

不區(qū)分大小寫的精確匹配。

第一個(gè)查詢將匹配 'Beatles Blog', 'beatles blog', 'BeAtLes BLoG'等等。

3. contains

大小寫敏感的包含關(guān)系匹配。

Entry.objects.get(headline__contains='Lennon')

這將匹配標(biāo)題'Lennon honored today'，但不匹配'lennon honored today'。

4. icontains

不區(qū)分大小寫的包含關(guān)系匹配。

Entry.objects.get(headline__icontains='Lennon')

5. in

在給定的列表里查找。

Entry.objects.filter(id__in=[1,3,4])

還可以使用動(dòng)態(tài)查詢集，而不是提供文字值列表：

或者從values()或values_list()中獲取的QuerySet作為比對(duì)的對(duì)象：

下面的例子將產(chǎn)生一個(gè)異常，因?yàn)樵噲D提取兩個(gè)字段的值，但是查詢語(yǔ)句只需要一個(gè)字段的值：

6. gt

大于

Entry.objects.filter(id__gt=4)

7. gte

大于或等于

8. lt

小于

9. lte

小于或等于

10. startswith

區(qū)分大小寫，從開(kāi)始位置匹配。

Entry.objects.filter(headline__startswith='Lennon')

11. istartswith

不區(qū)分大小寫，從開(kāi)始位置匹配。

Entry.objects.filter(headline__istartswith='Lennon')

12. endswith

區(qū)分大小寫，從結(jié)束未知開(kāi)始匹配。

Entry.objects.filter(headline__endswith='Lennon')

13. iendswith

不區(qū)分大小寫，從結(jié)束未知開(kāi)始匹配。

Entry.objects.filter(headline__iendswith='Lennon')

14. range

范圍測(cè)試（包含于之中）。

警告:過(guò)濾具有日期的DateTimeField不會(huì)包含最后一天，因?yàn)檫吔绫唤忉尀椤敖o定日期的0am”。

15. date

進(jìn)行日期對(duì)比。

當(dāng)USE_TZ為True時(shí)，字段將轉(zhuǎn)換為當(dāng)前時(shí)區(qū)，然后進(jìn)行過(guò)濾。

16. year

對(duì)年份進(jìn)行匹配。

當(dāng)USE_TZ為True時(shí)，在過(guò)濾之前，datetime字段將轉(zhuǎn)換為當(dāng)前時(shí)區(qū)。

17. month

對(duì)月份進(jìn)行匹配。取整數(shù)1（1月）至12（12月）。

當(dāng)USE_TZ為True時(shí)，在過(guò)濾之前，datetime字段將轉(zhuǎn)換為當(dāng)前時(shí)區(qū)。

18. day

對(duì)具體到某一天的匹配。

當(dāng)USE_TZ為True時(shí)，在過(guò)濾之前，datetime字段將轉(zhuǎn)換為當(dāng)前時(shí)區(qū)。

19. week

Django1.11中的新功能。根據(jù)ISO-8601返回周號(hào)（1-52或53），即星期一開(kāi)始的星期，星期四或之前的第一周。

當(dāng)USE_TZ為True時(shí)，字段將轉(zhuǎn)換為當(dāng)前時(shí)區(qū)，然后進(jìn)行過(guò)濾。

20. week_day

進(jìn)行“星期幾”匹配。 取整數(shù)值，星期日為1，星期一為2，星期六為7。

當(dāng)USE_TZ為True時(shí)，在過(guò)濾之前，datetime字段將轉(zhuǎn)換為當(dāng)前時(shí)區(qū)。

21. time

Django1.11中的新功能。

將字段的值轉(zhuǎn)為datetime.time格式并進(jìn)行對(duì)比。

USE_TZ為True時(shí)，字段將轉(zhuǎn)換為當(dāng)前時(shí)區(qū)，然后進(jìn)行過(guò)濾。

22. hour

對(duì)小時(shí)進(jìn)行匹配。 取0和23之間的整數(shù)。

當(dāng)USE_TZ為True時(shí)，值將過(guò)濾前轉(zhuǎn)換為當(dāng)前時(shí)區(qū)。

23. minute

對(duì)分鐘匹配。取0和59之間的整數(shù)。

當(dāng)USE_TZ為True時(shí)，值將被過(guò)濾前轉(zhuǎn)換為當(dāng)前時(shí)區(qū)。

24. second

對(duì)秒數(shù)進(jìn)行匹配。取0和59之間的整數(shù)。

當(dāng)USE_TZ為True時(shí)，值將過(guò)濾前轉(zhuǎn)換為當(dāng)前時(shí)區(qū)。

25. isnull

值為False或True, 相當(dāng)于SQL語(yǔ)句IS NULL和IS NOT NULL.

Entry.objects.filter(pub_date__isnull=True)

26. search

自1.10版以來(lái)已棄用。

27. regex

區(qū)分大小寫的正則表達(dá)式匹配。

Entry.objects.get(title__regex=r'^(An?|The) +')

建議使用原始字符串（例如，r'foo'而不是'foo'）來(lái)傳遞正則表達(dá)式語(yǔ)法。

28. iregex

不區(qū)分大小寫的正則表達(dá)式匹配。

Entry.objects.get(title__iregex=r'^(an?|the) +')

聚合函數(shù)

Django的django.db.models模塊提供以下聚合函數(shù)。

1. expression

引用模型字段的一個(gè)字符串，或者一個(gè)query expression。

2. output_field

用來(lái)表示返回值的model field，一個(gè)可選的參數(shù)。

3.?**extra

關(guān)鍵字參數(shù)可以給聚合函數(shù)生成的SQL提供額外的信息。

4. Avg

class Avg(expression, output_field=FloatField(), **extra)[source]

返回給定表達(dá)式的平均值，它必須是數(shù)值，除非指定不同的output_field。

5. Count

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

返回與expression相關(guān)的對(duì)象的個(gè)數(shù)。

6. Max

class Max(expression, output_field=None, **extra)[source]

返回expression的最大值。

7. Min

class Min(expression, output_field=None, **extra)[source]

返回expression的最小值。

8. StdDev

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

返回expression的標(biāo)準(zhǔn)差。

.

9. Sum

class Sum(expression, output_field=None, **extra)[source]

計(jì)算expression的所有值的和。

10. Variance

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

返回expression的方差。