Django为我们提供了一套与数据库交互的机制，让我们能够更便捷的对数据库进行增删改查。Django 对数据库的操作依赖于它的 ORM 系统，Django ORM 主要包括Manager、QuerySet、Model三个模块，下面将对QuerySet进行概述总结，方便在需要使用时然而又刚好忘记了的时候能够有地可查。

QuerySet

QuerySet 从名字就很好理解，表示对数据库进行查询的结果的集合。QuerySet是可迭代的，其包含一个或多个model instances，并且可构造、过滤、切片、遍历等。

一、特性

1）延迟加载，符合筛选条件的对象被用到时才进行数据库查询；
        2）缓存机制，查询数据库后的数据将缓存到内存中，当再次使用时不会再进行数据库查询，可使用all（）方法对有修改的查询集进行更新
        3）可下标遍历及切片，下标无负数，注意与python切片的区别；
        4）对未进行求值的QuerySet进行运算，可能的返回值：QuerySet 、ValueQuerySet、ValueListQuerySet、Model，此时不进行数据库查询，反之。
        5）通过当前表查询获取关联表记录时需使用select_related()或prefech_related()函数，下面有详细解释；
        6）返回值为QuerySet的方法可叠加使用。

二、QuerySet操作

1）对查询集加步长（step）切片；

Blog.objects.all()[0:20:2]    # 步长为2

2）序列化（Pickling）；
3）对查询集进行遍历；

blog = Blog.objects.all()
for temple in blog:print(temple.headline)

4)repr()，将对象转化为字符串，同python str()函数
        5）len(), 求QuerySet元素的数量，推荐使用QuerySet.conunt();
        6）list(), 将QuerySet转为list；
        7）bool(), 判断查询集是否为空，推荐使用QuerySet.exists();
注：在QuerySet没有缓存的情况下，以上操作会导致数据库查询。

三、QuerySet 的方法

QuerySet 除提供了基础的增、删、改、查方法外，还对应SQL的关键字参数提供了一系列方法，简化了我们对数据库进行的复杂操作。
1）create() 返回当前保存的model 实例；★

Blog.objects.create(author=‘小米’, title='QuerySet详解')

2）delete() 返回None ★

Blog.objects.filter(author=‘小米’).delete()

注：需注意数据库的特性，Sqlite 不支持delete()与limit连用，对QuerySet的切片执行delete()会报错
3）update() 返回被修改的记录数 ★

Blog.objects.filter(author=‘小米’).update(title='QuerySet速查手册')

注：只可对当前表中的字段进行修改，不能修改关联表的字段值。修改关联表字段值方法：先查询得到需修改的关联表的记录，再使用update()进行修改。
4)get() 返回model 实例 ★

Blog.objects.get(id=1)

注：使用该方法时需注意返回值为model 实例，不再具有QuerySet的属性及方法。若无匹配实例，将抛出DoesNotExist异常。
5）filter() 返回QuerySet，使用查询条件对查询结果进行过滤

Blog.objects.filter(id__gt=1)

6) exclude() 返回QuerySet，对查询集过滤掉满足条件的实例。

Blog.objects.exclude(id__lte=10)

7) aggregate() 返回一个值 ★，对应聚合函数，不会使用group_by进行分组

Blog.objects.aggregate(number_of_blog=Count('title'))

8) annotate() 返回QuerySet，往每个查询集的model instances中添加一个或多个字段。执行时使用group_by进行分组后使用聚合函数返回添加值。

Blog.objects.annotate(number_of_author_blog=Count('author'))

注：

只能使用聚合函数；
执行时将使用group_by;
对正反向关联查询提供相同方法；
是aggregate()与group_by的结合

9) order_by() 返回QuerySet，对查询集进行排序
升序：

Blog.objects.filter(author=‘小米’).order_by('create_datetime')

降序：

Blog.objects.filter(author=‘小米’).order_by('-create_datetime')

10) distinct() 对元素进行去重，常与values() 及 values_list() 连用，返回与连用函数相同类型的结果集
values(*fields) 返回 列表字典类型的 ValuesQuerySet结果，格式：[{‘field_1’: value_1}, {‘field_2’: value_2},]

