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]