django-ORM

一些說明：

• 表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表示字符長度。

這里需要知道的是Django中的CharField對應的MySQL數據庫中的varchar類型，沒有設置對應char類型的字段，但是Django允許我們自定義新的字段，下面我來自定義對應於數據庫的char類型

自定義字段在實際項目應用中可能會經常用到，這里需要對他留個印象！

from django.db import models

# Create your models here.
#Django中沒有對應的char類型字段，但是我們可以自己創建
class FixCharField(models.Field):
    '''
    自定義的char類型的字段類
    '''
    def __init__(self,max_length,*args,**kwargs):
        self.max_length=max_length
        super().__init__(max_length=max_length,*args,**kwargs)

    def db_type(self, connection):
        '''
        限定生成的數據庫表字段類型char，長度為max_length指定的值
        :param connection:
        :return:
        '''
        return 'char(%s)'%self.max_length
#應用上面自定義的char類型
class Class(models.Model):
    id=models.AutoField(primary_key=True)
    title=models.CharField(max_length=32)
    class_name=FixCharField(max_length=16)
    gender_choice=((1,'男'),(2,'女'),(3,'保密'))
    gender=models.SmallIntegerField(choices=gender_choice,default=3)

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)
        - 二進制類型

對應關系：
    '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，每次更新數據記錄的時候會更新該字段。

關系字段

ForeignKey

外鍵類型在ORM中用來表示外鍵關聯關系，一般把ForeignKey字段設置在 '一對多'中'多'的一方。

ForeignKey可以和其他表做關聯關系同時也可以和自身做關聯關系。

字段參數

to

設置要關聯的表

to_field

設置要關聯的表的字段

on_delete

當刪除關聯表中的數據時，當前表與其關聯的行的行為。

models.CASCADE

刪除關聯數據，與之關聯也刪除

db_constraint

是否在數據庫中創建外鍵約束，默認為True。

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)
    )

OneToOneField

一對一字段。

通常一對一字段用來擴展已有字段。(通俗的說就是一個人的所有信息不是放在一張表里面的，簡單的信息一張表，隱私的信息另一張表，之間通過一對一外鍵關聯)

字段參數

to

設置要關聯的表。

to_field

設置要關聯的字段。

on_delete

當刪除關聯表中的數據時，當前表與其關聯的行的行為。(參考上面的例子)

一般操作

在進行一般操作時先配置一下參數，使得我們可以直接在Django頁面中運行我們的測試腳本

在Python腳本中調用Django環境

 

這樣就可以直接運行你的test.py文件來運行測試

必知必會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

13個必會操作總結

返回QuerySet對象的方法有

all()

filter()

exclude()

order_by()

reverse()

distinct()

特殊的QuerySet

values()       返回一個可迭代的字典序列

values_list() 返回一個可迭代的元祖序列

返回具體對象的

get()

first()

last()

返回布爾值的方法有：

exists()

返回數字的方法有

count()

Django終端打印SQL語句

如果你想知道你對數據庫進行操作時，Django內部到底是怎么執行它的sql語句時可以加下面的配置來查看

在Django項目的settings.py文件中，在最后復制粘貼如下代碼：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console':{
            'level':'DEBUG',
            'class':'logging.StreamHandler',
        },
    },
    'loggers': {
        'django.db.backends': {
            'handlers': ['console'],
            'propagate': True,
            'level':'DEBUG',
        },
    }
}

配置好之后，再執行任何對數據庫進行操作的語句時，會自動將Django執行的sql語句打印到pycharm終端上

補充：

除了配置外，還可以通過一點.query即可查看查詢語句，具體操作如下：

單表查詢之神奇的雙下划線

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)
date字段可以通過在其后加__year,__month,__day等來獲取date的特點部分數據
# date
        #
        # Entry.objects.filter(pub_date__date=datetime.date(2005, 1, 1))
        # Entry.objects.filter(pub_date__date__gt=datetime.date(2005, 1, 1))

        # year
        #
        # Entry.objects.filter(pub_date__year=2005)
        # Entry.objects.filter(pub_date__year__gte=2005)

        # month
        #
        # Entry.objects.filter(pub_date__month=12)
        # Entry.objects.filter(pub_date__month__gte=6)

        # day
        #
        # Entry.objects.filter(pub_date__day=3)
        # Entry.objects.filter(pub_date__day__gte=3)

        # week_day
        #
        # Entry.objects.filter(pub_date__week_day=2)
        # Entry.objects.filter(pub_date__week_day__gte=2)
