作者:python技术人
博客:https://www.cnblogs.com/lpdeboke/

class UserModel(models.Model):
    u_name = models.CharField(max_length=16, unique=True)
    u_password = models.CharField(max_length=256)
    u_email = models.CharField(max_length=128, unique=True)
    u_icon = models.ImageField(upload_to="icons")  #用户头像
    is_delete = models.BooleanField(default=False)  #是否逻辑删除
    is_active = models.BooleanField(default=False)  #是否激活
 

返回新QuerySets的API

方法名	                解释
all()	            获取所有的对象
filter()	        过滤查询对象。
exclude()	        排除满足条件的对象
annotate()	        使用聚合函数
order_by()	        对查询集进行排序
reverse()	        反向排序
distinct()	        对查询集去重
values()	        返回包含对象具体值的字典的QuerySet
values_list()	    与values()类似,只是返回的是元组而不是字典。
dates()	            根据日期获取查询集
datetimes()	        根据时间获取查询集
none()	            创建空的查询集
union()	            并集
intersection()	    交集
difference()	    差集
select_related()	附带查询关联对象
prefetch_related()	预先查询
extra()	            附加SQL查询
defer()	            不加载指定字段
only()	            只加载指定的字段
using()	            选择数据库
select_for_update()	锁住选择的对象,直到事务结束。
raw()	            接收一个原始的SQL查询

重点关注以下几个

1.fliter():

filter(**kwargs)
 
返回满足查询参数的对象集合。
 
查找的参数(**kwargs)应该满足下文字段查找中的格式。多个参数之间是和AND的关系。
 
UserModel.objects.filter(u_age=10)#查询满足年龄等于10岁的所有用户对象

1.1大于、大于等于:
__gt  大于>        
__gte  大于等于>=
 
UserModel.objects.filter(age__gt=10)    // 查询年龄大于10岁的用户
UserModel.objects.filter(age__gte=10)  // 查询年龄大于等于10岁的用户
 
1.2小于、小于等于:
__lt  小于<
__lte 小于等于<=
 
UserModel.objects.filter(age__lt=10)     // 查询年龄小于10岁的用户
UserModel.objects.filter(age__lte=10)   // 查询年龄小于等于10岁的用户
1.3 like:
__exact        精确等于       like 'aaa'
__iexact       精确等于       忽略大小写 ilike 'aaa'
__contains     包含           like '%aaa%'
__icontains    包含,忽略大小写 ilike '%aaa%',但是对于sqlite来说,contains的作用效果等同于icontains。

1.4 in:

__in
 
查询年龄在某一范围的用户
UserModel.objects.filter(age__in=[10, 20, 30])

1.5 is null / is not null:

__isnull  判空
 
UserModel.objects.filter(name__isnull=True)    // 查询用户名为空的用户
UserModel.objects.filter(name__isnull=False)  // 查询用户名不为空的用户

1.6 不等于/不包含于:


UserModel.objects.filter().excute(age=10)    // 查询年龄不为10的用户
UserModel.objects.filter().excute(age__in=[10, 20])  // 查询年龄不在 [10, 20] 的用户

1.7 其他常用模糊查询:
__startswith 以…开头
__istartswith 以…开头 忽略大小写
__endswith 以…结尾
__iendswith 以…结尾,忽略大小写
__range 在…范围内
__year 日期字段的年份
__month 日期字段的月份
__day 日期字段的日

1.8 多表连接查询:

class A(models.Model):
    name = models.CharField(u'名称')
 class B(models.Model):
    aa = models.ForeignKey(A)
 
B.objects.filter(aa__name__contains='searchtitle')#查询B表中外键aa所对应的表中字段name包含searchtitle的B表对象。

2.exclude():

exclude(**kwargs)
 
返回一个新的QuerySet,它包含不满足给定的查找参数的对象
 
UserModel.objects.exclude(age__gt=20, name='lin')#排除所有年龄大于20岁且名字为“lin”的用户集

