6月20日 Django中ORM介紹和字段、字段參數、相關操作
Object Relational Mapping(ORM)
ORM介紹
ORM概念
對象關系映射(Object Relational Mapping,簡稱ORM)模式是一種為了解決面向對象與關系數據庫存在的互不匹配的現象的技術。
簡單的說,ORM是通過使用描述對象和數據庫之間映射的元數據,將程序中的對象自動持久化到關系數據庫中。
ORM在業務邏輯層和數據庫層之間充當了橋梁的作用。
ORM由來
讓我們從O/R開始。字母O起源於"對象"(Object),而R則來自於"關系"(Relational)。
幾乎所有的軟件開發過程中都會涉及到對象和關系數據庫。在用戶層面和業務邏輯層面,我們是面向對象的。當對象的信息發生變化的時候,我們就需要把對象的信息保存在關系數據庫中。
按照之前的方式來進行開發就會出現程序員會在自己的業務邏輯代碼中夾雜很多SQL語句用來增加、讀取、修改、刪除相關數據,而這些代碼通常都是重復的。
ORM的優勢
ORM解決的主要問題是對象和關系的映射。它通常把一個類和一個表一一對應,類的每個實例對應表中的一條記錄,類的每個屬性對應表中的每個字段。
ORM提供了對數據庫的映射,不用直接編寫SQL代碼,只需像操作對象一樣從數據庫操作數據。
讓軟件開發人員專註於業務邏輯的處理,提高了開發效率。
ORM的劣勢
ORM的缺點是會在一定程度上犧牲程序的執行效率。
ORM用多了SQL語句就不會寫了,關系數據庫相關技能退化...
ORM總結
ORM只是一種工具,工具確實能解決一些重復,簡單的勞動。這是不可否認的。
但我們不能指望某個工具能一勞永逸地解決所有問題,一些特殊問題還是需要特殊處理的。
但是在整個軟件開發過程中需要特殊處理的情況應該都是很少的,否則所謂的工具也就失去了它存在的意義。
Django中的ORM
Django項目使用MySQL數據庫
1. 在Django項目的settings.py文件中,配置數據庫連接信息:
DATABASES = {
"default": {
"ENGINE": "django.db.backends.mysql",
"NAME": "你的數據庫名稱", # 需要自己手動創建數據庫
"USER": "數據庫用戶名",
"PASSWORD": "數據庫密碼",
"HOST": "數據庫IP",
"POST": 3306
}
}
2. 在Django項目的__init__.py文件中寫如下代碼,告訴Django使用pymysql模塊連接MySQL數據庫:
import pymysql
pymysql.install_as_MySQLdb()
Model
在Django中model是你數據的單一、明確的信息來源。它包含了你存儲的數據的重要字段和行為。通常,一個模型(model)映射到一個數據庫表,
基本情況:
- 每個模型都是一個Python類,它是django.db.models.Model的子類。
- 模型的每個屬性都代表一個數據庫字段。
- 綜上所述,Django為您提供了一個自動生成的數據庫訪問API,詳詢官方文檔鏈接。
快速入門
下面這個例子定義了一個 Person 模型,包含 first_name 和 last_name。
from django.db import models
class Person(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=30)
first_name 和 last_name 是模型的字段。每個字段被指定為一個類屬性,每個屬性映射到一個數據庫列。
上面的 Person 模型將會像這樣創建一個數據庫表:
CREATE TABLE myapp_person (
"id" serial NOT NULL PRIMARY KEY,
"first_name" varchar(30) NOT NULL,
"last_name" varchar(30) NOT NULL
);
一些說明:
- 表myapp_person的名稱是自動生成的,如果你要自定義表名,需要在model的Meta類中指定 db_table 參數,強烈建議使用小寫表名,特別是使用MySQL作為後端數據庫時。
- id字段是自動添加的,如果你想要指定自定義主鍵,只需在其中一個字段中指定 primary_key=True 即可。如果Django發現你已經明確地設置了Field.primary_key,它將不會添加自動ID列。
- 本示例中的CREATE TABLE SQL使用PostgreSQL語法進行格式化,但值得註意的是,Django會根據配置文件中指定的數據庫後端類型來生成相應的SQL語句。
- Django支持MySQL5.5及更高版本。
Django ORM 常用字段和參數
常用字段
AutoField
int自增列,必須填入參數 primary_key=True。當model中如果沒有自增列,則自動會創建一個列名為id的列。
IntegerField
一個整數類型,範圍在 -2147483648 to 2147483647。
CharField
字符類型,必須提供max_length參數, max_length表示字符長度。
DateField
日期字段,日期格式 YYYY-MM-DD,相當於Python中的datetime.date()實例。
DateTimeField
日期時間字段,格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ],相當於Python中的datetime.datetime()實例。
字段合集(爭取記憶)
AutoField(Field) - int自增列,必須填入參數 primary_key=True BigAutoField(AutoField) - bigint自增列,必須填入參數 primary_key=True 註:當model中如果沒有自增列,則自動會創建一個列名為id的列 from django.db import models class UserInfo(models.Model): # 自動創建一個列名為id的且為自增的整數列 username = models.CharField(max_length=32) class Group(models.Model): # 自定義自增列 nid = models.AutoField(primary_key=True) name = models.CharField(max_length=32) SmallIntegerField(IntegerField): - 小整數 -32768 ~ 32767 PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) - 正小整數 0 ~ 32767 IntegerField(Field) - 整數列(有符號的) -2147483648 ~ 2147483647 PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) - 正整數 0 ~ 2147483647 BigIntegerField(IntegerField): - 長整型(有符號的) -9223372036854775808 ~ 9223372036854775807 BooleanField(Field) - 布爾值類型 NullBooleanField(Field): - 可以為空的布爾值 CharField(Field) - 字符類型 - 必須提供max_length參數, max_length表示字符長度 TextField(Field) - 文本類型 EmailField(CharField): - 字符串類型,Django Admin以及ModelForm中提供驗證機制 IPAddressField(Field) - 字符串類型,Django Admin以及ModelForm中提供驗證 IPV4 機制 GenericIPAddressField(Field) - 字符串類型,Django Admin以及ModelForm中提供驗證 Ipv4和Ipv6 - 參數: protocol,用於指定Ipv4或Ipv6, ‘both‘,"ipv4","ipv6" unpack_ipv4, 如果指定為True,則輸入::ffff:192.0.2.1時候,可解析為192.0.2.1,開啟此功能,需要protocol="both" URLField(CharField) - 字符串類型,Django Admin以及ModelForm中提供驗證 URL SlugField(CharField) - 字符串類型,Django Admin以及ModelForm中提供驗證支持 字母、數字、下劃線、連接符(減號) CommaSeparatedIntegerField(CharField) - 字符串類型,格式必須為逗號分割的數字 UUIDField(Field) - 字符串類型,Django Admin以及ModelForm中提供對UUID格式的驗證 FilePathField(Field) - 字符串,Django Admin以及ModelForm中提供讀取文件夾下文件的功能 - 參數: path, 文件夾路徑 match=None, 正則匹配 recursive=False, 遞歸下面的文件夾 allow_files=True, 允許文件 allow_folders=False, 允許文件夾 FileField(Field) - 字符串,路徑保存在數據庫,文件上傳到指定目錄 - 參數: upload_to = "" 上傳文件的保存路徑 storage = None 存儲組件,默認django.core.files.storage.FileSystemStorage ImageField(FileField) - 字符串,路徑保存在數據庫,文件上傳到指定目錄 - 參數: upload_to = "" 上傳文件的保存路徑 storage = None 存儲組件,默認django.core.files.storage.FileSystemStorage width_field=None, 上傳圖片的高度保存的數據庫字段名(字符串) height_field=None 上傳圖片的寬度保存的數據庫字段名(字符串) DateTimeField(DateField) - 日期+時間格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ] DateField(DateTimeCheckMixin, Field) - 日期格式 YYYY-MM-DD TimeField(DateTimeCheckMixin, Field) - 時間格式 HH:MM[:ss[.uuuuuu]] DurationField(Field) - 長整數,時間間隔,數據庫中按照bigint存儲,ORM中獲取的值為datetime.timedelta類型 FloatField(Field) - 浮點型 DecimalField(Field) - 10進制小數 - 參數: max_digits,小數總長度 decimal_places,小數位長度 BinaryField(Field) - 二進制類型字段合集
自定義字段(了解為主)
class UnsignedIntegerField(models.IntegerField): def db_type(self, connection): return ‘integer UNSIGNED‘
自定義char類型字段:
class FixedCharField(models.Field):
"""
自定義的char類型的字段類
"""
def __init__(self, max_length, *args, **kwargs):
self.max_length = max_length
super(FixedCharField, self).__init__(max_length=max_length, *args, **kwargs)
def db_type(self, connection):
"""
限定生成數據庫表的字段類型為char,長度為max_length指定的值
"""
return ‘char(%s)‘ % self.max_length
class Class(models.Model):
id = models.AutoField(primary_key=True)
title = models.CharField(max_length=25)
# 使用自定義的char類型的字段
cname = FixedCharField(max_length=25)
創建的表結構:
附ORM字段與數據庫實際字段的對應關系
對應關系: ‘AutoField‘: ‘integer AUTO_INCREMENT‘, ‘BigAutoField‘: ‘bigint AUTO_INCREMENT‘, ‘BinaryField‘: ‘longblob‘, ‘BooleanField‘: ‘bool‘, ‘CharField‘: ‘varchar(%(max_length)s)‘, ‘CommaSeparatedIntegerField‘: ‘varchar(%(max_length)s)‘, ‘DateField‘: ‘date‘, ‘DateTimeField‘: ‘datetime‘, ‘DecimalField‘: ‘numeric(%(max_digits)s, %(decimal_places)s)‘, ‘DurationField‘: ‘bigint‘, ‘FileField‘: ‘varchar(%(max_length)s)‘, ‘FilePathField‘: ‘varchar(%(max_length)s)‘, ‘FloatField‘: ‘double precision‘, ‘IntegerField‘: ‘integer‘, ‘BigIntegerField‘: ‘bigint‘, ‘IPAddressField‘: ‘char(15)‘, ‘GenericIPAddressField‘: ‘char(39)‘, ‘NullBooleanField‘: ‘bool‘, ‘OneToOneField‘: ‘integer‘, ‘PositiveIntegerField‘: ‘integer UNSIGNED‘, ‘PositiveSmallIntegerField‘: ‘smallint UNSIGNED‘, ‘SlugField‘: ‘varchar(%(max_length)s)‘, ‘SmallIntegerField‘: ‘smallint‘, ‘TextField‘: ‘longtext‘, ‘TimeField‘: ‘time‘, ‘UUIDField‘: ‘char(32)‘,
字段參數
null
用於表示某個字段可以為空。
unique
如果設置為unique=True 則該字段在此表中必須是唯一的 。
db_index
如果db_index=True 則代表著為此字段設置索引。
default
為該字段設置默認值。
DateField和DateTimeField
auto_now_add
配置auto_now_add=True,創建數據記錄的時候會把當前時間添加到數據庫。
auto_now
配置上auto_now=True,每次更新數據記錄的時候會更新該字段。
DateField和DateTimeField才有的參數:
auto_now_add=True --> 創建數據的時候自動把當前時間賦值
auto_add=True --> 每次更新數據的時候更新當前時間
上述兩個不能同時設置!!!
關系字段
ForeignKey
外鍵類型在ORM中用來表示外鍵關聯關系,一般把ForeignKey字段設置在 ‘一對多‘中‘多‘的一方。
ForeignKey可以和其他表做關聯關系同時也可以和自身做關聯關系。
字段參數
to
設置要關聯的表
to_field
設置要關聯的表的字段
related_name
反向操作時,使用的字段名,用於代替原反向查詢時的‘表名_set‘。
例如:
class Classes(models.Model): name = models.CharField(max_length=32) class Student(models.Model): name = models.CharField(max_length=32) theclass = models.ForeignKey(to="Classes")
當我們要查詢某個班級關聯的所有學生(反向查詢)時,我們會這麽寫:
models.Classes.objects.first().student_set.all()
當我們在ForeignKey字段中添加了參數 related_name 後,
class Student(models.Model): name = models.CharField(max_length=32) theclass = models.ForeignKey(to="Classes", related_name="students")
當我們要查詢某個班級關聯的所有學生(反向查詢)時,我們會這麽寫:
models.Classes.objects.first().students.all()
related_query_name
反向查詢操作時,使用的連接前綴,用於替換表名。
on_delete
當刪除關聯表中的數據時,當前表與其關聯的行的行為。
models.CASCADE
刪除關聯數據,與之關聯也刪除
models.DO_NOTHING
刪除關聯數據,引發錯誤IntegrityError
models.PROTECT
刪除關聯數據,引發錯誤ProtectedError
models.SET_NULL
刪除關聯數據,與之關聯的值設置為null(前提FK字段需要設置為可空)
models.SET_DEFAULT
刪除關聯數據,與之關聯的值設置為默認值(前提FK字段需要設置默認值)
models.SET
刪除關聯數據,
a. 與之關聯的值設置為指定值,設置:models.SET(值)
b. 與之關聯的值設置為可執行對象的返回值,設置:models.SET(可執行對象)
def func(): return 10 class MyModel(models.Model): user = models.ForeignKey( to="User", to_field="id", on_delete=models.SET(func) )
db_constraint
是否在數據庫中創建外鍵約束,默認為True。
OneToOneField
一對一字段。
通常一對一字段用來擴展已有字段。
字段參數
to
設置要關聯的表。
to_field
設置要關聯的字段。
on_delete
同ForeignKey字段。
ManyToManyField
用於表示多對多的關聯關系。在數據庫中通過第三張表來建立關聯關系。
字段參數
to
設置要關聯的表
related_name
同ForeignKey字段。
related_query_name
同ForeignKey字段。
symmetrical
僅用於多對多自關聯時,指定內部是否創建反向操作的字段。默認為True。
舉個例子:
class Person(models.Model): name = models.CharField(max_length=16) friends = models.ManyToManyField("self")
此時,person對象就沒有person_set屬性。
class Person(models.Model): name = models.CharField(max_length=16) friends = models.ManyToManyField("self", symmetrical=False)
此時,person對象現在就可以使用person_set屬性進行反向查詢。
through
在使用ManyToManyField字段時,Django將自動生成一張表來管理多對多的關聯關系。
但我們也可以手動創建第三張表來管理多對多關系,此時就需要通過through來指定第三張表的表名。
through_fields
設置關聯的字段。
db_table
默認創建第三張表時,數據庫中表的名稱。
元信息
ORM對應的類裏面包含另一個Meta類,而Meta類封裝了一些數據庫的信息。主要字段如下:
db_table
ORM在數據庫中的表名默認是 app_類名,可以通過db_table可以重寫表名。
index_together
聯合索引。
unique_together
聯合唯一索引。
ordering
指定默認按什麽字段排序。
只有設置了該屬性,我們查詢到的結果才可以被reverse()。
有三中創建多對多關系的方式:
第一種 :直接使用ManyToManyField 創建關聯關系
第二種: 自己創建第三張表
第三種: 在自己創建第三張表的同時,設置 ManyToManyField 建立對應關系
使用如下:
# 第三種創建多對多的方式 class Book(models.Model): title = models.CharField(max_length=32) class Author(models.Model): name = models.CharField(max_length=32) # books = `models.ManyToManyField( to="Book", through="Book2Author", through_fields=(‘author‘, ‘book‘) ) # 自己創建第三張表 class Book2Author(models.Model): id = models.AutoField(primary_key=True) book = models.ForeignKey(to=Book) author = models.ForeignKey(to=Author) first_blood = models.DateField()
Django ORM那些相關操作
一般操作
看專業的官網文檔,做專業的程序員!
必知必會13條
<1> all(): 查詢所有結果 <2> filter(**kwargs): 它包含了與所給篩選條件相匹配的對象 <3> get(**kwargs): 返回與所給篩選條件相匹配的對象,返回結果有且只有一個,如果符合篩選條件的對象超過一個或者沒有都會拋出錯誤。 <4> exclude(**kwargs): 它包含了與所給篩選條件不匹配的對象 <5> values(*field): 返回一個ValueQuerySet——一個特殊的QuerySet,運行後得到的並不是一系列model的實例化對象,而是一個可叠代的字典序列 <6> values_list(*field): 它與values()非常相似,它返回的是一個元組序列,values返回的是一個字典序列 <7> order_by(*field): 對查詢結果排序 <8> reverse(): 對查詢結果反向排序,請註意reverse()通常只能在具有已定義順序的QuerySet上調用(在model類的Meta中指定ordering或調用order_by()方法)。 <9> distinct(): 從返回結果中剔除重復紀錄(如果你查詢跨越多個表,可能在計算QuerySet時得到重復的結果。此時可以使用distinct(),註意只有在PostgreSQL中支持按字段去重。) <10> count(): 返回數據庫中匹配查詢(QuerySet)的對象數量。 <11> first(): 返回第一條記錄 <12> last(): 返回最後一條記錄 <13> exists(): 如果QuerySet包含數據,就返回True,否則返回False
返回QuerySet對象的方法有
all()
filter()
exclude()
order_by()
reverse()
distinct()
特殊的QuerySet
values() 返回一個可叠代的字典序列
values_list() 返回一個可叠代的元祖序列
返回具體對象的
get()
first()
last()
返回布爾值的方法有:
exists()
返回數字的方法有
count()
單表查詢之神奇的雙下劃線
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") # 獲取name字段包含"ven"的 models.Tb1.objects.filter(name__icontains="ven") # icontains大小寫不敏感 models.Tb1.objects.filter(id__range=[1, 3]) # id範圍是1到3的,等價於SQL的bettwen and 類似的還有:startswith,istartswith, endswith, iendswith date字段還可以: models.Class.objects.filter(first_day__year=2017)
ForeignKey操作
正向查找
對象查找(跨表)
語法:
對象.關聯字段.字段
示例:
book_obj = models.Book.objects.first() # 第一本書對象 print(book_obj.publisher) # 得到這本書關聯的出版社對象 print(book_obj.publisher.name) # 得到出版社對象的名稱
字段查找(跨表)
語法:
關聯字段__字段
示例:
print(models.Book.objects.values_list("publisher__name"))
反向操作
對象查找
語法:
obj.表名_set
示例:
publisher_obj = models.Publisher.objects.first() # 找到第一個出版社對象 books = publisher_obj.book_set.all() # 找到第一個出版社出版的所有書 titles = books.values_list("title") # 找到第一個出版社出版的所有書的書名
字段查找
語法:
表名__字段
示例:
titles = models.Publisher.objects.values_list("book__title")
6月20日 Django中ORM介紹和字段、字段參數、相關操作