5.2 数据查询
要从数据库检索数据，首先要获取一个*查询集***(QuerySet)，查询集表示从数据库获取的对象集合，它可以有零个，一个或多个过滤器。返回查询集的方法，称为过滤器，过滤器根据给定的参数缩小查询结果范围，相当于sql语句中where或limit。
- 在管理器上调用过滤器方法会返回查询集
- 查询集经过过滤器筛选后返回新的查询集，因此可以写成链式过滤
- 惰性执行：创建查询集不会带来任何数据库的访问，直到调用数据时，才会访问数据库
- 以下对查询集求值：迭代、切片、序列化、与if合用、repr()/print()/len()/list()/bool()
| 管理器的方法 | 返回类型 | 说明 |
|---|---|---|
| 模型类.objects.all() | QuerySet | 返回表中所有数据 |
| 模型类.objects.filter() | QuerySet | 返回符合条件的数据 |
| 模型类.objects.exclude() | QuerySet | 返回不符合条件的数据 |
| 模型类.objects.order_by() | QuerySet | 对查询结果集进行排序 |
| 模型类.objects.values() | QuerySet | 返回一个列表 每个元素为一个字典 |
| 模型类.objects.reverse() | QuerySet | 对排序的结果反转 |
| 模型类.objects.get() | 模型对象 | 返回一个满足条件的对象； 如果没有找到符合条件的对象，会引发模型类.DoesNotExist异常; 如果找到多个，会引发模型类.MultiObjectsReturned 异常 |
| 模型类.objects.count() | int | 返回查询集中对象的数目 |
| 模型类.objects.first() | 模型对象 | 返回第一条数据 |
| 模型类.objects.last() | 模型对象 | 返回最后一条数据 |
| 模型类.objects.exists() | bool | 判断查询的数据是否存在 |
5.2.1 返回查询集
-
all()
# 获取所有数据，对应SQL：select * from User User.objects.all() -
filter(**kwargs) 返回QuerySet包含与给定查找参数匹配的新查询集。
#等价sql：select * from User User.objects.filter() #等价sql：select * from User where uname = 'admin' User.objects.filter(uname='admin') #等级sql：select * from User where uid > 1 and type = 2 User.objects.filter(uid__gt=1,type=2) #链式调用，等价于User.objects.filter(uid__gt=1,type=2) User.objects.filter(uid__gt=1).filter(type=2) -
exclude(**kwargs)
# 不匹配，对应SQL：select * from User where name != 'admin' User.objects.exclude(name='admin') -
order_by(*fields)
- 参数是字段名，可以有多个字段名，默认是升序。
- 如果要按某个字段降序，在字段名前加’-’： "-uid"表示按uid降序排列
#按uid升序排列 等价于 order by uid
User.objects().order_by('uid')
#按uid降序排列 等价于 order by uid desc
User.objects.order_by('-uid')
#多列排序 等价于 order by password,uid desc
User.objects.order_by('password','-uid')
-
values()
#返回所有字段 User.objects.values() #返回数据： [{'uid': 2, 'uname': '小甜甜', 'password': '59f2443a4317918ce29ad28a14e1bdb7'type': '普通用户', 'regtime': None, 'ip': None, 'allowed': '允许登录', 'email': None, None},...] #返回指定字段 User.objects.values('uname','password') [{'uname': '小甜甜', 'password': '59f2443a4317918ce29ad28a14e1bdb7'},...] -
reverse()
User.objects.order_by('id').reverse() 降序 User.objects.order_by('-id').reverse() 升序 -
distinct() 去重
User.objects.values('password').distinct()
5.2.2 返回单个值
下面这些方法后面不能再跟其他过滤方法，因为他们不返回查询集
-
get() 只匹配一条数据
u = User.objects.get(pk=1) #正常 u = User.objects.get(uid__gt=20) #MultipleObjectsReturned 匹配到了多条数据 u = User.objects.get(uid__lt=-1) #DoesNotExist 匹配失败 -
first()和last()
User.objects.all().first() #返回结果集中第一条数据 User.objects.all().last() #返回结果集中最后一条数据 -
count()
- 返回结果集记录数目，等价于select count(*)
- 不会返回整个结果集，相比len方法更有效
User.objects.count() -
exists()
-
判断查询集中是否有记录，有返回True，否则返回False
User.objects.filter(uid=3).exists()
-
5.2.3查询集限制
查询集类似列表，可以使用下标进行限制，类似sql语句中的limit子句。但索引不能是负数
- 索引
- 切片
User.objects.all()[0] #等同于：limit 0,1
User.objects.all()[2] #等同于：limit 2,1
User.objects.all()[0:2] #等同于limit 2
User.objects.all()[:2] #等同于limit 2
User.objects.all()[::2]