Blog.objects.filter(author=‘小米’).values('id','title', 'create_datetime')
# 结果
[{'id': 5}, {'title': 'QuerySet速查手册'，‘create_datetime’: 2019-05-08},]

values_list(*fields) 返回 列表元组 类型的ValuesListQuerySet结果，格式：[(field_1_value, field_2_value, field_3_value)]

Blog.objects.filter(author=‘小米’).values_list('id','title', 'create_datetime')
# 结果
[(3,  'QuerySet详解', 2019-05-08),(4,  'QuerySet速查手册', 2019-05-08)]

注当只指定一个字段时，可使用flat=True参数，使返回结果为一个列表

Blog.objects.filter(author=‘小米’).values_list('title')
# 结果
['QuerySet详解', 'QuerySet速查手册', ]

11) select_related() 返回QuerySet，在进行数据查询时不会返回关联表字段信息，在真正使用到时才去查询数据库，这样会频繁访问数据库，增加服务器压力，此时要获取关联表字段就需要使用该方法指定需要获取的关联表的记录，传入当前表的外键字段名作为参数。因此该方法只适用于一对一关系和一对多关系的正向查询，查询到的关联表记录为单条数据。数据库级使用join实现。

Blog.objects.select_related().filter(author=‘小米’)

12) prefetch_related() 返回QuerySet，与select_related()类似，但该方法适用于一对多关系的反向查询及多对多查询，查询到的关联表记录为多条数据。数据库级使用多条SQL语句联合查询，多用IN关键词进行联合。
13)extra() 返回QuerySet，用于写原生SQL语句，实现复杂的where子句，很少用。
函数原型：extra(select=None, where=None, params=None, tables=None, order_by=None, select_params=None)
14) get_or_create(defaults=None, **kwargs) 返回当前实例和一个bool值（objects, bool），获取或新增记录。根据所给条件查询对象，若存在则返回读取到的实例和False，若不存在则返回新创建的实例和True。★

object， bool = Blog.objects.get_or_create(author=‘小米’, title='QuerySet详解', defaults={'create_datetime': date(2019,5,9)})

注:

在创建实例时，从非 defaults 关键字参数中去除双下划线参数；
在创建实例时，defaults参数中定义的字段值具有更高优先级，即关键字参数及defaults参数中都有某字段值时，以defaults参数中的值为准；
.在视图中使用该方法时需格外慎重，该方法在GET中使用时，不会对数据产生任何作用；在POST中使用时，可能对数据产生不可预知影响。

15）update_or_create(defaults=None, **kwargs) 返回当前实例和一个bool值（objects，bool），更新或新增记录。根据所给条件修改对象，若存在则返回修改实例和False，若不存在则返回新创建的实例和True。其他同get_or_create().★
16）bulk_create(object, batch_size=None) 批量创建, 传入的objects参数可以是一个list的object列表。★

Blog.objects.bulk_create([Blog(author=‘小米’, title='QuerySet详解', create_datetime=date(2019,5,9)),Blog(author=‘小咪’, title='QuerySet详解', create_datetime=date(2019,5,9)),Blog(author=‘小洣’, title='QuerySet详解', create_datetime=date(2019,5,9)),
])

17) first() 返回当前查询集的第一个实例对象★

Blog.objects.filter(author=‘小米’).first()

18) last() 返回当前查询集的最后一个实例对象★

Blog.objects.filter(author=‘小米’).last()

19) in_bulk(id_list) 传入主键值列表，返回一个字典，该字典的key值为主键值，value值为该主键的对象

Blog.objects.in_bulk([1,2,3])
# 结果
{1：<Blog:'QuerySet详解'>, 2:<Blog:'QuerySet速查手册'>, 3:<Blog:'QuerySet'>}

