ORM

映射關系：

表名 <－－－－－－－> 類名

字段 <－－－－－－－> 屬性

　　　　表記錄 <－－－－－－－>類實例對象

回到頂部

創建表(建立模型)

實例：我們來假定下面這些概念，字段和關系

作者模型：一個作者有姓名和年齡。

作者詳細模型：把作者的詳情放到詳情表，包含生日，手機號，家庭住址等信息。作者詳情模型和作者模型之間是一對一的關系（one-to-one）

出版商模型：出版商有名稱，所在城市以及email。

書籍模型： 書籍有書名和出版日期，一本書可能會有多個作者，一個作者也可以寫多本書，所以作者和書籍的關系就是多對多的關聯關系(many-to-many);一本書只應該由一個出版商出版，所以出版商和書籍是一對多關聯關系

模型建立如下：

class Author(models.Model):

nid = models.AutoField(primary_key=True)

name=models.CharField( max_length=32)

age=models.IntegerField()

#與AuthorDetail建立一對一的關系

authorDetail=models.OneToOneField(to="AuthorDetail")

class AuthorDetail(models.Model):

nid = models.AutoField(primary_key=True)

birthday=models.DateField()

telephone=models.BigIntegerField()

addr=models.CharField( max_length=64)

class Publish(models.Model):

nid = models.AutoField(primary_key=True)

name=models.CharField( max_length=32)

city=models.CharField( max_length=32)

email=models.EmailField()

class Book(models.Model):

nid = models.AutoField(primary_key=True)

title = models.CharField( max_length=32)

publishDate=models.DateField()

price=models.DecimalField(max_digits=5,decimal_places=2)

keepNum=models.IntegerField()<br> commentNum=models.IntegerField()

#與Publish建立一對多的關系,外鍵字段建立在多的一方

publish=models.ForeignKey(to="Publish",to_field="nid")

#與Author表建立多對多的關系,ManyToManyField可以建在兩個模型中的任意一個，自動創建第三張表

authors=models.ManyToManyField(to=‘Author‘)

通過logging可以查看翻譯成的sql語句

LOGGING = {

‘version‘: 1,

‘disable_existing_loggers‘: False,

‘handlers‘: {

‘console‘:{

‘level‘:‘DEBUG‘,

‘class‘:‘logging.StreamHandler‘,

},

},

‘loggers‘: {

‘django.db.backends‘: {

‘handlers‘: [‘console‘],

‘propagate‘: True,

‘level‘:‘DEBUG‘,

},

}

}

註意事項：

1、 表的名稱myapp_modelName，是根據 模型中的元數據自動生成的，也可以覆寫為別的名稱　　

2、id 字段是自動添加的

3、對於外鍵字段，Django 會在字段名上添加"_id"來創建數據庫中的列名

4、這個例子中的CREATE TABLE SQL 語句使用PostgreSQL 語法格式，要註意的是Django 會根據settings 中指定的數據庫類型來使用相應的SQL 語句。

5、定義好模型之後，你需要告訴Django _使用_這些模型。你要做的就是修改配置文件中的INSTALL_APPSZ中設置，在其中添加models.py所在應用的名稱。

6、外鍵字段 ForeignKey 有一個 null=True 的設置(它允許外鍵接受空值 NULL)，你可以賦給它空值 None 。

字段選項

每個字段有一些特有的參數，例如，CharField需要max_length參數來指定VARCHAR數據庫字段的大小。還有一些適用於所有字段的通用參數。 這些參數在文檔中有詳細定義，這裏我們只簡單介紹一些最常用的：

(1)null

如果為True，Django 將用NULL 來在數據庫中存儲空值。 默認值是 False.

(2)blank

如果為True，該字段允許不填。默認為False。

要註意，這與 null 不同。null純粹是數據庫範疇的，而 blank 是數據驗證範疇的。

如果一個字段的blank=True，表單的驗證將允許該字段是空值。如果字段的blank=False，該字段就是必填的。

(3)default

字段的默認值。可以是一個值或者可調用對象。如果可調用 ，每有新對象被創建它都會被調用。

(4)primary_key

