? Django对数据库的操作分用到三个类：Manager、QuerySet、Model。

Manager的主要功能定义表级方法（表级方法就是影响一条或多条记录的方法），我们可以以models.Manager为父类，定义自己的manager，增加表级方法；

QuerySet是Manager的方法返回的，是一个可遍历结构，包含一个或多个元素，每个元素都是一个Model 实例，它里面的方法也是表级方法。

Model是一条记录的类，它的功能很强大，里面包含外键实体等，它的方法都是记录级方法（都是实例方法，无类方法），不要在里面定义类方法，比如计算记录的总数，查看所有记录，这些应该放在自定义的manager类中。

Django给我们提供了增加表级方法的途径，那就是自定义manager类，而不是自定义QuerySet类，一般的我们没有自定义QuerySet类的必要；

1.QuerySet

1.1 简介

每个Model都有一个默认的manager类，名为objects，QuerySet有两种来源：通过manager的方法得到、通过QuerySet的方法得到。QuerySet的最初来源就是通过manager的方法。mananger的方法和QuerySet的方法大部分同名，同意思，如filter(),update()等，但也有些不同，如manager有create()、get_or_create()，而QuerySet有delete()等。一个QuerySet包含一个或多个model instance。QuerySet类似于Python中的list，list的一些方法QuerySet也有，比如切片，遍历。

>>> from gk_user.models import UserEx

>>> type(UserEx.objects)

<class ‘django.db.models.manager.Manager‘>

>>> a = UserEx.objects.all()

>>> type(a)

<class ‘django.db.models.query.QuerySet‘>

QuerySet是延迟获取的，只有当用到这个QuerySet时（有下面几种情况），才会求值，即查询数据库。另外，查询到的QuerySet又是缓存的，当再次使用同一个QuerySet时，并不会再查询数据库，而是直接从缓存获取（不过，有一些特殊情况）。一般而言，当对一个没有求值的QuerySet进行的运算返回的不是QuerySet、ValuesQuerySet、ValuesListQuerySet、Model实例时，一般的会立即查询数据库；反之，运算返回的是QuerySet、ValuesQuerySet、ValuesListQuerySet、Model实例时，一般不会查询数据库。下面介绍几种（并非全部）对QuerySet求值的场景。

class Blog(models.Model):

??? name = models.CharField(max_length=100)

??? tagline = models.TextField()

??

??? def __unicode__(self):

??????? return self.name

??

class Author(models.Model):

??? name = models.CharField(max_length=50)

??? email = models.EmailField()

??

??? def __unicode__(self):

??????? 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 __unicode__(self):

??????? return self.headline

我们以上面的models为例。

一 遍历

a = Entry.objects.all()

for e in a:

??? print (e.headline)

当遍历时，先从数据库执行查询select * from Entry得到a，然后再遍历a。

注意：这里只是查询Entry表，返回的a的每条记录只包含Entry表的字段值。不管Entry的model中是否有onetoone、onetomany、manytomany字段，都不会关联查询。这遵循的是数据库最少读写原则。

我们修改一下代码，如下，遍历一开始也是先执行查询得到a，但当执行print (e.blog.name)时，还需要再次查询数据库获取blog实体。

from django.db import connection

l = connection.queries? #l是一个列表，记录SQL语句

a = Entry.objects.all()

for e in a:

??? print (e.blog.name)

??? len(l)

遍历时，每次都要查询数据库，l长度每次增1，Django提供了方法可以在查询时返回关联表实体，如果是onetoone或onetomany，那用select_related，不过对于onetomany，只能在主表（定义onetomany关系的那个表）的manager中使用select_related方法，即通过select_related获取的关联对象是model instance，而不能是QuerySet，

如下，e.blog就是model instance。对于onetomany的反向和manytomany，要用prefetch_related，它返回的关联对象是QuerySet。

a = Entry.objects.select_related(‘blog‘)

for e in a:

??print (e.blog.name)

??len(l)

可以看到从开始到结束，l的长度只增加1。另外，通过查询connection.queries[-1]可以看到Sql语句用了join。

二切片

切片不会立即执行，除非显示指定了步长，如a= Entry.objects.all()[0:10:2]，步长为2。

?

三序列化，即Pickling

