本文 model 設(shè)置如下:
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 根據(jù)模型 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('?') 查詢可能耗費資源且很慢。
涉及外鍵的排序
若要按照另外一個模型中(即:外鍵或其他對應(yīng)關(guān)系)的字段排序,可以在字段的名稱后面跟上兩個下劃線(__),再跟上新模型中的字段的名稱,例如:
# 按照所屬的博客的名稱排序
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)
<class 'django.db.models.query.QuerySet'>
# 對它進行迭代操作時將返回一個字典
>>> type(v[0])
<class 'dict'>
values() 接收可選的位置參數(shù) *fields,指定輸出哪些字段:
>>> e.values('id', 'headline')
<QuerySet [{'headline': 'ringo 教你打鼓', 'id': 3}, {'headline': 'John 和 Paul
教你作曲', 'id': 4}, {'headline': 'George 教你彈吉他', 'id': 5}]>
如果 values() 的參數(shù)是一個ForeignKey,默認的 values() 調(diào)用返回的字典將會是一個叫做 母表的 id :
>>> Entry.objects.values('blog')
# 返回的是母表的 id
<QuerySet [{'blog': 2}, {'blog': 2}, {'blog': 2}]>
# 這種寫法與上面的等價
>>> Entry.objects.values('blog_id')
values_list
與 values() 類似,只是在迭代時返回的是元組而不是字典:
>>> e = Entry.objects.values_list('id', 'headline')
>>> type(e)
<class 'django.db.models.query.QuerySet'>
# 返回一個元組
>>> type(e[0])
<class 'tuple'>
當 flat 參數(shù)為True 時,它表示返回的結(jié)果為單個值而不是元組:
>>> e = Entry.objects.values_list('id', flat=True).order_by('id')
>>> e[0]
1
>>> type(e[0])
<class 'int'>
注意:如果有多個字段,傳遞 flat 將發(fā)生錯誤。
如果你不傳遞任何值給 values_list(),它將返回模型中的所有字段。
dates
dates(field, kind, order='ASC')
返回 DateQuerySet - QuerySet,其計算結(jié)果為 datetime.date 對象。
field 應(yīng)為模型的 DateField 的名稱。 kind 應(yīng)為 "year"、"month" 或 "day"。
- "year" 表示精確到年
- “month” 表示精確到月
- “day” 表示精確到日
order(默認為“ASC”)應(yīng)為'ASC'或'DESC'。
注:asc 是升序排列,desc 是降序排列。
例子:
# 返回值精確到年,因為所有 entry 的 pub_date 都是 2017年,所以只有一個返回值
>>> Entry.objects.dates('pub_date', 'year')
<QuerySet [datetime.date(2017, 1, 1)]>
# 返回值精確到月
>>> Entry.objects.dates('pub_date', 'month')
<QuerySet [datetime.date(2017, 2, 1)]>
# 精確到日,默認為升序
>>> Entry.objects.dates('pub_date', 'day')
<QuerySet [datetime.date(2017, 2, 1), datetime.date(2017, 2, 2)]>
# 精確到日,降序排列
>>> Entry.objects.dates('pub_date', 'day', order='DESC')
<QuerySet [datetime.date(2017, 2, 2), datetime.date(2017, 2, 1)]>
# 查詢某篇博文的 pub_date
>>> e = Entry.objects.filter(headline='George 教你彈吉他')
>>> e.dates('pub_date', 'day')
<QuerySet [datetime.date(2017, 2, 1)]>
datetimes
(待補充)
None
調(diào)用 none() 將創(chuàng)建一個從不返回任何對象的查詢集,并且在訪問結(jié)果時不會執(zhí)行任何查詢。
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 去查詢帶外鍵關(guān)系的對象時,它會預(yù)加載相關(guān)的數(shù)據(jù)表,以后再查詢外鍵關(guān)系時就不用再去請求數(shù)據(jù)庫。
下面的例子解釋了普通查詢和 select_related() 查詢的區(qū)別:
- 普通查詢:
# 請求數(shù)據(jù)庫
e = Entry.objects.get(id=5)
# 再次請求數(shù)據(jù)庫
b = e.blog
- select_related 查詢:
# 請求數(shù)據(jù)庫
e = Entry.objects.select_related('blog').get(id=5)
# 無需再請求數(shù)據(jù)庫,因為相關(guān)數(shù)據(jù)已經(jīng)預(yù)加載
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)
可以這樣調(diào)用將緩存關(guān)聯(lián)的 Person 和關(guān)聯(lián)的 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 方法是用一個列表來批量插入數(shù)據(jù):
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)
獲取主鍵值的列表,并返回一個字典:
# 如果不填參數(shù)將獲取全部
>>> Entry.objects.in_bulk()
{
3: <Entry: ringo 教你打鼓>,
4: <Entry: John 和 Paul 教你作曲>,
5: <Entry: George 教你彈吉他>
}
>>> Entry.objects.in_bulk([3])
{3: <Entry: ringo 教你打鼓>}
>>> Entry.objects.in_bulk([3,4])
{
3: <Entry: ringo 教你打鼓>,
4: <Entry: John 和 Paul 教你作曲>
}
- iterator()
iterator() 方法可以把一個查詢集變成一個迭代器:
a = Entry.objects.all()
a = a.iterator()
# 生成一個迭代器
>>> type(a)
generator
- latest(field_name=None)
按日期返回表中的最的新對象:
# 返回 pub_date 最新的對象
>>> Entry.objects.latest('pub_date')
<Entry: John 和 Paul 教你作曲>
- earliest(field_name=None)
按日期返回表中的最早的對象:
>>> Entry.objects.earliest('pub_date')
<Entry: ringo 教你打鼓>
- first()
返回結(jié)果集的第一個對象, 當沒有找到時返回None。
例:
>>> Entry.objects.first()
<Entry: ringo 教你打鼓>
- 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
(待補充)