如果為True，那麽這個字段就是模型的主鍵。如果你沒有指定任何一個字段的primary_key=True，

Django 就會自動添加一個IntegerField字段做為主鍵，所以除非你想覆蓋默認的主鍵行為，

否則沒必要設置任何一個字段的primary_key=True。

(5)unique

如果該值設置為 True, 這個數據字段的值在整張表中必須是唯一的

(6)choices

由二元組組成的一個可叠代對象（例如，列表或元組），用來給字段提供選擇項。如果設置了choices ，默認的表單將是一個選擇框而不是標準的文本框，而且這個選擇框的選項就是choices 中的選項。

這是一個關於 choices 列表的例子：

YEAR_IN_SCHOOL_CHOICES = (

(‘FR‘, ‘Freshman‘),

(‘SO‘, ‘Sophomore‘),

(‘JR‘, ‘Junior‘),

(‘SR‘, ‘Senior‘),

(‘GR‘, ‘Graduate‘),

)

每個元組中的第一個元素，是存儲在數據庫中的值；第二個元素是在管理界面或 ModelChoiceField 中用作顯示的內容。 在一個給定的 model 類的實例中，想得到某個 choices 字段的顯示值，就調用 get_FOO_display 方法(這裏的 FOO 就是 choices 字段的名稱 )。例如：

from django.db import models

class Person(models.Model):

SHIRT_SIZES = (

(‘S‘, ‘Small‘),

(‘M‘, ‘Medium‘),

(‘L‘, ‘Large‘),

)

name = models.CharField(max_length=60)

shirt_size = models.CharField(max_length=1, choices=SHIRT_SIZES)

>>> p = Person(name="FredFlintstone", shirt_size="L")

>>> p.save()

>>> p.shirt_size

‘L‘

>>> p.get_shirt_size_display()

‘Large‘

一旦你建立好數據模型之後，django會自動生成一套數據庫抽象的API，可以讓你執行關於表記錄的增刪改查的操作。

添加表記錄

普通字段

方式1

publish_obj=Publish(name="人民出版社",city="北京",email="[email protected]")

publish_obj.save() # 將數據保存到數據庫

方式2 <br>返回值publish_obj是添加的記錄對象

publish_obj=Publish.objects.create(name="人民出版社",city="北京",email="[email protected]")<br><br>方式3<br>表.objects.create(**request.POST.dict())

外鍵字段

方式1:

publish_obj=Publish.objects.get(nid=1)

Book.objects.create(title="金瓶眉",publishDate="2012-12-12",price=665,pageNum=334,publish=publish_obj)

方式2:

Book.objects.create(title="金瓶眉",publishDate="2012-12-12",price=665,pageNum=334,publish_id=1)

多對多字段

book_obj=Book.objects.create(title="追風箏的人",publishDate="2012-11-12",price=69,pageNum=314,publish_id=1)

author_yuan=Author.objects.create(name="yuan",age=23,authorDetail_id=1)

author_egon=Author.objects.create(name="egon",age=32,authorDetail_id=2)

book_obj.authors.add(author_egon,author_yuan) # 將某個特定的 model 對象添加到被關聯對象集合中。 ======= book_obj.authors.add(*[])

book_obj.authors.create() #創建並保存一個新對象，然後將這個對象加被關聯對象的集合中，然後返回這個新對象。　

解除關系：

book_obj.authors.remove() # 將某個特定的對象從被關聯對象集合中去除。 ====== book_obj.authors.remove(*[])

book_obj.authors.clear() #清空被關聯對象集合。

class RelatedManager

"關聯管理器"是在一對多或者多對多的關聯上下文中使用的管理器。它存在於下面兩種情況：

ForeignKey關系的“另一邊”。像這樣：

from django.db import models

class Reporter(models.Model):

#...

pass

class Article(models.Model):

reporter = models.ForeignKey(Reporter)

在上面的例子中，管理器reporter.article_set擁有下面的方法。

ManyToManyField關系的兩邊：

class Topping(models.Model):

#...

pass

class Pizza(models.Model):

toppings = models.ManyToManyField(Topping)

這個例子中，topping.pizza_set和pizza.toppings都擁有下面的方法。