序列化QuerySet很少用

四repr()

和str()功能相似，将对象转为字符串，很少用。

五len()

计算QuerySet元素的数量，并不推荐使用len()，除非QuerySet是求过值的（即evaluated），否则，用QuerySet.count()获取元素数量，这个效率要高。

六?list()

将QuerySet转为list

七?bool()，判断是否为空

if Entry.objects.filter(headline="Test"):

?? ??print("There is at least one Entry with the headline Test")

?同样不建议这种方法判断是否为空，而应该使用QuerySet.exists()，查询效率高

??

?

八QuerySet的方法

数据库的常用操作就四种：增、删、改、查，QuerySet的方法涉及删、改、查。后面还会讲model对象的方法，model方法主要是增、删、改、还有调用model实例的字段。

(1) 删delete()

原型：delete()

返回：None

相当于delete-from-where, delete-from-join-where。先filter，然后对得到的QuerySet执行delete()方法就行了，它会同时删除关联它的那些记录，比如我删除记录表1中的A记录，表2中的B记录中有A的外键，那同时也会删除B记录，那ManyToMany关系呢？不清楚。实际中，delete用的很少，对于没有用的记录，一般是update为不可用。由于有些数据库，如Sqlite不支持delete与limit连用，所以在这些数据库对QuerySet的切片执行delete()会出错。如

>>> a = UserEx.objects.filter(is_active=False)

>>> b = a[:3]

>>> b.delete() #执行时会报错

解决：UserEx.objects.filter(pk__in=b).delete()?

in后面可以是一个QuerySet，见 https://docs.djangoproject.com/en/1.6/ref/models/querysets/#in

????

(2) 改 update()

批量修改，返回修改的记录数。不过update()中的键值对的键只能是主表中的字段，不能是关联表字段，如下

Entry.objects.update(blog__name=‘foo‘)? #这是错误的，无法修改关联表字段，只能修改Entry

#表中的字段

Entry.objects.filter(blog__name=‘foo‘).update(comments_on=False)? #正确，filter中的字段可以

#是关联表

最好的方法是先filter，查询出QuerySet，然后再执行QuerySet.update()。

由于有些数据库，不支持update与limit连用，所以在这些数据库对QuerySet的切片执行update()会出错。

(3)查询 filter(**kwargs)、exclude(**kwargs)、get(**kwargs)

相当于select-from-where，select-from-join-where，很多网站读数据库操作最多。可以看到，filter()的参数是变个数的键值对，而不会出现>,<,!=等符号，这些符号分别用__gt,__lt,~Q或exclude()，不过对于!=，建议使用Q查询，更不容易出错。可以使用双下划线对OneToOne、OneToMany、ManyToMany进行关联查询和反向关联查询，而且方法都是一样的，如：

>>> Entry.objects.filter(blog__name=‘Beatles Blog‘) #限定外键表的字段下面是反向连接，不过要

#注意，这里不是entry_set，entry_set是Blog instance的一个属性，代表某个Blog object

#的关联的所有entry，而QuerySet的方法中反向连接是直接用model的小写，不要把两者搞#混。It works backwards, too. To refer to a "reverse" relationship, just use the lowercase name of #the model.

>>> Blog.objects.filter(entry__headline__contains=‘Lennon‘)

>>> Blog.objects.filter(entry__authors__name=‘Lennon‘)?? #ManyToMany关系，反向连接

>>> myblog = Blog.objects.get(id=1)

>>> Entry.objects.filter(blog=myblog)? #正向连接。与下面一句等价，既可以用实体，也可以用

#实体的主键，其实即使用实体，也是只用实体的主键而已。这两种方式对OneToOne、

#OneToMany、ManyToMany的正向、反向连接都适用。

>>> Entry.objects.filter(blog=1)

>>> myentry = Entry.objects.get(id=1)

>>> Blog.objects.filter(entry=myentry) #ManyToMany反向连接。与下面一句等价

>>> Blog.objects.filter(entry=1)

OneToOne的关系也是这样关联查询，可以看到，Django对OneToOne、OneToMany、ManyToMany关联查询及其反向关联查询提供了相同的方式，真是牛逼啊。对于OneToOne、OneToMany的主表，也可以使用下面的方式

