ORM簡介
MTC或者MVC框架中包括一個重要的部分，就是ORM，它實現了資料模型與資料庫的解耦，即資料模型的設計不需要依賴於特定的資料庫，通過簡單的配置就可以輕鬆更換資料庫，這極大的減輕了開發人員的工作量，不需要面對因資料庫變更而導致的無效勞動
ORM是“物件-關係-對映”的簡稱。
我們先來了解一下ORM扮演了一個什麼角色，如上圖，我們知道mysql是一個能夠操作db/磁碟上資料的軟體，python中想要操作磁碟資料時，它想到藉助mysql，但又不能直接操作mysql，所以有了pymysql這個模組，通過它可以幫我們去執行sql語句，從而去運算元據庫，但是有一點不好就是用pymysql還要我們去寫sql語句，這對於一個python程式設計師來說就有點為難了，我們瞭解的是python語法，於是在pymysql之上又有了ORM，我們可以通過熟悉的python中類和物件去運算元據庫。
#sql中的表 #建立表: CREATE TABLE employee( id INT PRIMARY KEY auto_increment , name VARCHAR (20), gender BIT default 1, birthday DATA , department VARCHAR (20), salary DECIMAL (8,2) unsigned, ); #sql中的表紀錄 #新增一條表紀錄: INSERT employee (name,gender,birthday,salary,department) VALUES ("alex",1,"1985-12-12",8000,"保潔部"); #查詢一條表紀錄: SELECT * FROM employee WHERE age=24; #更新一條表紀錄: UPDATE employee SET birthday="1989-10-24" WHERE id=1; #刪除一條表紀錄: DELETE FROM employee WHERE name="alex" #python的類 class Employee(models.Model): id=models.AutoField(primary_key=True) name=models.CharField(max_length=32) gender=models.BooleanField() birthday=models.DateField() department=models.CharField(max_length=32) salary=models.DecimalField(max_digits=8,decimal_places=2) #python的類物件 #新增一條表紀錄: emp=Employee(name="alex",gender=True,birthday="1985-12-12",epartment="保潔部") emp.save() #查詢一條表紀錄: Employee.objects.filter(age=24) #更新一條表紀錄: Employee.objects.filter(id=1).update(birthday="1989-10-24") #刪除一條表紀錄: Employee.objects.filter(name="alex").delete()
單表操作
建立表
1 建立模型
建立名為book的app，在book下的models.py中建立模型：
from django.db import models # Create your models here. class Book(models.Model): id=models.AutoField(primary_key=True) title=models.CharField(max_length=32) state=models.BooleanField() pub_date=models.DateField() price=models.DecimalField(max_digits=8,decimal_places=2) publish=models.CharField(max_length=32)
每個欄位有一些特有的引數，例如，CharField需要max_length引數來指定VARCHAR資料庫欄位的大小。還有一些適用於所有欄位的通用引數。 這些引數在文件中有詳細定義，這裡我們只簡單介紹一些最常用的：
更多欄位：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
'''<1> CharField 字串欄位, 用於較短的字串. CharField 要求必須有一個引數 maxlength, 用於從資料庫層和Django校驗層限制該欄位所允許的最大字元數.<2> IntegerField #用於儲存一個整數.<3> FloatField 一個浮點數. 必須 提供兩個引數: 引數 描述 max_digits 總位數(不包括小數點和符號) decimal_places 小數位數 舉例來說, 要儲存最大值為 999 (小數點後儲存2位),你要這樣定義欄位: models.FloatField(..., max_digits=5, decimal_places=2) 要儲存最大值一百萬(小數點後儲存10位)的話,你要這樣定義: models.FloatField(..., max_digits=19, decimal_places=10) admin 用一個文字框(<input type="text">)表示該欄位儲存的資料.<4> AutoField 一個 IntegerField, 新增記錄時它會自動增長. 你通常不需要直接使用這個欄位; 自定義一個主鍵：my_id=models.AutoField(primary_key=True) 如果你不指定主鍵的話,系統會自動新增一個主鍵欄位到你的 model.<5> BooleanField A true/false field. admin 用 checkbox 來表示此類欄位.<6> TextField 一個容量很大的文字欄位. admin 用一個 <textarea> (文字區域)表示該欄位資料.(一個多行編輯框).<7> EmailField 一個帶有檢查Email合法性的 CharField,不接受 maxlength 引數.<8> DateField 一個日期欄位. 共有下列額外的可選引數: Argument 描述 auto_now 當物件被儲存時,自動將該欄位的值設定為當前時間.通常用於表示 "last-modified" 時間戳. auto_now_add 當物件首次被建立時,自動將該欄位的值設定為當前時間.通常用於表示物件建立時間. （僅僅在admin中有意義...)<9> DateTimeField 一個日期時間欄位. 類似 DateField 支援同樣的附加選項.<10> ImageField 類似 FileField, 不過要校驗上傳物件是否是一個合法圖片.#它有兩個可選引數:height_field和width_field, 如果提供這兩個引數,則圖片將按提供的高度和寬度規格儲存. <11> FileField 一個檔案上傳欄位. 要求一個必須有的引數: upload_to, 一個用於儲存上載檔案的本地檔案系統路徑. 這個路徑必須包含 strftime #formatting, 該格式將被上載檔案的 date/time 替換(so that uploaded files don't fill up the given directory). admin 用一個<input type="file">部件表示該欄位儲存的資料(一個檔案上傳部件) . 注意：在一個 model 中使用 FileField 或 ImageField 需要以下步驟: （1）在你的 settings 檔案中, 定義一個完整路徑給 MEDIA_ROOT 以便讓 Django在此處儲存上傳檔案. (出於效能考慮,這些檔案並不儲存到資料庫.) 定義MEDIA_URL 作為該目錄的公共 URL. 要確保該目錄對 WEB伺服器使用者帳號是可寫的. （2） 在你的 model 中新增 FileField 或 ImageField, 並確保定義了 upload_to 選項,以告訴 Django 使用 MEDIA_ROOT 的哪個子目錄儲存上傳檔案.你的資料庫中要儲存的只是檔案的路徑(相對於 MEDIA_ROOT). 出於習慣你一定很想使用 Django 提供的 get_<#fieldname>_url 函式.舉例來說,如果你的 ImageField 叫作 mug_shot, 你就可以在模板中以 {{ object.#get_mug_shot_url }} 這樣的方式得到影象的絕對路徑.<12> URLField 用於儲存 URL. 若 verify_exists 引數為 True (預設), 給定的 URL 會預先檢查是否存在( 即URL是否被有效裝入且 沒有返回404響應). admin 用一個 <input type="text"> 文字框表示該欄位儲存的資料(一個單行編輯框)<13> NullBooleanField 類似 BooleanField, 不過允許 NULL 作為其中一個選項. 推薦使用這個欄位而不要用 BooleanField 加 null=True 選項 admin 用一個選擇框 <select> (三個可選擇的值: "Unknown", "Yes" 和 "No" ) 來表示這種欄位資料.<14> SlugField "Slug" 是一個報紙術語. slug 是某個東西的小小標記(短籤), 只包含字母,數字,下劃線和連字元.#它們通常用於URLs 若你使用 Django 開發版本,你可以指定 maxlength. 若 maxlength 未指定, Django 會使用預設長度: 50. #在 以前的 Django 版本,沒有任何辦法改變50 這個長度. 這暗示了 db_index=True. 它接受一個額外的引數: prepopulate_from, which is a list of fields from which to auto-#populate the slug, via JavaScript,in the object's admin form: models.SlugField (prepopulate_from=("pre_name", "name"))prepopulate_from 不接受 DateTimeFields.<13> XMLField 一個校驗值是否為合法XML的 TextField,必須提供引數: schema_path, 它是一個用來校驗文字的 RelaxNG schema #的檔案系統路徑.<14> FilePathField 可選專案為某個特定目錄下的檔名. 支援三個特殊的引數, 其中第一個是必須提供的. 引數 描述 path 必需引數. 一個目錄的絕對檔案系統路徑. FilePathField 據此得到可選專案. Example: "/home/images". match 可選引數. 一個正規表示式, 作為一個字串, FilePathField 將使用它過濾檔名. 注意這個正規表示式只會應用到 base filename 而不是 路徑全名. Example: "foo.*\.txt^", 將匹配檔案 foo23.txt 卻不匹配 bar.txt 或 foo23.gif. recursive可選引數.要麼 True 要麼 False. 預設值是 False. 是否包括 path 下面的全部子目錄. 這三個引數可以同時使用. match 僅應用於 base filename, 而不是路徑全名. 那麼,這個例子: FilePathField(path="/home/images", match="foo.*", recursive=True) ...會匹配 /home/images/foo.gif 而不匹配 /home/images/foo/bar.gif<15> IPAddressField 一個字串形式的 IP 地址, (i.e. "24.124.1.30").<16> CommaSeparatedIntegerField 用於存放逗號分隔的整數值. 類似 CharField, 必須要有maxlength引數.''' |
更多引數：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
(1)null如果為True，Django 將用NULL 來在資料庫中儲存空值。 預設值是 False.(1)blank如果為True，該欄位允許不填。預設為False。要注意，這與 null 不同。null純粹是資料庫範疇的，而 blank 是資料驗證範疇的。如果一個欄位的blank=True，表單的驗證將允許該欄位是空值。如果欄位的blank=False，該欄位就是必填的。(2)default欄位的預設值。可以是一個值或者可呼叫物件。如果可呼叫 ，每有新物件被建立它都會被呼叫。(3)primary_key如果為True，那麼這個欄位就是模型的主鍵。如果你沒有指定任何一個欄位的primary_key=True，Django 就會自動新增一個IntegerField欄位做為主鍵，所以除非你想覆蓋預設的主鍵行為，否則沒必要設定任何一個欄位的primary_key=True。(4)unique如果該值設定為 True, 這個資料欄位的值在整張表中必須是唯一的(5)choices由二元組組成的一個可迭代物件（例如，列表或元組），用來給欄位提供選擇項。 如果設定了choices ，預設的表單將是一個選擇框而不是標準的文字框，<br>而且這個選擇框的選項就是choices 中的選項。 |
3 settings配置
若想將模型轉為mysql資料庫中的表，需要在settings中配置：
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME':'bms', # 要連線的資料庫，連線前需要建立好
'USER':'root', # 連線資料庫的使用者名稱
'PASSWORD':'', # 連線資料庫的密碼
'HOST':'127.0.0.1', # 連線主機，預設本級
'PORT'：3306 # 埠 預設3306
}
}
注意1：NAME即資料庫的名字，在mysql連線前該資料庫必須已經建立，而上面的sqlite資料庫下的db.sqlite3則是專案自動建立 USER和PASSWORD分別是資料庫的使用者名稱和密碼。設定完後，再啟動我們的Django專案前，我們需要啟用我們的mysql。然後，啟動專案，會報錯：no module named MySQLdb 。這是因為django預設你匯入的驅動是MySQLdb，可是MySQLdb 對於py3有很大問題，所以我們需要的驅動是PyMySQL 所以，我們只需要找到專案名檔案下的__init__,在裡面寫入：
|
1
2
|
import pymysqlpymysql.install_as_MySQLdb() |
最後通過兩條資料庫遷移命令即可在指定的資料庫中建立表 ：
|
1
2
|
python manage.py makemigrationspython manage.py migrate |
注意2:確保配置檔案中的INSTALLED_APPS中寫入我們建立的app名稱
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', "book" ]
注意3:如果報錯如下：
|
1
|
django.core.exceptions.ImproperlyConfigured: mysqlclient 1.3.3 or newer is required; you have 0.7.11.None |
MySQLclient目前只支援到python3.4，因此如果使用的更高版本的python，需要修改如下：
通過查詢路徑C:\Programs\Python\Python36-32\Lib\site-packages\Django-2.0-py3.6.egg\django\db\backends\mysql
這個路徑裡的檔案把
|
1
2
|
if version < (1, 3, 3): raise ImproperlyConfigured("mysqlclient 1.3.3 or newer is required; you have %s" % Database.__version__) |
註釋掉 就OK了。
注意4: 如果想列印orm轉換過程中的sql，需要在settings中進行如下配置：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
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
|
1
2
|
# create方法的返回值book_obj就是插入book表中的python葵花寶典這本書籍紀錄物件 book_obj=Book.objects.create(title="python葵花寶典",state=True,price=100,publish="蘋果出版社",pub_date="2012-12-12") |
方式2
|
1
2
|
book_obj=Book(title="python葵花寶典",state=True,price=100,publish="蘋果出版社",pub_date="2012-12-12")book_obj.save() |
查詢表紀錄
查詢API
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
<1> all(): 查詢所有結果 <2> filter(**kwargs): 它包含了與所給篩選條件相匹配的物件 <3> get(**kwargs): 返回與所給篩選條件相匹配的物件，返回結果有且只有一個， 如果符合篩選條件的物件超過一個或者沒有都會丟擲錯誤。 <4> exclude(**kwargs): 它包含了與所給篩選條件不匹配的物件<5> order_by(*field): 對查詢結果排序 <6> reverse(): 對查詢結果反向排序 <8> count(): 返回資料庫中匹配查詢(QuerySet)的物件數量。 <9> first(): 返回第一條記錄 <10> last(): 返回最後一條記錄 <11> exists(): 如果QuerySet包含資料，就返回True，否則返回False<12> values(*field): 返回一個ValueQuerySet——一個特殊的QuerySet，執行後得到的並不是一系列 model的例項化物件，而是一個可迭代的字典序列<13> values_list(*field): 它與values()非常相似，它返回的是一個元組序列，values返回的是一個字典序列<14> distinct(): 從返回結果中剔除重複紀錄 |
基於雙下劃線的模糊查詢
|
1
2
3
4
5
6
7
8
|
Book.objects.filter(price__in=[100,200,300])Book.objects.filter(price__gt=100)Book.objects.filter(price__lt=100)Book.objects.filter(price__range=[100,200])Book.objects.filter(title__contains="python")Book.objects.filter(title__icontains="python")Book.objects.filter(title__startswith="py")Book.objects.filter(pub_date__year=2012) |
刪除表記錄
刪除方法就是 delete()。它執行時立即刪除物件而不返回任何值。例如：
|
1
|
model_obj.delete() |
你也可以一次性刪除多個物件。每個 QuerySet 都有一個 delete() 方法，它一次性刪除 QuerySet 中所有的物件。
例如，下面的程式碼將刪除 pub_date 是2005年的 Entry 物件：
|
1
|
Entry.objects.filter(pub_date__year=2005).delete() |
在 Django 刪除物件時，會模仿 SQL 約束 ON DELETE CASCADE 的行為，換句話說，刪除一個物件時也會刪除與它相關聯的外來鍵物件。例如：
|
1
2
3
|
b = Blog.objects.get(pk=1)# This will delete the Blog and all of its Entry objects.b.delete() |
要注意的是： delete() 方法是 QuerySet 上的方法，但並不適用於 Manager 本身。這是一種保護機制，是為了避免意外地呼叫 Entry.objects.delete() 方法導致 所有的 記錄被誤刪除。如果你確認要刪除所有的物件，那麼你必須顯式地呼叫：
|
1
|
Entry.objects.all().delete() |
如果不想級聯刪除，可以設定為:
|
1
|
pubHouse = models.ForeignKey(to='Publisher', on_delete=models.SET_NULL, blank=True, null=True) |
修改表記錄
|
1
|
Book.objects.filter(title__startswith="py").update(price=120) |
此外，update()方法對於任何結果集（QuerySet）均有效，這意味著你可以同時更新多條記錄update()方法會返回一個整型數值，表示受影響的記錄條數。