3.annotate():

annotate(args, *kwargs)
 
使用提供的聚合表达式查询对象。
 
表达式可以是简单的值、对模型(或任何关联模型)上的字段的引用或者聚合表达式(平均值、总和等)。
 
annotate()的每个参数都是一个annotation,它将添加到返回的QuerySet每个对象中。
 
关键字参数指定的Annotation将使用关键字作为Annotation 的别名。 匿名参数的别名将基于聚合函数的名称和模型的字段生成。 只有引用单个字段的聚合表达式才可以使用匿名参数。 其它所有形式都必须用关键字参数。
 
例如,如果正在操作一个UserModel列表,你可能想知道每个UserModel有多少u_name:
#用django shell来调试
>>> from django.db.models import Count
>>> q = UserModel.objects.annotate(Count('u_name'))
# The name of the first UserModel
>>> q[0].u_name
'leon'
# The number of q[0].u_name on the first UserModel
>>> q[0].u_icon
3

4.order_by():


order_by(*fields)
 
默认情况下,根据模型的Meta类中的ordering属性对QuerySet中的对象进行排序
UserModel.objects.filter(is_delete=False).order_by('-u_age', 'is_active')
上面的结果将按照age降序排序,然后再按照name升序排序。"-age"前面的负号表示降序顺序。 升序是默认的。 要随机排序,使用"?",如下所示:
UserModel.objects.order_by('?')

5. reverse():

reverse()
 
反向排序QuerySet中返回的元素。 第二次调用reverse()将恢复到原有的排序。
 
如要获取QuerySet中最后五个元素,可以这样做:
 
my_queryset.reverse()[:5]
 
这与Python直接使用负索引有点不一样。 Django不支持负索引

6.distinct():


distinct(*fields)
 
去除查询结果中重复的行。
 
默认情况下,QuerySet不会去除重复的行。当查询跨越多张表的数据时,QuerySet可能得到重复的结果,这时候可以使用distinct()进行去重。

7. values():


values(fields, *expressions)
 
返回一个包含数据的字典的queryset,而不是模型实例。
 
每个字典表示一个对象,键对应于模型对象的属性名称。如:
 
# 列表中包含的是User对象
>>> UserModel.objects.filter(u_name__startswith='leon')
<QuerySet [<UserModel: UserModel object>]>

 
# 列表中包含的是数据字典
>>> UserModel.objects.filter(u_name__startswith='lipeng').values()
<QuerySet [{'u_password': '34', 'is_delete': True, 'u_icon': '23', 'u_email': '1rtewe@123.com', 'is_active': 2, 'id': 2, 'u_name': 'lipeng'}]>
 
另外该方法接收可选的位置参数*fields,它指定values()应该限制哪些字段。如果指定字段,每个字典将只包含指定的字段的键/值。如果没有指定字段,每个字典将包含数据库表中所有字段的键和值。如下:
>>> UserModel.objects.filter(u_name__startswith='leon').values()
<QuerySet [{'u_password': '123456', 'is_delete': True, 'u_icon': '3', 'u_email': '123@123.com', 'is_active': 2, 'id': 1, 'u_name': 'leon'}]>
 
UserModel.objects.values('id', 'u_name')
<QuerySet [{'id': 3, 'u_name': 'amy'}, {'id': 1, 'u_name': 'leon'}, {'id': 4, 'u_name': 'lind'}, {'id': 2, 'u_name': 'lipeng'}]>

8.values_list():


values_list(*fields, flat=False)
 
与values()类似,只是在迭代时返回的是元组而不是字典。每个元组包含传递给values_list()调用的相应字段或表达式的值,因此第一个项目是第一个字段等。 像这样:
>>> UserModel.objects.values_list('id', 'u_name')
<QuerySet [(3, 'amy'), (1, 'leon'), (4, 'lind'), (2, 'lipeng')]>

引自:https://blog.csdn.net/qq_34493908/article/details/81352784