Entry.objects.filter(blog_id=1)，因为blog_id是数据库表Entry的一个字段， 这条语句与Entry.objects.filter(blog=1)生成的SQL是完全相同的，都是只在Entry表查询，没用join，django为我们封装了对数据库的操作，所以建议只用model中的字段，而blog_id不是model定义的字段，不建议用。

??

与filter类似的还有exclude(**kwargs)方法，这个方法是剔除，相当于select-from-where not，select-from-join-where not。可以使用双下划线对OneToOne、OneToMany、ManyToMany进行关联查询和反向关联查询，方法与filter()中的使用方法相同。

>>> Entry.objects.exclude(pub_date__gt=datetime.date(2005, 1, 3), headline=‘Hello‘)

转为SQL为

SELECT *

FROM Entry

WHERE NOT (pub_date > ‘2005-1-3‘ AND headline = ‘Hello‘)

??

(4)SQL其它关键字在django中的实现

在SQL中，很多关键词在删、改、查时都是可以用的，如order by、 like、in、join、union、and、or、not等等，我们以查询为例，说一下django如何映射SQL的这些关键字的（查、删、改中这些关键字的使用基本相同）。

No1 ?F类（无对应SQL关键字）

前面提到的filter/exclude中的查询参数值都是常量，如果我们想比较model的两个字段怎么办呢？Django也提供了方法，F类，F类实例化时，参数也可以用双下划线，也可以逻辑运算，如下

>>> from django.db.models import F

>>> Entry.objects.filter(n_comments__gt=F(‘n_pingbacks‘))

>>> from datetime import timedelta

>>> Entry.objects.filter(mod_date__gt=F(‘pub_date‘) + timedelta(days=3))

>>> Entry.objects.filter(authors__name=F(‘blog__name‘))

No2 ?Q类（对应and/or/not）

如果有or等逻辑关系呢，那就用Q类，filter中的条件可以是Q对象与非Q查询混和使用，但不建议这样做，因为混和查询时Q对象要放前面，这样就有难免忘记顺序而出错，所以最好如果使用Q对象，那就全部用Q对象。Q对象也很简单，就是把原来filter中的各个条件分别放在一个Q()即可，不过我们还可以使用或与非，分别对应符号为"|"和"&"和"~"，而且这些逻辑操作返回的还是一个Q对象，另外，逗号是各组条件的基本连接符，也是与的关系，其实可以用&代替（在python manage.py shell测试过，&代替逗号，执行的SQL是一样的），不过那样的话可读性会很差，这与我们直接写SQL时，各组条件and时用换行一样，逻辑清晰。

from django.db.models import Q

>>> Poll.objects.get( Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6)),

question__startswith=‘Who‘)?? #正确，但不要这样混用

>>> Poll.objects.get( Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6)),

Q(question__startswith=‘Who‘)) ?#推荐，全部是Q对象

>>> Poll.objects.get( (Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6)))&

Q(question__startswith=‘Who‘))? #与上面语句同意，&代替","，可读性差

Q类中时应该可以用F类，待测试。

??

No3 ?annotate（无对应SQL关键字）

函数原型annotate(*args,?**kwargs)

返回QuerySet

往每个QuerySet的model instance中加入一个或多个字段，字段值只能是聚合函数，因为使用annotate时，会用group by，所以只能用聚合函数。聚合函数可以像filter那样关联表，即在聚合函数中，Django对OneToOne、OneToMany、ManyToMany关联查询及其反向关联提供了相同的方式，见下面例子。

>>> from django.contrib.auth.models import User

>>> from django.db.models import Count

#计算每个学员的usertask数量，字段命名为ut_num，返回的QuerySet中的每个object都有

#这个字段在UserTask中定义User为外键，在Task中定义与User是ManyToMany，中间表为

#notification_task_users

>>> a = User.objects.filter(is_active=True, usertask__is_active=True). annotate(n=Count(‘usertask‘)) #一对多反向连接。User与UserTask是onetomany关联

>>> b = User.objects.filter(is_active=True, task__is_active=True).annotate(n=Count(‘task__name‘))? #多对多反向连接，User与Task是manytomany关联

>>> len(a)? #这里才会对a求值

>>> len(b)

a对应的SQL语句为(SQL中没有为表起别名,u、ut是我加的)：

