摘要：查詢集表示從數(shù)據(jù)庫中取出來的對(duì)象的集合。例如，返回包含數(shù)據(jù)庫中所有對(duì)象的一個(gè)查詢集。最后的結(jié)果仍然是一個(gè)查詢集，它包含標(biāo)題以開頭發(fā)布日期在年月日至當(dāng)天之間的所有記錄。一般來說，只有在請(qǐng)求查詢集的結(jié)果時(shí)才會(huì)到數(shù)據(jù)庫中去獲取它們。

Django 使用一種直觀的方式把數(shù)據(jù)庫表中的數(shù)據(jù)表示成Python 對(duì)象：

一個(gè)模型類代表數(shù)據(jù)庫中的一個(gè)表，一個(gè)模型類的實(shí)例代表這個(gè)數(shù)據(jù)庫表中的一條特定的記錄。

使用關(guān)鍵字參數(shù)實(shí)例化模型實(shí)例來創(chuàng)建一個(gè)對(duì)象，然后調(diào)用save() 把它保存到數(shù)據(jù)庫中。

也可以使用一條語句創(chuàng)建并保存一個(gè)對(duì)象，使用create()方法

準(zhǔn)備models模型

#dashboard/model.py
from django.db import models
# Create your models here.
class User(models.Model):
    id = models.AutoField(max_length=11,primary_key=True)
    username = models.CharField(max_length=32,null=False)
    class Meta:
        managed = False
        db_table = "user"
        ordering = ["username"]
        verbose_name = ""

class Idc(models.Model):
    name = models.CharField("IDC名稱",max_length=128,blank=False,null=False)
    address = models.CharField("IDC地址",max_length=200,default="")
    phone = models.CharField("IDC聯(lián)系電話",max_length=15,null=True)
    #user = models.CharField("IDC聯(lián)系人",max_length=32,null=True)

同步數(shù)據(jù)

python manage.py makemigrations dashboard
python manage.py migrate dashboard

進(jìn)入shell：

(venv3) [vagrant@localhost devops]$ python manage.py shell
In [1]: from dashboard.models import Idc                                                
In [2]: idc = Idc()                                                                     
In [3]: idc.name = "北京機(jī)房"                                                           
In [4]: idc.address = "北京"                                                            
In [5]: idc.phone = "1234553"                                                           
In [6]: idc.save()                                                                      
In [7]: data = {}                                                                       
In [8]: data["name"] = "上海機(jī)房"                                                       
In [9]: data["address"] = "上海"                                                        
In [10]: data["phone"] = "123445566"                                                    
In [11]: Idc.objects.create(**data)   

通過模型中的管理器構(gòu)造一個(gè)查詢集，來從你的數(shù)據(jù)庫中獲取對(duì)象。
查詢集(queryset)表示從數(shù)據(jù)庫中取出來的對(duì)象的集合。它可以含有零個(gè)、一個(gè)或者多個(gè)過濾器。過濾器基于所給的參數(shù)限制查詢的結(jié)果。 從SQL 的角度，查詢集和SELECT 語句等價(jià)，過濾器是像WHERE 和LIMIT 一樣的限制子句。
你可以從模型的管理器那里取得查詢集,每個(gè)模型都至少有一個(gè)管理器,它默認(rèn)命名為objects。通過模型類來直接訪問它
管理器只可以通過模型的類訪問，而不可以通過模型的實(shí)例訪問，目的是為了強(qiáng)制區(qū)分“表級(jí)別”的操作和“記錄級(jí)別”的操作。
對(duì)于一個(gè)模型來說，管理器是查詢集的主要來源。例如，User.objects.all() 返回包含數(shù)據(jù)庫中所有User 對(duì)象的一個(gè)查詢集。

獲取一個(gè)表中所有對(duì)象的最簡(jiǎn)單的方式是全部獲取。可以使用管理器的all() 方法：
all()方法返回包含數(shù)據(jù)庫中所有對(duì)象的一個(gè)查詢集
all_users = User.objects.all()

(venv3) [vagrant@localhost devops]$ python manage.py shell
In [1]: from django.contrib.auth.models import User                                                                                                                                                                                              
In [2]: user = User.objects.all()                                                                                                                                                                                                                
In [3]: print(user.query)                                                                                                                                                                                                                        
SELECT `auth_user`.`id`, `auth_user`.`password`, `auth_user`.`last_login`, `auth_user`.`is_superuser`, `auth_user`.`username`, `auth_user`.`first_name`, `auth_user`.`last_name`, `auth_user`.`email`, `auth_user`.`is_staff`, `auth_user`.`is_active`, `auth_user`.`date_joined` FROM `auth_user`

all() 方法返回了一個(gè)包含數(shù)據(jù)庫表中所有記錄查詢集。但在通常情況下，你往往想要獲取的是完整數(shù)據(jù)集的一個(gè)子集
要?jiǎng)?chuàng)建這樣一個(gè)子集，你需要在原始的的查詢集上增加一些過濾條件。兩個(gè)最普遍的途徑是：
filter(**kwargs) 返回一個(gè)新的查詢集，它包含滿足查詢參數(shù)的對(duì)象。
exclude(**kwargs) 返回一個(gè)新的查詢集，它包含不滿足查詢參數(shù)的對(duì)象。
查詢參數(shù)（上面函數(shù)定義中的**kwargs）需要滿足特定的格式，下面字段查詢一節(jié)中會(huì)提到