add(obj1[, obj2, ...])

把指定的模型對象添加到關聯對象集中。

例如：

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

>>> e = Entry.objects.get(id=234)

>>> b.entry_set.add(e) #Associates Entry e with Blog b.

在上面的例子中，對於ForeignKey關系，e.save()由關聯管理器調用，執行更新操作。然而，在多對多關系中使用add()並不會調用任何 save()方法，而是由QuerySet.bulk_create()創建關系。

create(**kwargs)

創建一個新的對象，保存對象，並將它添加到關聯對象集之中。返回新創建的對象：

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

>>> e = b.entry_set.create(

... headline=‘Hello‘,

... body_text=‘Hi‘,

... pub_date=datetime.date(2005, 1, 1)

... )

# No need to call e.save() at this point --it‘s already been saved.

這完全等價於（不過更加簡潔於）：

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

>>> e = Entry(

... blog=b,

... headline=‘Hello‘,

... body_text=‘Hi‘,

... pub_date=datetime.date(2005, 1, 1)

... )

>>> e.save(force_insert=True)

要註意我們並不需要指定模型中用於定義關系的關鍵詞參數。在上面的例子中，我們並沒有傳入blog參數給create()。Django會明白新的 Entry對象blog 應該添加到b中。

remove(obj1[, obj2, ...])

從關聯對象集中移除執行的模型對象：

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

>>> e = Entry.objects.get(id=234)

>>> b.entry_set.remove(e) #Disassociates Entry e from Blog b.

對於ForeignKey對象，這個方法僅在null=True時存在。

clear()

從關聯對象集中移除一切對象。

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

>>> b.entry_set.clear()

註意這樣不會刪除對象 ——只會刪除他們之間的關聯。

就像 remove() 方法一樣，clear()只能在 null=True的ForeignKey上被調用。

註意

對於所有類型的關聯字段，add()、create()、remove()和clear()都會馬上更新數據庫。換句話說，在關聯的任何一端，都不需要再調用save()方法。

直接賦值：

通過賦值一個新的可叠代的對象，關聯對象集可以被整體替換掉。

>>> new_list = [obj1, obj2, obj3]

>>> e.related_set = new_list

如果外鍵關系滿足null=True，關聯管理器會在添加new_list中的內容之前，首先調用clear()方法來解除關聯集中一切已存在對象的關聯。否則， new_list中的對象會在已存在的關聯的基礎上被添加。　　

查詢表記錄

查詢相關API

<1> all(): 查詢所有結果

<2> filter(**kwargs): 它包含了與所給篩選條件相匹配的對象

<3> get(**kwargs): 返回與所給篩選條件相匹配的對象，返回結果有且只有一個，如果符合篩選條件的對象超過一個或者沒有都會拋出錯誤。

<4>values(*field): 返回一個ValueQuerySet——一個特殊的QuerySet，運行後得到的並不是一系列model的實例化對象，而是一個可叠代的字典序列

<5> exclude(**kwargs): 它包含了與所給篩選條件不匹配的對象

<6> order_by(*field): 對查詢結果排序

<7> reverse(): 對查詢結果反向排序

<8> distinct(): 從返回結果中剔除重復紀錄

<9>values_list(*field): 它與values()非常相似，它返回的是一個元組序列，values返回的是一個字典序列

<10> count(): 返回數據庫中匹配查詢(QuerySet)的對象數量。

<11> first(): 返回第一條記錄

<12> last(): 返回最後一條記錄

<13> exists(): 如果QuerySet包含數據，就返回True，否則返回False

註意：一定區分object與querySet的區別 ！！！

雙下劃線之單表查詢

models.Tb1.objects.filter(id__lt=10,id__gt=1) # 獲取id大於1 且 小於10的值

models.Tb1.objects.filter(id__in=[11, 22,33]) # 獲取id等於11、22、33的數據

models.Tb1.objects.exclude(id__in=[11, 22,33]) # not in

models.Tb1.objects.filter(name__contains="ven")

models.Tb1.objects.filter(name__icontains="ven")# icontains大小寫不敏感

models.Tb1.objects.filter(id__range=[1,2]) # 範圍bettwen and