20) iterator() 用于查询集进行迭代，减少缓存。QuerySet具有缓存机制，查询的数据集过大时会对内存造成较大压力，而使用迭代器读取对象时，只有用到该对象时才实例化，即才从数据库进行查询，且用完后即释放内存空间。但这样又会频繁访问数据库，因此在优化性能时需要权衡。
21) latest(field_name=None) 根据传入的字段获取数据表中最新的对象，无匹配对象时会抛出DoesNotExist()异常。
22) earliest(field_name=None) 同上。

注：带★的不返回QuerySet

四、条件运算符

Q类：用于多个条件的逻辑值运算，and、or、not
        F类：获取当前model中的字段用于条件运算
        __gt：大于
         __gte：大于等于
         __lt：小于
         __lte：小于等于

五、聚合函数

Count()：返回被关联model的数量
        Avg()：返回所给字段的平均值
        distinct()：返回不重复的实例数量
        Max()：返回查询集中所给字段的最大值
        Mix()：返回查询集中所给字段的最小值
        Sum()：返回查询集中所给字段的和

如有不对的地方，请不吝赐教，十分感谢！
本篇博文主要参考以下两篇博客，感谢作者的辛勤付出，更详细的讲解可参考他们的文章。
参考博文：
https://www.cnblogs.com/JetpropelledSnake/p/9276763.html
https://blog.csdn.net/aaronthon/article/details/81714506

☆★☆★★★☆☆☆ 鹿子

Django QuerySet速查手册相关推荐

[WebDev]Web 开发与设计师速查手册大全
Cheat Sheet 一词在中文中并没有很贴切的对译,大概是考试作弊条一类的东西,这要求 Cheat Sheet 必须短小精悍又覆盖广泛,作为 Web 开发与设计师,免不了在工作时查询大量资料,某个 ...
最全pandas函数用法速查手册（高清版）
Pandas 是 Python 的核心数据分析支持库,拥有快速.灵活.明确的数据结构,旨在简单.直观.快速地处理关系型.标记型数据,是一款强大.灵活的开源数据分析工具. 但是pandas的知识点很多, ...
Excel公式与函数案例速查手册/电脑技巧从入门到精通丛书
出版社: 机械工业出版社; 第1版 (2013年12月1日) 丛书名: 电脑技巧从入门到精通丛书平装: 770页语种: 简体中文开本: 32 条形码: 9787111448761 商品尺寸: 1 ...
【收藏】Linux系统常用命令速查手册（附赠PDF档）
给大家收集整理了日常常用的Linux系统命令,仅供大家参考. 大家如果觉得文章看起来不太方便,获取<Linux系统常用命令速查手册>.PDF版. 联系小姐姐,备注"liunx命令 ...
【收藏】Linux系统常用命令速查手册（附PDF下载链接）
给大家收集整理了日常常用的Linux系统命令,仅供大家参考. 大家如果觉得文章看起来不太方便,可以在+qq. 2 3 5 53 3 1 0 4 6 备注"liunx命令",即可获取 ...
135 页的《机器学习速查手册》，公式、图表都有，附下载！
机器学习中的数学原理和公式推导还是非常重要的,但知识点较为繁杂,且不易整理!今天推荐一份开源的<机器学习速查手册>,并且制作成了电子版 PDF,方便大家查阅~ 这份手册最大的特点就是包含许 ...
pandas速查手册(中文版)
本文翻译自文章:Pandas Cheat Sheet - Python for Data Science 对于数据科学家,无论是数据分析还是数据挖掘来说,Pandas是一个非常重要的Python包.它 ...
给运维工程师的Cheatsheets！《Shell脚本速查手册》免费下！
简介:Shell 作为 Linux 中的第一语言,几乎每一个使用 Linux 的人都用到或用过 Shell,但绝大多数人都并不能掌握 Shell 编程的基本能力和技巧. 2021 年,阿里云开发者学堂 ...
HTML5 标签、事件句柄属性以及浏览器兼容情况速查手册
随着主流浏览器对 HTML5 的不断支持和完善,越来越多的开发者开始使用 HTML5 来开发各种功能强大的 Web 应用程序,HTML5 正引领互联网新革命.为了方便大家更好的学习 HTML5,今天这 ...

Django QuerySet速查手册