本文 model 设置如下：
from django.db import models
class Blog(models.Model):
name = models.CharField(max_length=100)
tagline = models.TextField()
def __str__(self): # __unicode__ on Python 2
return self.name
class Author(models.Model):
name = models.CharField(max_length=50)
email = models.EmailField()
def __str__(self): # __unicode__ on Python 2
return self.name
class Entry(models.Model):
blog = models.ForeignKey(Blog)
headline = models.CharField(max_length=255)
body_text = models.TextField()
pub_date = models.DateField()
mod_date = models.DateField()
authors = models.ManyToManyField(Author)
n_comments = models.IntegerField()
n_pingbacks = models.IntegerField()
rating = models.IntegerField()
def __str__(self): # __unicode__ on Python 2
return self.headline
查询集的方法
filter()
返回一个新的 QuerySet，返回与查询条件匹配的对象。exclude()
返回一个新的 QuerySet，返回查询条件不匹配的对象。annotate()
（待补充）
查询集排序
默认情况下，QuerySet 根据模型 Meta 类的 ordering 选项排序。要使用特定的排序方法时可以用 order_by()：
# 按 pub_date 降序排列
Entry.objects.filter(pub_date__year=2005).order_by('-pub_date')
# 按 pub_date 降序排列，再按 headline 升序排列
Entry.objects.filter(pub_date__year=2005).order_by('-pub_date', 'headline')
若要随机排序，请使用 " ? "：
Entry.objects.order_by('?')
注：order_by('?') 查询可能耗费资源且很慢。
涉及外键的排序
若要按照另外一个模型中（即：外键或其他对应关系）的字段排序，可以在字段的名称后面跟上两个下划线（__），再跟上新模型中的字段的名称，例如：
# 按照所属的博客的名称排序
Entry.objects.order_by('blog__name')
如果单纯用另一个模型的小写名来排序，相当于是按照该模型的主键来排序：
# 这两种写法等价
Entry.objects.order_by('blog')
Entry.objects.order_by('blog__id')
反向排序
使用 reverse() 方法可以使一个排好序的查询集反向排序
e = Entry.objects.order_by('blog_id')
# 反向排序
e.reverse()
distinct
（待补充）
values
返回一个ValuesQuerySet —— QuerySet 的一个子类，对它进行迭代操作时返回字典。
e = Entry.objects.order_by('blog')
v = e.values()
>>> type(v)
# 对它进行迭代操作时将返回一个字典
>>> type(v[0])
values() 接收可选的位置参数 *fields，指定输出哪些字段：
>>> e.values('id', 'headline')
如果 values() 的参数是一个ForeignKey，默认的 values() 调用返回的字典将会是一个叫做 母表的 id ：
>>> Entry.objects.values('blog')
# 返回的是母表的 id
# 这种写法与上面的等价
>>> Entry.objects.values('blog_id')
values_list
与 values() 类似，只是在迭代时返回的是元组而不是字典：
>>> e = Entry.objects.values_list('id', 'headline')
>>> type(e)
# 返回一个元组
>>> type(e[0])
当 flat 参数为True 时，它表示返回的结果为单个值而不是元组：
>>> e = Entry.objects.values_list('id', flat=True).order_by('id')
>>> e[0]
1
>>> type(e[0])
注意：如果有多个字段，传递 flat 将发生错误。
如果你不传递任何值给 values_list()，它将返回模型中的所有字段。
dates
dates(field, kind, order='ASC')
返回 DateQuerySet - QuerySet，其计算结果为 datetime.date 对象。
field 应为模型的 DateField 的名称。 kind 应为 "year"、"month" 或 "day"。
- "year" 表示精确到年
- “month” 表示精确到月
- “day” 表示精确到日
order（默认为“ASC”）应为'ASC'或'DESC'。
注：asc 是升序排列，desc 是降序排列。
例子：
# 返回值精确到年，因为所有 entry 的 pub_date 都是 2017年，所以只有一个返回值
>>> Entry.objects.dates('pub_date', 'year')
# 返回值精确到月
>>> Entry.objects.dates('pub_date', 'month')
# 精确到日，默认为升序
>>> Entry.objects.dates('pub_date', 'day')
# 精确到日，降序排列
>>> Entry.objects.dates('pub_date', 'day', order='DESC')
# 查询某篇博文的 pub_date
>>> e = Entry.objects.filter(headline='George 教你弹吉他')
>>> e.dates('pub_date', 'day')
datetimes
（待补充）
None
调用 none() 将创建一个从不返回任何对象的查询集，并且在访问结果时不会执行任何查询。
qs.none() 查询集是 EmptyQuerySet 的一个实例。
>>> Entry.objects.none()
[]
>>> from django.db.models.query import EmptyQuerySet
>>> isinstance(Entry.objects.none(), EmptyQuerySet)
True
all()
返回全部
select_related
返回一个QuerySet。当使用 select_related 去查询带外键关系的对象时，它会预加载相关的数据表，以后再查询外键关系时就不用再去请求数据库。
下面的例子解释了普通查询和 select_related() 查询的区别：
- 普通查询：
# 请求数据库
e = Entry.objects.get(id=5)
# 再次请求数据库
b = e.blog
- select_related 查询：
# 请求数据库
e = Entry.objects.select_related('blog').get(id=5)
# 无需再请求数据库，因为相关数据已经预加载
b = e.blog
假如有“外键链”，如下所示：
from django.db import models
class City(models.Model):
# ...
pass
class Person(models.Model):
# ...
hometown = models.ForeignKey(City)
class Book(models.Model):
# ...
author = models.ForeignKey(Person)
可以这样调用将缓存关联的 Person 和关联的 City：
b = Book.objects.select_related('author__hometown').get(id=4)
p = b.author
c = p.hometown
prefetch_related
（待补充）
参考：http://blog.jobbole.com/74881/
extra
（待补充）
不会返回 QuerySets 的方法
get(**kwargs)
create(**kwargs)
get_or_create(defaults=None, **kwargs)
update_or_create(defaults=None, **kwargs)
bulk_create(objs, batch_size=None)
bulk_create 方法是用一个列表来批量插入数据：
Entry.objects.bulk_create([
Entry(headline="Django 1.0 Released"),
Entry(headline="Django 1.1 Announced"),
Entry(headline="Breaking: Django is awesome"
)])
count()
in_bulk(id_list)
获取主键值的列表，并返回一个字典：
# 如果不填参数将获取全部
>>> Entry.objects.in_bulk()
{
3: ,
4: ,
5:
}
>>> Entry.objects.in_bulk([3])
{3: }
>>> Entry.objects.in_bulk([3,4])
{
3: ,
4:
}
- iterator()
iterator() 方法可以把一个查询集变成一个迭代器：
a = Entry.objects.all()
a = a.iterator()
# 生成一个迭代器
>>> type(a)
generator
- latest(field_name=None)
按日期返回表中的最的新对象：
# 返回 pub_date 最新的对象
>>> Entry.objects.latest('pub_date')
- earliest(field_name=None)
按日期返回表中的最早的对象：
>>> Entry.objects.earliest('pub_date')
- first()
返回结果集的第一个对象, 当没有找到时返回None。
例：
>>> Entry.objects.first()
- last()
类似 first()，只是返回的是查询集中最后一个对象。
- aggregate(*args, **kwargs)
（聚合查询，待补充）
- exists()
判断某 QuerySet 是否存在某个对象，返回 True 或 False。这是一个高效的查询方法，特别是 QuerySet 比较大的时候。
>>> entry = Entry.objects.get(pk=3)
>>> all_entry = Entry.objects.all()
>>> all_entry.filter(pk=entry.pk).exists()
True
>>> some_entry = Entry.objects.filter(pk=4)
>>> some_entry.filter(pk=entry.pk).exists()
False
它将比下面的方法快很多：
if entry in some_queryset:
……
若要判断一个 QuerySet 是否包含任何元素，
if some_queryset.exists():
会快于
if some_queryset:
- update(**kwargs)
更新指定字段，例子：
e = Entry.objects.filter(pk=4)
e.update(rating=1)
# 也可以批量修改查询集里面的全部字段
e = Entry.objects.all()
e.update(rating=1)
- delete()
删除指定字段，例子：
# 删除指定博客的全部博文
b = Blog.objects.get(pk=1)
Entry.objects.filter(blog=b).delete()
# 删除全部博空
blogs = Blog.objects.all()
blogs.delete(
- as_manager
（待补充）