您的位置：首页 > 产品设计 > UI/UE

Django2.0-db(9)-QuerySet的API

2018-11-10 17:32 337 查看

QuerySet API

模型.objects

这个对象是

django.db.models.manager.Manager

的对象，该类是空壳类。上面所有的方法都是从

QuerySet

这个类上面拷贝过来的。

以下是会返回新的

QuerySet

对象的方法。

```
filter()
```
：将满足条件的数据提取出来，返回一个新的
```
QuerySet
```
。具体的
```
filter
```
可以提供什么条件查询。请见查询操作章节。
```
exclude()
```
：排除满足条件的数据，返回一个新的
```
QuerySet
```
。示例代码如下：
```
Article.objects.exclude(title__contains='hello')
```
以上代码的意思是提取那些标题不包含
```
hello
```
的图书。
```
annotate()
```
：给
```
QuerySet
```
中的每个对象都添加一个使用查询表达式（聚合函数、F表达式、Q表达式、Func表达式等）的新字段。示例代码如下：
```
articles = Article.objects.annotate(author_name=F("author__name"))
```
以上代码将在每个对象中都添加一个
```
author__name
```
的字段，用来显示这个文章的作者的年龄。

order_by()

：指定将查询的结果根据某个字段进行排序。如果要倒叙排序，那么可以在这个字段的前面加一个负号。示例代码如下：

# 根据创建的时间正序排序
articles = Article.objects.order_by("create_time")
# 根据创建的时间倒序排序
articles = Article.objects.order_by("-create_time")
# 根据作者的名字进行排序
articles = Article.objects.order_by("author__name")
# 首先根据创建的时间进行排序，如果时间相同，则根据作者的名字进行排序
articles = Article.objects.order_by("create_time",'author__name')

一定要注意的一点是，多个

order_by

，会把前面排序的规则给打乱，而使用后面的排序方式。比如以下代码：

articles = Article.objects.order_by("create_time").order_by("author__name")
# 他会根据作者的名字进行排序，而不是使用文章的创建时间。

也可以在模型中定义的

Meta

类中定义

ordering

来指定默认的排序非昂时。

class xxx(models.Model):
...
class Meta:
db_table = 'book_order'
ordering = ['create_time', '-price']

也可以根据

annotate

定义的字段进行排序。

# 实现图书的销量进行排序
books = Book.objects.annotate(order_nums=Count("bookorder")).order_by("-order_nums")
for book in books:
print("%s %s"%(book.name, book.order_nums))

```
values()
```
：用来指定在提取数据出来，需要提取哪些字段。默认情况下会把表中所有的字段全部都提取出来，可以使用
```
values
```
来进行指定，并且使用了
```
values
```
方法后，提取出的
```
QuerySet
```
中的数据类型不是模型，而是在
```
values
```
方法中指定的字段和值形成的字典：
```
articles = Article.objects.values("title",'content') #articles还是一个QuerySet
for article in articles:
print(article)
```
以上打印出来的
```
article
```
是类似于
```
{"title":"abc","content":"xxx"}
```
的形式。
如果在
```
values
```
中没有传递任何参数，那么将会返回这个模型中所有的属性。

如果想要更改提取字段
```
content
```
的属性名，可以使用
```
F表达式
```
```
articles = Ariticle.object.values("title", text_content = F("content"))
# 返回`{"title":"abc","text_content":"xxx"}`
```
自定义的名字不能和模型上本身拥有的字段一样

也可以使用聚合函数来形成一个新的字段。
```
# 获取每本图书的销量
books = Book.objects.value("id", "name", order_nums = Count("bookorder__id"))
```

values_list()

：类似于

values

。只不过返回的

QuerySet

中，存储的不是字典，而是元组。示例代码如下：

articles = Article.objects.values_list("id","title")
print(articles)

那么在打印

articles

后，结果为

<QuerySet [(1,'abc'),(2,'xxx'),...]>

等。
如果在

values_list

中只有一个字段。那么你可以传递

flat=True

来将结果扁平化。如果拥有多个字典还使用该参数，则报错

示例代码如下：

articles1 = Article.objects.values_list("title")
>> <QuerySet [("abc",),("xxx",),...]>
articles2 = Article.objects.values_list("title",flat=True)
>> <QuerySet ["abc",'xxx',...]>