需要注意的是在表示一年的時間的時候，我們通常用52周來表示，因為天數是不確定的，老外就是按周來計算薪資的哦~

ForeignKey操作

正向查找(兩種方式)

1.對象查找（跨表）

語法：

對象.關聯字段.字段

要點:先拿到對象，再通過對象去查對應的外鍵字段，分兩步

示例：

book_obj = models.Book.objects.first()  # 第一本書對象(第一步)
print(book_obj.publisher)  # 得到這本書關聯的出版社對象
print(book_obj.publisher.name)  # 得到出版社對象的名稱

2.字段查找（跨表）

語法：

關聯字段__字段

要點:利用Django給我們提供的神奇的雙下划線查找方式

示例：

models.Book.objects.all().values("publisher__name")
#拿到所有數據對應的出版社的名字，神奇的下划線幫我們誇表查詢

反向操作(兩種方式)

1.對象查找

語法：

obj.表名_set

要點:先拿到外鍵關聯多對一，一中的某個對象，由於外鍵字段設置在多的一方，所以這里還是借用Django提供的雙下划線來查找

示例：

publisher_obj = models.Publisher.objects.first()  # 找到第一個出版社對象
books = publisher_obj.book_set.all()  # 找到第一個出版社出版的所有書
titles = books.values_list("title")  # 找到第一個出版社出版的所有書的書名

結論:如果想通過一的那一方去查找多的一方，由於外鍵字段不在一這一方，所以用__set來查找即可

2.字段查找

語法：

表名__字段

要點:直接利用雙下滑線完成誇表操作

titles = models.Publisher.objects.values("book__title")

ManyToManyField

class RelatedManager

"關聯管理器"是在一對多或者多對多的關聯上下文中使用的管理器。

它存在於下面兩種情況：

1. 外鍵關系的反向查詢
2. 多對多關聯關系

簡單來說就是在多對多表關系並且這一張多對多的關系表是有Django自動幫你建的情況下，下面的方法才可使用。

方法

create()

創建一個關聯對象，並自動寫入數據庫，且在第三張雙方的關聯表中自動新建上雙方對應關系。

models.Author.objects.first().book_set.create(title="偷塔秘籍")
上面這一句干了哪些事兒:
1.由作者表中的一個對象跨到書籍比表
2.新增名為偷塔秘籍的書籍並保存
3.到作者與書籍的第三張表中新增兩者之間的多對多關系並保存

add()

把指定的model對象添加到第三張關聯表中。

添加對象

>>> author_objs = models.Author.objects.filter(id__lt=3)
>>> models.Book.objects.first().authors.add(*author_objs)

添加id

>>> models.Book.objects.first().authors.add(*[1, 2])

set()

更新某個對象在第三張表中的關聯對象。不同於上面的add是添加,set相當於重置

>>> book_obj = models.Book.objects.first()
>>> book_obj.authors.set([2, 3])

remove()

從關聯對象集中移除執行的model對象(移除對象在第三張表中與某個關聯對象的關系)

>>> book_obj = models.Book.objects.first()
>>> book_obj.authors.remove(3)

clear()

從關聯對象集中移除一切對象。(移除所有與對象相關的關系信息)

>>> book_obj = models.Book.objects.first()
>>> book_obj.authors.clear()

注意：

對於ForeignKey對象，clear()和remove()方法僅在null=True時存在。

舉個例子：

ForeignKey字段沒設置null=True時，

class Book(models.Model):
    title = models.CharField(max_length=32)
    publisher = models.ForeignKey(to=Publisher)

沒有clear()和remove()方法：

>>> models.Publisher.objects.first().book_set.clear()
Traceback (most recent call last):
  File "<input>", line 1, in <module>