startswith，istartswith, endswith, iendswith

基於對象的跨表查詢

一對多查詢（Publish 與 Book）

正向查詢(按字段：publish)：

# 查詢nid=1的書籍的出版社所在的城市<br>

book_obj=Book.objects.get(nid=1)<br>print(book_obj.publish.city)# book_obj.publish 是nid=1的書籍對象關聯的出版社對象　　

反向查詢(按表名：book_set)：

# 查詢 人民出版社出版過的所有書籍

publish=Publish.objects.get(name="人民出版社")

book_list=publish.book_set.all() # 與人民出版社關聯的所有書籍對象集合

for book_obj in book_list:

print(book_obj.title)

一對一查詢(Author 與 AuthorDetail)

正向查詢(按字段：authorDetail)：

# 查詢egon作者的手機號

author_egon=Author.objects.get(name="egon")

print(author_egon.authorDetail.telephone)

反向查詢(按表名：author)：

# 查詢所有住址在北京的作者的姓名

authorDetail_list=AuthorDetail.objects.filter(addr="beijing")

for obj in authorDetail_list:

print(obj.author.name)

多對多查詢 (Author 與 Book)

正向查詢(按字段：authors)：

# 金瓶眉所有作者的名字以及手機號

book_obj=Book.objects.filter(title="金瓶眉").first()

authors=book_obj.authors.all()

for author_obj in authors:

print(author_obj.name,author_obj.authorDetail.telephone)

反向查詢(按表名：book_set)：

# 查詢egon出過的所有書籍的名字

author_obj=Author.objects.get(name="egon")

book_list=author_obj.book_set.all() #與egon作者相關的所有書籍

for book_obj in book_list:

print(book_obj.title)

註意：

你可以通過在ForeignKey() 和ManyToManyField的定義中設置 related_name 的值來覆寫 FOO_set 的名稱。例如，如果 Article model 中做一下更改： publish = ForeignKey(Blog, related_name=‘bookList‘)，那麽接下來就會如我們看到這般：

# 查詢 人民出版社出版過的所有書籍

publish=Publish.objects.get(name="人民出版社")

book_list=publish.bookList.all() # 與人民出版社關聯的所有書籍對象集合

基於雙下劃線的跨表查詢

Django 還提供了一種直觀而高效的方式在查詢(lookups)中表示關聯關系，它能自動確認 SQL JOIN 聯系。要做跨關系查詢，就使用兩個下劃線來鏈接模型(model)間關聯字段的名稱，直到最終鏈接到你想要的 model 為止。

# 練習1: 查詢人民出版社出版過的所有書籍的名字與價格(一對多)

#正向查詢 按字段:publish

queryResult=Book.objects

.filter(publish__name="人民出版社")

.values_list("title","price")

#反向查詢 按表名:book

queryResult=Publish.objects

.filter(name="人民出版社")

.values_list("book__title","book__price")

# 練習2: 查詢egon出過的所有書籍的名字(多對多)

#正向查詢 按字段:authors:

queryResult=Book.objects

.filter(authors__name="yuan")

.values_list("title")

#反向查詢 按表名:book

queryResult=Author.objects

.filter(name="yuan")

.values_list("book__title","book__price")

# 練習3: 查詢人民出版社出版過的所有書籍的名字以及作者的姓名

#正向查詢

queryResult=Book.objects

.filter(publish__name="人民出版社")

.values_list("title","authors__name")

# 反向查詢

queryResult=Publish.objects

.filter(name="人民出版社")

.values_list("book__title","book__authors__age","book__authors__name")

# 練習4: 手機號以151開頭的作者出版過的所有書籍名稱以及出版社名稱

queryResult=Book.objects

.filter(authors__authorDetail__telephone__regex="151")

.values_list("title","publish__name")

註意：

反向查詢時，如果定義了related_name，則用related_name替換表名，例如： publish = ForeignKey(Blog,related_name=‘bookList‘)：

# 練習1: 查詢人民出版社出版過的所有書籍的名字與價格(一對多)

#反向查詢 不再按表名:book,而是related_name:bookList

queryResult=Publish.objects

.filter(name="人民出版社")

