官方Django3.2 檔案：https://docs.djangoproject.com/en/3.2/topics/db/queries/
本文大部分內容參考官方3.2版本檔案撰寫，僅供學習使用
官方PDF下載鏈接：https://media.readthedocs.org/pdf/django/3.2.x/django.pdf
Django 執行查詢(一)
目錄- Django 執行查詢(一)
- 初步準備
- 將修改保存到物件
- 檢索物件
- 檢索所有物件
- 使用過濾器檢索特定物件
- filter(**kwargs)
- exclude(**kwargs)
- 鏈式過濾器
- 每個Queryset都是唯一的
- QuerySet 是惰性的
- 用 get() 檢索單個物件
- 其它 QuerySet 方法
- 限制Queryset條目數
- 欄位查詢
- exact
- iexact
- contains
- icontains
- startswith, endswith
- 跨關系查詢
（本文中涉及的到的代碼，建議復制粘貼的會以可折疊代碼塊展示，其他代碼塊建議手動練習，如果你對Models沒有初步認識，歡迎去看看官方檔案-Models或者其他文章，）
初步準備
將參考以下模型，它們構成了一個 Weblog 應用程式，文章中所有查詢操作都基于該模型，
點擊查看代碼
from django.db import models
class Blog(models.Model):
name = models.CharField(max_length=100)
tagline = models.TextField()
def __str__(self):
return self.name
class Author(models.Model):
name = models.CharField(max_length=200)
email = models.EmailField()
def __str__(self):
return self.name
class Entry(models.Model):
blog = models.ForeignKey(Blog, on_delete=models.CASCADE)
headline = models.CharField(max_length=255)
body_text = models.TextField()
pub_date = models.DateField()
mod_date = models.DateField()
authors = models.ManyToManyField(Author)
number_of_comments = models.IntegerField()
number_of_pingbacks = models.IntegerField()
rating = models.IntegerField()
def __str__(self):
return self.headline
將修改保存到物件
使用模型類的關鍵字引數對其進行實體化，然后呼叫save()以將其保存到資料庫中：
>>> from blog.models import Blog
>>> b = Blog(name='Beatles Blog', tagline='All the latest Beatles news.')
>>> b.save()
檢索物件
如果你想查看Queryset相關API，可以點擊這個鏈接，
為了從資料庫中檢索物件，通過你的模型類上的Manager（管理器）構造一個QuerySet，過濾器根據給定的引數縮小查詢結果的范圍，在SQL術語中，一個QuerySet相當于一個SELECT陳述句，而過濾器是一個限制性子句，如WHERE或LIMIT，
您可以使用模型的 Manager 獲得一個 QuerySet，每個模型至少有一個Manager（管理器），默認稱為objects，通過模型類直接訪問它，如下所示：
>>> Blog.objects
<django.db.models.manager.Manager object at ...>
>>> b = Blog(name='Foo', tagline='Bar')
>>> b.objects
Traceback:
...
AttributeError: "Manager isn't accessible via Blog instances."
【注意】
管理器（manger）只能通過模型類而不是
模型實體來訪問，以強制區分“表級”操作和“記錄級”操作，
Manager（管理器） 是模型的 QuerySet 的主要來源，例如，Blog.objects.all() 回傳一個包含資料庫中所有 Blog 物件的 QuerySet，
檢索所有物件
從表中檢索物件的最簡單方法是獲取所有物件，為此，請在 Manager 上使用 all() 方法：
>>> all_entries = Entry.objects.all()
all() 方法回傳了資料庫中所有物件的 QuerySet，
使用過濾器檢索特定物件
all() 回傳的 QuerySet 描述了資料庫表中的所有物件，但是，通常您只需要選擇完整物件集的一個子集，
要創建這樣的子集，您需要優化初始 QuerySet，添加過濾條件，細化 QuerySet 的兩種最常見的方法是：
filter(**kwargs)
回傳一個新的 QuerySet，其中包含與給定查找引數匹配的物件，
exclude(**kwargs)
回傳一個新的 QuerySet，其中包含與給定查找引數匹配的物件，
回傳一個新的QuerySet，包含不符合給定查找引數的物件，
查詢引數（上述函式定義中的**kwargs）應該采用下面欄位查詢中描述的格式，
例如，要包含獲取 2006 年的博客條目（entries blog）的 QuerySet，像這樣使用 filter():
Entry.objects.filter(pub_date__year=2006)
通過默認管理器類也一樣:
Entry.objects.all().filter(pub_date__year=2006)
鏈式過濾器
細化QuerySet 的結果本身還是一個 QuerySet，所以能串聯多個細化程序，例子:
>>> Entry.objects.filter(
... headline__startswith='What'
... ).exclude(
... pub_date__gte=datetime.date.today()
... ).filter(
... pub_date__gte=datetime.date(2005, 1, 30)
... )
這個例子先獲取包含資料庫所有條目（entry）的 QuerySet，添加一個過濾器，然后排除一些，再進入另一個過濾器，最終的 QuerySet 包含標題以 "What" 開頭的，發布日期介于 2005 年 1 月 30 日與今天之間的所有條目，
每個Queryset都是唯一的
每次精煉（細化）一個 QuerySet，你就會獲得一個全新的 QuerySet，后者與前者毫無關聯，每次精煉都會創建一個單獨的、不同的 QuerySet，能被存盤，使用和復用，
>>> 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())
這三個 QuerySets 是獨立的，第一個是基礎 QuerySet，包含了所有標題以 "What" 開頭的條目，第二個是第一個的子集，帶有額外條件，排除了 pub_date 是今天和今天之后的所有記錄，第三個是第一個的子集，帶有額外條件，只篩選 pub_date 是今天或未來的所有記錄，最初的 QuerySet (q1) 不受篩選操作影響，
QuerySet 是惰性的
QuerySet 是惰性的 —— 創建 QuerySet 并不會引發任何資料庫活動，你可以將一整天的過濾器都堆積在一起，Django 只會在 QuerySet 被計算時執行查詢操作，來瞄一眼這個例子:
>>> 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)
雖然這看起來像是三次資料庫操作，實際上只在最后一行 (print(q)) 做了一次，一般來說， QuerySet 的結果直到你 “要使用” 時才會從資料庫中拿出，當你要用時，才通過資料庫計算出 QuerySet，
用 get() 檢索單個物件
filter() 總是回傳一個 QuerySet，即便只有一個物件滿足查詢條件 —— 這種情況下，QuerySet 只包含了一個元素，
若你知道只會有一個物件滿足查詢條件，你可以在 Manager 上使用 get() 方法，它會直接回傳這個物件:
>>> one_entry = Entry.objects.get(pk=1)
【注意】
使用切片 [0] 時的 get() 和 filter() 有點不同，如果沒有滿足查詢條件的結果， get() 會拋出一個 DoesNotExist 例外，該例外是執行查詢的模型類的一個屬性 —— 所有，上述代碼中，若沒有哪個 Entry 物件的主鍵是 1，Django 會拋出 Entry.DoesNotExist，
類似了，Django 會在有不止一個記錄滿足 get() 查詢條件時發出警告，這時，Django 會拋出 MultipleObjectsReturned，這同樣也是模型類的一個屬性，
所以說get()方法的使用中無論不存在或者存在多條都會報錯，拋出的例外是可以被合理應用的
其它 QuerySet 方法
大多數情況下，你會在需要從資料庫中檢索物件時使用 all()， get()， filter() 和 exclude()，然而，這樣遠遠不夠；完整的各種 QuerySet 方法請參閱 QuerySet API reference ，
限制Queryset條目數
總結一下，可以切邊，切邊后的結果不能再排序or過濾，而且不能使用副索引
利用 Python 的陣列切片語法將 QuerySet 切成指定長度，這等價于 SQL 的 LIMIT 和 OFFSET 子句，
例如，這將回傳前 5 個物件 (LIMIT 5):
>>> Entry.objects.all()[:5]
這會回傳第 6 至第 10 個物件 (OFFSET 5 LIMIT 5):
>>> Entry.objects.all()[5:10]
不支持負索引 (例如 Entry.objects.all()[-1])
一般情況下， QuerySet 的切片回傳一個新的 QuerySet —— 其并未執行查詢，一個特殊情況是使用了的 Python 切片語法的 “步長”，例如，這將會實際的執行查詢命令，為了獲取從前 10 個物件中，每隔一個抽取的物件組成的串列:
>>> Entry.objects.all()[:10:2]
由于對 queryset 切片作業方式的模糊性，禁止對其進行進一步的排序或過濾，
要檢索 單個 物件而不是一個串列時（例如 SELECT foo FROM bar LIMIT 1），請使用索引，而不是切片，例如，這會回傳按標題字母排序后的第一個 Entry:
>>> Entry.objects.order_by('headline')[0]
這大致等價于:
>>> Entry.objects.order_by('headline')[0:1].get()
然而，注意一下，若沒有物件滿足給定條件，前者會拋出 IndexError，而后者會拋出 DoesNotExist，參考 get() 獲取更多細節，
欄位查詢
欄位查詢即你如何制定 SQL WHERE 子句，它們以關鍵字引數的形式傳遞給 QuerySet 方法 filter()， exclude() 和 get()，
基本的查詢關鍵字引數遵照 field__lookuptype=value，（有個雙下劃線），例如:
>>> Entry.objects.filter(pub_date__lte='2006-01-01')
轉換為 SQL 陳述句大致如下：
SELECT * FROM blog_entry WHERE pub_date <= '2006-01-01';
查詢子句中指定的欄位必須是模型的一個欄位名，不過也有個例外，在 ForeignKey 中，你可以指定以 _id 為后綴的欄位名，這種情況下，value 引數需要包含 foreign 模型的主鍵的原始值，例子：
(點擊此連接 ForeignKey 官方詳解（多對一關系）)
>>> Entry.objects.filter(blog_id=4)
若你傳入了無效的關鍵字引數，查詢函式會拋出 TypeError，
資料庫 API 支持兩套查詢型別；完整參考檔案位于 QuerySet API reference 欄位查詢參考，為了讓你了解能干啥，以下是一些常見的查詢：
exact
完全匹配，如果提供的比較值是 None，它將被解釋為 SQL NULL （詳見 isnull），
一個 "exact" 匹配的例子:
>>> Entry.objects.get(headline__exact="Cat bites dog")
官方翻譯：
若你沒有提供查詢型別 —— 也就說，若關鍵字引數未包含雙下劃線 —— 查詢型別會被指定為 exact，
google翻譯：
如果您不提供查找型別（即，如果您的關鍵字引數不包含雙下劃線），則假定查找型別是exact(精確)，
（下圖是官方翻譯，我是覺得有點問題）
iexact
不區分大小寫的完全匹配，如果提供的比較值是 None，它將被解釋為 SQL NULL （詳見 isnull），
>>> Blog.objects.get(name__iexact="beatles blog")
會匹配標題為 "Beatles Blog"， "beatles blog"， 甚至 "BeAtlES blOG" 的 Blog，
contains
區分大小寫的包含測驗，
舉例：
Entry.objects.get(headline__contains='Lennon')
SQL 等價于：
SELECT ... WHERE headline LIKE '%Lennon%';
icontains
不區分大小寫的包含測驗，
舉例：
Entry.objects.get(headline__icontains='Lennon')
SQL 等價于：
SELECT ... WHERE headline ILIKE '%Lennon%';
startswith, endswith
區分大小寫的開頭為;區分大小寫的結尾為.
以……開頭和以……結尾的查找，當然也有大小寫不敏感的版本，名為 istartswith 和 iendswith，
(官方檔案中對 field 查詢參考 沒有再詳細介紹，對更多欄位查詢感興趣可以查看我google翻譯的文章，點擊這段話即可)
跨關系查詢
Django 提供了一種強大而直觀的方式來“追蹤”查詢中的關系，在幕后自動為你處理 SQL JOIN 關系，為了跨越關系，跨模型使用關聯欄位名，欄位名由雙下劃線分割，直到拿到想要的欄位，
本例檢索出所有的 Entry 物件，其 Blog 的 name 為 'Beatles Blog' ：
>>> Entry.objects.filter(blog__name='Beatles Blog')
這個跨度可以是你想要的深度，
它也可以向后作業，雖然它可以被定制，但默認情況下，你在查詢中使用模型的小寫名稱來參考 "反向 "關系，
本例檢索的所有 Blog 物件均擁有少一個 標題 含有 'Lennon' 的條目:
>>> Blog.objects.filter(entry__headline__contains='Lennon')
轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/498505.html
標籤：其他