select auth.user.*,Count(ut.id) as ut_num

from auth_user as u

left outer join ut on u.id = ut.user_id

where u.is_active=True and ut.is_active=True

group by u.*

??

b对应的SQL语句为(SQL中没有为表起别名,u、t、r是我加的)：

select u.*,Count(t.name) as n

from auth_user as u

left outer join notification.task_users as r on u.id=r.user_id

left outer join notification_task as t on r.task_id=t.id

where t.is_active=True and u.is_active=True

group by u.*

??

No4 ?order_by——对应order by

函数原型 order_by(**kwargs)

返回QuerySet

正向的反向关联表跟filter的方式一样。如果直接用字段名，那就是升序asc排列；如果字段名前加-，就是降序desc

??

No5 ?distinct——对应distinct

原型 distinct()

一般与values()、values_list()连用，这时它返回ValuesQuerySet、ValuesListQuerySet

这个类跟列表很相似，它的每个元素是一个字典。它没有参数（其实是有参数的，不过，参数只在PostgreSQL上起作用）。使用方法为

>>> a=Author.objects.values_list(name).distinct()

>>> b=Author.objects.values_list(name,email).distinct()

对应的SQL分别为

select distinct name

from Author

和

select distinct name,email

from Author

??

No6? values()和values_list()——对应‘select 某几个字段‘

函数原型values(*field), values_list(*field)

返回ValuesQuerySet, ValuesListQuerySet

Author.objects.filter(**kwargs)对应的SQL只返回主表（即Author表）的所有字段值，即使在查询时关联了其它表，关联表的字段也不会返回，只有当我们通过Author instance用关联表时，Django才会再次查询数据库获取值。当我们不用Author instance的方法，且只想返回几个字段时，就要用values()，它返回的是一个ValuesQuerySet对象，它类似于一个列表，不过，它的每个元素是字典。而values_list()跟values()相似，它返回的是一个ValuesListQuerySet，也类型于一个列表，不过它的元素不是字典，而是元组。一般的，当我们不需要model instance的方法且返回多个字段时，用values(*field)，而返回单个字段时用values_list(‘field‘,flat=True)，这里flat=True是要求每个元素不是元组，而是单个值，见下面例子。而且我们可以返回关联表的字段，用法跟filter中关联表的方式完全相同。

>>> a = User.objects.values(‘id‘,‘username‘,‘userex__account_name‘)

>>> type(a)

<class ‘django.db.models.query.ValuesQuerySet‘>

>>> a

[{‘id‘:0,‘username‘:u‘test0‘,‘ userex__account_name‘: u‘mlp-gikoo-test0@gk.cn‘},{‘id‘:1,‘username‘:u‘test1‘,

‘userex__account_name‘: u‘mlp-gikoo-test1@gk.cn‘},{‘id‘:2,‘username‘:u‘test2‘, ‘ userex__account_name‘: u‘mlp-gikoo-test2@gk.cn‘}]

>>> b= User.objects.values_list(‘username‘,flat=True)

>>> b

[u‘gikoo‘, u‘test1‘ ,u‘test2‘]

??

No7? select_related()——对应返回关联表字段，嵌套，这部分要比SQL语句强大

原型select_related(*filed)

返回QuerySet

它可以指定返回哪些关联表model instance，这里的field跟filter()中的键一样，可以用双下划线，但也有不同，You can refer to any ForeignKey or OneToOneField relation in the list of fields passed to select_related()，QuerySet中的元素中的OneToOne关联及外键对应的是都是关联表的一条记录，如my_entry=Entry.objects.get(id=1)，my_entry.blog就是关联表的一条记录的对象。select_related()不能用于OneToMany的反向连接，和ManyToMany，这些都是model的一条记录对应关联表中的多条记录。前面提到了对于a = Author.objects.filter(**kwargs)这类语句，对应的SQL只返回主表，即Author的所有字段，并不会返回关联表字段值，只有当我们使用关联表时才会再查数据库返回，但有些时候这样做并不好。看下面两段代码，这两段代码在1.1中提到过。在代码1中，在遍历a前，先执行a对应的SQL，拿到数据后，然后再遍历a，而遍历过程中，每次都还要查询数据库获取关联表。代码2中，当遍历开始前，先拿到Entry的QuerySet，并且也拿到这个QuerySet的每个object中的blog对象，这样遍历过程中，就不用再查询数据库了，这样就减少了数据库读次数。