.values_list("bookList__title","bookList__price")

聚合查詢與分組查詢

聚合：aggregate(*args,**kwargs)

# 計算所有圖書的平均價格

>>> from django.db.models import Avg

>>> Book.objects.all().aggregate(Avg(‘price‘))

{‘price__avg‘: 34.35}

aggregate()是QuerySet 的一個終止子句，意思是說，它返回一個包含一些鍵值對的字典。鍵的名稱是聚合值的標識符，值是計算出來的聚合值。鍵的名稱是按照字段和聚合函數的名稱自動生成出來的。如果你想要為聚合值指定一個名稱，可以向聚合子句提供它。

>>>Book.objects.aggregate(average_price=Avg(‘price‘))

{‘average_price‘: 34.35}

如果你希望生成不止一個聚合，你可以向aggregate()子句中添加另一個參數。所以，如果你也想知道所有圖書價格的最大值和最小值，可以這樣查詢：

>>> from django.db.models importAvg, Max, Min

>>>Book.objects.aggregate(Avg(‘price‘), Max(‘price‘), Min(‘price‘))

{‘price__avg‘: 34.35, ‘price__max‘:Decimal(‘81.20‘), ‘price__min‘: Decimal(‘12.99‘)}

分組：annotate()

為QuerySet中每一個對象都生成一個獨立的匯總值。　

(1) 練習：統計每一本書的作者個數

bookList=Book.objects.annotate(authorsNum=Count(‘authors‘))

for book_obj in bookList:

print(book_obj.title,book_obj.authorsNum)

SELECT

"app01_book"."nid",

"app01_book"."title",

"app01_book"."publishDate",

"app01_book"."price",

"app01_book"."pageNum",

"app01_book"."publish_id",

COUNT("app01_book_authors"."author_id")AS "authorsNum"

FROM "app01_book" LEFT OUTER JOIN"app01_book_authors"

ON ("app01_book"."nid"= "app01_book_authors"."book_id")

GROUP BY

"app01_book"."nid",

"app01_book"."title",

"app01_book"."publishDate",

"app01_book"."price",

"app01_book"."pageNum",

"app01_book"."publish_id"

(2) 如果想對所查詢對象的關聯對象進行聚合：

練習：統計每一個出版社的最便宜的書

publishList=Publish.objects.annotate(MinPrice=Min("book__price"))

for publish_obj in publishList:

print(publish_obj.name,publish_obj.MinPrice)

annotate的返回值是querySet，如果不想遍歷對象，可以用上valuelist：

queryResult= Publish.objects

.annotate(MinPrice=Min("book__price"))

.values_list("name","MinPrice")

print(queryResult)

方式2:

queryResult=Book.objects.values("publish__name").annotate(MinPrice=Min(‘price‘))

註意：values內的字段即group by的字段

(3) 統計每一本以py開頭的書籍的作者個數：

queryResult=Book.objects

.filter(title__startswith="Py")

.annotate(num_authors=Count(‘authors‘))

(4) 統計不止一個作者的圖書：

queryResult=Book.objects

.annotate(num_authors=Count(‘authors‘))

.filter(num_authors__gt=1)

(5) 根據一本圖書作者數量的多少對查詢集 QuerySet進行排序:

Book.objects.annotate(num_authors=Count(‘authors‘)).order_by(‘num_authors‘)

(6) 查詢各個作者出的書的總價格:

# 按author表的所有字段 group by

queryResult=Author.objects

.annotate(SumPrice=Sum("book__price"))

.values_list("name","SumPrice")

print(queryResult)

#按authors__name group by

queryResult2=Book.objects.values("authors__name")

.annotate(SumPrice=Sum("price"))

.values_list("authors__name","SumPrice")

print(queryResult2)

F查詢與Q查詢

F查詢

在上面所有的例子中，我們構造的過濾器都只是將字段值與某個常量做比較。如果我們要對兩個字段的值做比較，那該怎麽做呢？

Django 提供 F() 來做這樣的比較。F() 的實例可以在查詢中引用字段，來比較同一個 model 實例中兩個不同字段的值。

# 查詢評論數大於收藏數的書籍

from django.db.models import F