- 要獲取年份為2006的所有文章的查詢集，可以使用filter()方法：
  Entry.objects.filter(pub_date__year=2006)
- 利用默認(rèn)的管理器，它相當(dāng)于：
  Entry.objects.all().filter(pub_date__year=2006)
- 查詢集的篩選結(jié)果本身還是查詢集，所以可以將篩選語句鏈接在一起。像這樣：
  Entry.objects.filter(
    headline__startswith="What’
  ).exclude(
    pub_date__gte=datetime.date.today()
  ).filter(
    pub_date__gte=datetime(2005, 1, 30)
  )
# 這個(gè)例子最開始獲取數(shù)據(jù)庫中所有對(duì)象的一個(gè)查詢集，之后增加一個(gè)過濾器，然后又增加一個(gè)排除，再之后又是另外一個(gè)過濾器。最后的結(jié)果仍然是一個(gè)查詢集，它包含標(biāo)題以”What“開頭、發(fā)布日期在2005年1月30日至當(dāng)天之間的所有記錄。

過濾后的查詢集是獨(dú)立的

每次你篩選一個(gè)查詢集，得到的都是全新的另一個(gè)查詢集，它和之前的查詢集之間沒有任何綁定關(guān)系。每次篩選都會(huì)創(chuàng)建一個(gè)獨(dú)立的查詢集，它可以被存儲(chǔ)及反復(fù)使用。

 q1 = Entry.objects.filter(headline__startswith="What")
 q2 = q1.exclude(pub_date__gte=datetime.date.today())
 q3 = q1.filter(pub_date__gte=datetime.date.today())

查詢集是惰性執(zhí)行的

查詢集是惰性執(zhí)行的 —— 創(chuàng)建查詢集不會(huì)帶來任何數(shù)據(jù)庫的訪問。你可以將過濾器保持一整天，直到查詢集 需要求值時(shí)，Django 才會(huì)真正運(yùn)行這個(gè)查詢。

  >>> q = Entry.objects.filter(headline__startswith="What")
  >>> q = q.filter(pub_date__lte=datetime.date.today())
  >>> q = q.exclude(body_text__icontains="food")
  >>> print(q)

雖然它看上去有三次數(shù)據(jù)庫訪問，但事實(shí)上只有在最后一行（print(q)）時(shí)才訪問一次數(shù)據(jù)庫。一般來說，只有在“請(qǐng)求”查詢集 的結(jié)果時(shí)才會(huì)到數(shù)據(jù)庫中去獲取它們。當(dāng)你確實(shí)需要結(jié)果時(shí)，查詢集 通過訪問數(shù)據(jù)庫來求值

filter() 始終給你一個(gè)查詢集，即使只有一個(gè)對(duì)象滿足查詢條件 —— 這種情況下，查詢集將只包含一個(gè)元素。
如果你知道只有一個(gè)對(duì)象滿足你的查詢，你可以使用管理器的get() 方法，它直接返回該對(duì)象：

one_entry = Entry.objects.get(pk=1)
可以對(duì)get() 使用任何查詢表達(dá)式，和filter() 一樣
使用get() 和使用filter() 的切片[0] 有一點(diǎn)區(qū)別。如果沒有結(jié)果滿足查詢，get() 將引發(fā)一個(gè)DoesNotExist 異常。這個(gè)異常是正在查詢的模型類的一個(gè)屬性 —— 所以在上面的代碼中，如果沒有主鍵為1 的Entry 對(duì)象，Django 將引發(fā)一個(gè)Entry.DoesNotExist。
如果有多條記錄滿足get() 的查詢條件，Django 也將報(bào)錯(cuò)。這種情況將引發(fā)MultipleObjectsReturned，它同樣是模型類自身的一個(gè)屬性。

可以使用Python 的切片語法來限制查詢集記錄的數(shù)目 。它等同于SQL 的LIMIT 和OFFSET 子句。

  >>> Entry.objects.all()[:5]
  >>> Entry.objects.all()[5:10]

字段查詢是指如何指定SQL WHERE 子句的內(nèi)容。它們通過查詢集方法filter()、exclude() 和 get() 的關(guān)鍵字參數(shù)指定。
查詢的關(guān)鍵字參數(shù)的基本形式是field__lookuptype=value（中間是兩個(gè)下劃線）

>>> Entry.objects.filter(pub_date__lte="2006-01-01")
  SELECT * FROM blog_entry WHERE pub_date <= "2006-01-01";

exact “精確”匹配

  >>> Entry.objects.get(headline__exact="Man bites dog")
  SELECT ... WHERE headline = "Man bites dog";
  >>> Blog.objects.get(id__exact=14)
  >>> Blog.objects.get(id=14)

iexact 大小寫不敏感的匹配

contains 大小寫敏感的包含指定字符串

icontains 大小寫不敏感的包含指定字符串