AttributeError: 'RelatedManager' object has no attribute 'clear'

當ForeignKey字段設置null=True時，

class Book(models.Model):
    name = models.CharField(max_length=32)
    publisher = models.ForeignKey(to=Class, null=True)

此時就有clear()和remove()方法：

>>> models.Publisher.objects.first().book_set.clear()

再次強調：

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

聚合查詢和分組查詢

聚合(利用聚合函數)

aggregate()是QuerySet 的一個終止子句，意思是說，它返回一個包含一些鍵值對的字典。

鍵的名稱是聚合值的標識符，值是計算出來的聚合值。鍵的名稱是按照字段和聚合函數的名稱自動生成出來的。

用到的內置函數：

from django.db.models import Avg, Sum, Max, Min, Count

示例：

>>> from django.db.models import Avg, Sum, Max, Min, Count
>>> models.Book.objects.all().aggregate(Avg("price"))
{'price__avg': 13.233333}

如果你想要為聚合值指定一個名稱，可以向聚合子句提供它。

>>> models.Book.objects.aggregate(average_price=Avg('price'))
{'average_price': 13.233333}

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

>>> models.Book.objects.all().aggregate(Avg("price"), Max("price"), Min("price"))
{'price__avg': 13.233333, 'price__max': Decimal('19.90'), 'price__min': Decimal('9.90')}

分組

我們在這里先復習一下SQL語句的分組。

假設現在有一張公司職員表：

 我們使用原生SQL語句，按照部分分組求平均工資：

select dept,AVG(salary) from employee group by dept;

ORM查詢:

from django.db.models import Avg
Employee.objects.values("dept").annotate(avg=Avg("salary").values(dept, "avg")
這里需要注意的是annotate分組依據就是他前面的值，
如果前面沒有特點的字段，則默認按照ID分組，
這里有dept字段，所以按照dept字段分組

連表查詢的分組：

SQL查詢：

select dept.name,AVG(salary) from employee inner join dept on (employee.dept_id=dept.id) group by dept_id;

ORM查詢：

from django.db.models import Avg
models.Dept.objects.annotate(avg=Avg("employee__salary")).values("name", "avg")

更多示例：

示例1：統計每一本書的作者個數

>>> book_list = models.Book.objects.all().annotate(author_num=Count("author"))
>>> for obj in book_list:
...     print(obj.author_num)
...
1

示例2：統計出每個出版社買的最便宜的書的價格

>>> publisher_list = models.Publisher.objects.annotate(min_price=Min("book__price"))
>>> for obj in publisher_list:
...     print(obj.min_price)
...     
9.90
19.90

方法二：

>>> models.Book.objects.values("publisher__name").annotate(min_price=Min("price"))
<QuerySet [{'publisher__name': '沙河出版社', 'min_price': Decimal('9.90')}, {'publisher__name': '人民出版社', 'min_price': Decimal('19.90')}]>

示例3：統計不止一個作者的圖書

>>> models.Book.objects.annotate(author_num=Count("author")).filter(author_num__gt=1)
<QuerySet [<Book: 番茄物語>]>

示例4：根據一本圖書作者數量的多少對查詢集 QuerySet進行排序

>>> models.Book.objects.annotate(author_num=Count("author")).order_by("author_num")
<QuerySet [<Book: 香蕉物語>, <Book: 橘子物語>, <Book: 番茄物語>]>

示例5：查詢各個作者出的書的總價格

>>> models.Author.objects.annotate(sum_price=Sum("book__price")).values("name", "sum_price")
<QuerySet [{'name': '小精靈', 'sum_price': Decimal('9.90')}, {'name': '小仙女', 'sum_price': Decimal('29.80')}, {'name': '小魔女', 'sum_price': Decimal('9.90')}]>

 總結

value里面的參數對應的是sql語句中的select要查找顯示的字段，

filter里面的參數相當於where或者having里面的篩選條件

annotate本身表示group by的作用，前面找尋分組依據，內部放置顯示可能用到的聚合運算式，后面跟filter來增加限制條件，最后的value來表示分組后想要查找的字段值