Book.objects.filter(commnetNum__lt=F(‘keepNum‘))

Django 支持 F() 對象之間以及 F() 對象和常數之間的加減乘除和取模的操作。

# 查詢評論數大於收藏數2倍的書籍

Book.objects.filter(commnetNum__lt=F(‘keepNum‘)*2)

修改操作也可以使用F函數,比如將每一本書的價格提高30元：

Book.objects.all().update(price=F("price")+30)

Q查詢

filter() 等方法中的關鍵字參數查詢都是一起進行“AND” 的。 如果你需要執行更復雜的查詢（例如OR 語句），你可以使用Q 對象。

from django.db.models import Q

Q(title__startswith=‘Py‘)

Q 對象可以使用& 和| 操作符組合起來。當一個操作符在兩個Q 對象上使用時，它產生一個新的Q 對象。

bookList=Book.objects.filter(Q(authors__name="yuan")|Q(authors__name="egon"))

等同於下面的SQL WHERE 子句：

WHERE name ="yuan" OR name="egon"

你可以組合& 和| 操作符以及使用括號進行分組來編寫任意復雜的Q 對象。同時，Q 對象可以使用~ 操作符取反，這允許組合正常的查詢和取反(NOT) 查詢：

bookList=Book.objects.filter(Q(authors__name="yuan")& ~Q(publishDate__year=2017)).values_list("title")

查詢函數可以混合使用Q 對象和關鍵字參數。所有提供給查詢函數的參數（關鍵字參數或Q 對象）都將"AND”在一起。但是，如果出現Q 對象，它必須位於所有關鍵字參數的前面。例如：

bookList=Book.objects.filter(Q(publishDate__year=2016) |Q(publishDate__year=2017),

title__icontains="python"

)

修改表記錄

註意：

<1> 第二種方式修改不能用get的原因是：update是QuerySet對象的方法，get返回的是一個model對象，它沒有update方法，而filter返回的是一個QuerySet對象(filter裏面的條件可能有多個條件符合，比如name＝‘alvin‘,可能有兩個name＝‘alvin‘的行數據)。

<2>在“插入和更新數據”小節中，我們有提到模型的save()方法，這個方法會更新一行裏的所有列。 而某些情況下，我們只需要更新行裏的某幾列。

此外，update()方法對於任何結果集（QuerySet）均有效，這意味著你可以同時更新多條記錄update()方法會返回一個整型數值，表示受影響的記錄條數。

註意，這裏因為update返回的是一個整形，所以沒法用query屬性；對於每次創建一個對象，想顯示對應的raw sql，需要在settings加上日誌記錄部分

刪除表記錄

刪除方法就是 delete()。它運行時立即刪除對象而不返回任何值。例如：

e.delete()

你也可以一次性刪除多個對象。每個QuerySet 都有一個 delete() 方法，它一次性刪除 QuerySet 中所有的對象。

例如，下面的代碼將刪除pub_date 是2005年的 Entry 對象：

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

要牢記這一點：無論在什麽情況下，QuerySet中的 delete() 方法都只使用一條 SQL 語句一次性刪除所有對象，而並不是分別刪除每個對象。如果你想使用在 model 中自定義的 delete() 方法，就要自行調用每個對象的delete 方法。(例如，遍歷 QuerySet，在每個對象上調用 delete()方法)，而不是使用 QuerySet 中的 delete()方法。

在 Django 刪除對象時，會模仿 SQL 約束 ON DELETE CASCADE 的行為，換句話說，刪除一個對象時也會刪除與它相關聯的外鍵對象。例如：

b = Blog.objects.get(pk=1)

# This will delete the Blog and all of itsEntry objects.

b.delete()

要註意的是： delete() 方法是 QuerySet 上的方法，但並不適用於 Manager 本身。這是一種保護機制，是為了避免意外地調用 Entry.objects.delete() 方法導致 所有的 記錄被誤刪除。如果你確認要刪除所有的對象，那麽你必須顯式地調用：

Entry.objects.all().delete()

本文出自 “lyndon” 博客，請務必保留此出處http://lyndon.blog.51cto.com/11474010/1982670

Django框架---model模型基礎