```
all()
```
：获取这个
```
ORM
```
模型的
```
QuerySet
```
对象。底层就是
```
return self.get_queryseet()
```
```
select_related()
```
：在提取某个模型的数据的同时，也提前将相关联的数据提取出来。产生一次查询。比如提取文章数据，可以使用
```
select_related
```
将
```
author
```
信息提取出来，以后再次使用
```
article.author
```
的时候就不需要再次去访问数据库了。可以减少数据库查询的次数。字段名是反向引用名字.示例代码如下：
```
article = Article.objects.get(pk=1)
>> article.author # 重新执行一次查询语句
article = Article.objects.select_related("author").get(pk=2)
>> article.author # 不需要重新执行查询语句了
```
```
select_related()
```
只能用在
```
一对多
```
或者
```
一对一
```
中(外键的关联对象上)，不能用在
```
多对多
```
或者
```
多对一
```
中。比如可以提前获取文章的作者，但是不能通过作者获取这个作者的文章，或者是通过某篇文章获取这个文章所有的标签。

prefetch_related()

：这个方法和

select_related

非常的类似，就是在访问多个表中的数据的时候，减少查询的次数。这个方法是为了解决

多对一

和

多对多

的关系的查询问题。产生两次查询比如要获取标题中带有

hello

字符串的文章以及他的所有标签，字段名是反向引用名字。示例代码如下：

books = Book.object.prefetch_related("bookorder_set")

但是如果在使用

article.tag_set

的时候，如果又创建了一个新的

QuerySet

那么会把之前的

SQL

优化给破坏掉。比如以下代码：

books = Book.objects.prefetch_related("bookorder_set")
for book in books:
print(book.name)
orders = book.bookorder_set.filter(price_gte=90)  # 因为filter方法会重新生成一个QuerySet，因此会破坏掉之前的sql优化
for order in orders:
print(order.id)

# 通过以下代码，我们可以看到在使用了filter的，他的sql查询会更多，而没有使用filter的，只有两次sql查询
for sql in connection.queries:
print(sql)

那如果确实是想要在查询的时候指定过滤条件该如何做呢，这时候我们可以使用

django.db.models.Prefetch

来实现，

Prefetch

这个可以提前定义好

queryset

。示例代码如下：

fron django.db.models import Prefetch

# 先使用Prefetch把查找的条件写好， 再放到prefetch_related中
prefetch = Prefetch("bookorder_set", queryset = BookOrder.objects.filter(price__gte=90))
books = Book.objects.prefetch_related(prefetch)
for book in books:
print(book.name)
order = book.bookorder_set.all()  # filter过
for order in orders:
print(order.id)

for sql in connection.queries:
print('='*30)
print(sql)

因为使用了

Prefetch

，即使在查询文章的时候使用了

filter

，也只会发生两次查询操作。

```
defer()
```
：在一些表中，可能存在很多的字段，但是一些字段的数据量可能是比较庞大的，而此时你又不需要，比如我们在获取文章列表的时候，文章的内容我们是不需要的，因此这时候我们就可以使用
```
defer
```
来过滤掉一些字段。这个字段跟
```
values
```
有点类似，只不过
```
defer
```
返回的不是字典，而是模型。示例代码如下：
```
articles = list(Article.objects.defer("title"))
for sql in connection.queries:
print('='*30)
print(sql)
```
在看以上代码的
```
sql
```
语句，你就可以看到，查找文章的字段，除了
```
title
```
，其他字段都查找出来了。当然，你也可以使用
```
article.title
```
来获取这个文章的标题，但是会重新执行一个查询的语句(浪费资源)。示例代码如下：
```
articles = list(Article.objects.defer("title"))
for article in articles:
# 因为在上面提取的时候过滤了title
# 这个地方重新获取title，将重新向数据库中进行一次查找操作
print(article.title)
for sql in connection.queries:
print('='*30)
print(sql)
```
```
defer
```
虽然能过滤字段，但是有些字段是不能过滤的，比如
id
，即使你过滤了，也会提取出来。
```
only()
```
：跟
```
defer
```
类似，只不过
```
defer
```
是过滤掉指定的字段，而
```
only
```
是只提取指定的字段。**有些字段是会被提取出来的，比如
```
id
```
，即使你不提取，也会提取出来。**如果使用了未被提取的字段，会重新执行一个查询的语句(浪费资源)
```
get()
```
：获取满足条件的数据。这个函数只能返回一条数据，并且如果给的条件有多条数据，那么这个方法会抛出
```
MultipleObjectsReturned
```
错误，如果给的条件没有任何数据，那么就会抛出
```
DoesNotExit
```
错误。所以这个方法在获取数据的只能有且只有一条。
```
create()
```
：创建一条数据，并且保存到数据库中。这个方法相当于先用指定的模型创建一个对象，然后再调用这个对象的
```
save
```
方法。示例代码如下：
```
article = Article(title='abc')
article.save()

# 下面这行代码相当于以上两行代码
article = Article.objects.create(title='abc')
```
```
get_or_create()
```
：根据某个条件进行查找，如果找到了那么就返回这条数据，如果没有查找到，那么就创建一个。示例代码如下：
```
obj,created= Category.objects.get_or_create(title='默认分类')
```
如果有标题等于
```
默认分类
```
的分类，那么就会查找出来，如果没有，则会创建并且存储到数据库中。
这个方法的返回值是一个元组，元组的第一个参数
```
obj
```
是这个对象，第二个参数
```
created
```
代表是否创建的。