代码1

a = Entry.objects.all()

for e in a:

??? print (e.blog.name)

??

代码2

a = Entry.objects.select_related(‘blog‘)

for e in a:

??????? print (e.blog.name)

No8??prefetch_related(*field) ——对应返回关联表字段，嵌套，这部分要比SQL语句强大

函数原型prefetch_related(*field)

返回的是QuerySet

可以用双下划线。前面提到select_related不能用于OneToMany的反向连接，及ManyToMany的情况，这部分由prefetch_related()来实现。其实，prefetch_related()也能做select_related()的事情，但由于策略不同，可能相比select_related()要低效一些，所以建议还是各管各擅长的。select_related是用select ……join来返回关联的表字段，而prefetch_related是用多条SQL语句的形式查询，一般，后一条语句用IN来调用上一句话返回的结果。

class Restaurant(models.Model):

??? pizzas = models.ManyToMany(Pizza, related_name=‘restaurants‘)

??? best_pizza = models.ForeignKey(Pizza, related_name=‘championed_by‘)

??

>>> Restaurant.objects.prefetch_related(‘pizzas__toppings‘)

>>> Restaurant.objects.select_related(‘best_pizza‘).prefetch_related(‘best_pizza__toppings‘)

先用select_related查到best_pizza对象，再用prefetch_related 从best_pizza查出toppings

至此，我们总结了查询数据库时，返回的数据形式，主要有三种：返回QuerySet，每个object只包含主表字段；返回QuerySet，每个object除了包含主表所有字段，还包含某些关联表的object，这种情况要用select_related()和prefetch_related()；返回ValuesQuerySet, ValuesListQuerySet，它们的每个元素包含若干主表和关联表的字段，不包含任何实体和关联实例，这种情况要用values()和values_list()。

??

No9? extra()——实现复杂的where子句

函数原型：extra(select=None, where=None, params=None, tables=None, order_by=None, select_params=None)

基本上，查询时用django提供的方法就够用了，不过有时where子句中包含复杂的逻辑，这种情况下django提供的方法可能不容易做到，还好，django有extra()， extra()中直接写一些SQL语句。不过，不同的数据库用的SQL有些差异，所以尽可能不要用extra()。需要时再看使用方法吧。

??

No10? aggregate(*args, **kwargs)——对应聚合函数

参数为聚合函数，最好用**kwargs的形式，每个参数起一个名字。如

>>> from django.db.models import Count

>>> q = Blog.objects.aggregate(Count(‘entry‘))? #这是用*args的形式，最好不要这样用

>>> q = Blog.objects.aggregate(number_of_entries=Count(‘entry‘))? #这是用**kwargs的形式

{‘number_of_entries‘: 16}

??

No11? exists()、count()、len()

如果只是想知道一个QuerySet是否为空，而不想获取QuerySet中的每个元素，那就用exists()，它要比len()、count()、和直接进行if判断效率高。如果只想知道一个QuerySet有多大，而不想获取QuerySet中的每个元素，那就用count()；如果已经从数据库获取到了QuerySet，那就用len()

??

No12 ?contains/startswith/endswith——对应like

字段名加双下划线，除了它，还有icontains，即Case-insensitive contains，这个是大小写不敏感的

No13? in——对应in

字段名加双下划线

No14? gt/gte/lt/lte——对应于>,>=,<,<=

字段名加双下划线

No15? range——对应于between and

字段名加双下划线，range后面值是列表

No16? isnull——对应于is null

Entry.objects.filter(pub_date__isnull=True)对应的SQL为SELECT ... WHERE pub_date IS NULL;

No17? QuerySet切片——对应于limit

??? QuerySet的索引只能是非负整数，不支持负整数，所以QuerySet[-1]错误

a=Entry.objects.all()[5:10]

b=len(a)? #执行Entry.objects.all()[5:8]，对于不同的数据库，SQL语句不同，Sqlite 的SQL语句为select?*?from?tablename?limit?3 offset 5; MySQL的SQL语句为select?*?from?tablename?limit?3,5