startswith, endswith 以指字字符串開頭或結(jié)尾

istartswith, iendswith

in 在給定的列表內(nèi)

gt 大于

gte 大于或等于

lt 小于

lte 小于或等于

range 在指定范圍內(nèi)

year /month / day/ week_day 對(duì)于日期和日期時(shí)間字段，匹配年/月/日/星期

Django 提供一個(gè)查詢快捷方式pk ，它表示“primary key” 的意思

  >>> Blog.objects.get(id__exact=14)
  >>> Blog.objects.get(id=14)
  >>> Blog.objects.get(pk=14)

默認(rèn)情況下，QuerySet 根據(jù)模型Meta 類的ordering 選項(xiàng)排序。你可以使用order_by 方法給每個(gè)QuerySet 指定特定的排序

Entry.objects.filter(pub_date__year=2005).order_by("-pub_date", "headline")
上面的結(jié)果將按照pub_date 降序排序，然后再按照headline 升序排序。"-pub_date" 前面的負(fù)號(hào)表示降序排序。隱式的是升序排序。若要隨機(jī)排序，請(qǐng)使用"?"，像這樣：
Entry.objects.order_by("?")

返回一個(gè)ValuesQuerySet —— QuerySet 的一個(gè)子類，迭代時(shí)返回字典而不是模型實(shí)例對(duì)象。
每個(gè)字典表示一個(gè)對(duì)象，鍵對(duì)應(yīng)于模型對(duì)象的屬性名稱。
values() 接收可選的位置參數(shù)*fields，它指定SELECT 應(yīng)該限制哪些字段。如果指定字段，每個(gè)字典將只包含指定的字段的鍵/值。如果沒有指定字段，每個(gè)字典將包含數(shù)據(jù)庫表中所有字段的鍵和值。

User.objects.values("id", "username")

與values() 類似，只是在迭代時(shí)返回的是元組而不是字典。每個(gè)元組包含傳遞給values_list() 調(diào)用的字段的值 —— 所以第一個(gè)元素為第一個(gè)字段，以此類推。

User.objects.values_list("id", "username")

在一些復(fù)雜的數(shù)據(jù)建模情況下，您的模型可能包含大量字段，其中一些可能包含大量數(shù)據(jù)需要昂貴的處理來將它們轉(zhuǎn)換為Python對(duì)象。（例如，文本字段），或者如果您在某些情況下使用查詢集的結(jié)果，當(dāng)您最初獲取數(shù)據(jù)時(shí)不知道是否需要這些特定字段，可以告訴Django不要從數(shù)據(jù)庫中檢索它們

User.objects.defer("username", "email")

刪除對(duì)象使用delete()。這個(gè)方法將立即刪除對(duì)象且沒有返回值。

Entry.objects.filter(pub_date__year=2005).delete()

雖然沒有內(nèi)建的方法用于拷貝模型實(shí)例，但還是很容易創(chuàng)建一個(gè)新的實(shí)例并讓它的所有字段都拷貝過來。最簡(jiǎn)單的方法是，只需要將pk 設(shè)置為None。

  blog = Blog(name="My blog", tagline="Blogging is easy")
  blog.save() # blog.pk == 1
  blog.pk = None
  blog.save() # blog.pk == 2

更新對(duì)象使用update()

Entry.objects.filter(pub_date__year=2007).update(headline="Everything is the same")
update() 方法會(huì)立即執(zhí)行并返回查詢匹配的行數(shù)(如果有些行已經(jīng)具有新的值，返回的行數(shù)可能和被更新的行數(shù)不相等)

F()允許Django在未實(shí)際鏈接數(shù)據(jù)的情況下具有對(duì)數(shù)據(jù)庫字段的值的引用。通常情況下我們?cè)诟聰?shù)據(jù)時(shí)需要先從數(shù)據(jù)庫里將原數(shù)據(jù)取出后方在內(nèi)存里，然后編輯某些屬性，最后提交。例如

  order = Order.objects.get(orderid="123456789")
  order.amount += 1
  order.save()
這時(shí)就可以使用F()方法，代碼如下
  from django.db.models import F
  order = Order.objects.get(orderid="123456789")
  order.amount = F("amount") - 1
  order.save()

Q對(duì)象(django.db.models.Q)可以對(duì)關(guān)鍵字參數(shù)進(jìn)行封裝，從而更好地應(yīng)用多個(gè)查詢?？梢越M合使用 &（and）,|（or），~（not）操作符，當(dāng)一個(gè)操作符是用于兩個(gè)Q的對(duì)象,它產(chǎn)生一個(gè)新的Q對(duì)象。

  Order.objects.get(
    Q(desc__startswith="Who"),
    Q(create_time=date(2016, 10, 2)) | Q(create_time=date(2016, 10, 6))
  )

相當(dāng)于
  SELECT * from polls WHERE question LIKE "Who%"
  AND (pub_date = "2005-05-02" OR pub_date = "2005-05-06")

  from django.core import serializers
  data = serializers.serialize("json", SomeModel.objects.all())

from django.core import serializers
data = serializers.serialize("json", User.objects.all()[0:10], fields=("username","is_active"))