可用于设置外键默认值
```
def info_default():
return extra_info.object.get_or_create(name='默认的出版社')

class Book(modesl.Model):
...
other_info = models.ForeignKey(extra_info, on_delete=models.SET_DEFAULT, default=info_default)
```

bulk_create()

：一次性创建多个数据。示例代码如下：

publisher = Publisher.objects.bulk_create([
Publisher(name='a出版社'),
Publisher(name='b出版社'),
])

```
count()
```
：获取提取的数据的个数。如果想要知道总共有多少条数据，那么建议使用
```
count
```
，而不是使用
```
len(articles)
```
这种。因为
```
count
```
在底层是使用
```
select count(*)
```
来实现的，这种方式比使用
```
len
```
函数更加的高效。
```
books = Book.objects.count()
```
```
first()
```
和
```
last()
```
：返回
```
QuerySet
```
中的第一条和最后一条数据。
```
aggregate()
```
：使用聚合函数,返回一个dict。

exists()

：判断某个条件的数据是否存在。如果要判断某个条件的元素是否存在，那么建议使用

exists()

，这比使用

count()

或者直接判断

QuerySet

更有效得多。示例代码如下：

if Article.objects.filter(title__contains='hello').exists(): # 推荐
print(True)
# 比使用count更高效：
if Article.objects.filter(title__contains='hello').count() > 0:
print(True)
# 也比直接判断QuerySet更高效：
if Article.objects.filter(title__contains='hello'):
print(True)

```
distinct()
```
：去除掉那些重复的数据。这个方法如果底层数据库用的是
```
MySQL
```
，那么不能传递任何的参数。比如想要提取所有销售的价格超过80元的图书，并且删掉那些重复的，那么可以使用
```
distinct
```
来帮我们实现，示例代码如下：
```
books = Book.objects.filter(bookorder__price__gte=80).distinct()
```
需要注意的是，如果在
```
distinct
```
之前使用了
```
order_by
```
，那么因为
```
order_by
```
会提取
```
order_by
```
中指定的字段，此时使用
```
distinct
```
就会根据多个字段来进行唯一化，所以就不会把那些重复的数据删掉。示例代码如下：
```
orders = BookOrder.objects.order_by("create_time").values("book_id").distinct()
```
那么以上代码因为使用了
```
order_by
```
，即使使用了
```
distinct
```
，也会把重复的
```
book_id
```
提取出来。
```
update()
```
：执行更新操作，在
```
SQL
```
底层走的也是
```
update
```
命令。比如要将所有
```
category
```
为空的
```
article
```
的
```
article
```
字段都更新为默认的分类。示例代码如下：
```
Article.objects.filter(category__isnull=True).update(category_id=3)
```
注意这个方法走的是更新的逻辑。所以更新完成后保存到数据库中不会执行
```
save
```
方法，因此不会更新
```
auto_now
```
设置的字段。
```
delete()
```
：删除所有满足条件的数据。删除数据的时候，要注意
```
on_delete
```
指定的处理方式。
切片操作：有时候我们查找数据，有可能只需要其中的一部分。那么这时候可以使用切片操作来帮我们完成。
```
QuerySet
```
使用切片操作就跟列表使用切片操作是一样的。示例代码如下：
```
books = Book.objects.all()[1:3]
for book in books:
print(book)
```
切片操作并不是把所有数据从数据库中提取出来再做切片操作。而是在数据库层面使用
```
LIMIE
```
和
```
OFFSET
```
来帮我们完成。所以如果只需要取其中一部分的数据的时候，建议大家使用切片操作。

内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理

标签：

相关文章推荐

新的分享

章节导航