常用字段

AutoFiled：int自增列，必須填入?yún)?shù) primary_key=True.當(dāng)model中如果沒有自增列妖碉，則會(huì)自動(dòng)創(chuàng)建一個(gè)列名為id的列涌庭。

IntegerField：一個(gè)整數(shù)類型，范圍在 -2147483648 to 2147483647欧宜。

CharField：字符類型坐榆，必須提供max_length參數(shù)， max_length表示字符長(zhǎng)度鱼鸠。

DateField：日期字段猛拴，日期格式 YYYY-MM-DD，相當(dāng)于Python中的datetime.date()實(shí)例蚀狰。

DateTimeField：日期時(shí)間字段愉昆，格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]，相當(dāng)于Python中的datetime.datetime()實(shí)例麻蹋。

字段合集

AutoField(Field)
        - int自增列跛溉，必須填入?yún)?shù) primary_key=True

   BigAutoField(AutoField)
        - bigint自增列，必須填入?yún)?shù) primary_key=True

        注：當(dāng)model中如果沒有自增列扮授，則自動(dòng)會(huì)創(chuàng)建一個(gè)列名為id的列
        from django.db import models

        class UserInfo(models.Model):
            # 自動(dòng)創(chuàng)建一個(gè)列名為id的且為自增的整數(shù)列
            username = models.CharField(max_length=32)

        class Group(models.Model):
            # 自定義自增列
            nid = models.AutoField(primary_key=True)
            name = models.CharField(max_length=32)

    SmallIntegerField(IntegerField):
        - 小整數(shù) -32768 ～ 32767

    PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正小整數(shù) 0 ～ 32767
    IntegerField(Field)
        - 整數(shù)列(有符號(hào)的) -2147483648 ～ 2147483647

    PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正整數(shù) 0 ～ 2147483647

    BigIntegerField(IntegerField):
        - 長(zhǎng)整型(有符號(hào)的) -9223372036854775808 ～ 9223372036854775807

    BooleanField(Field)
        - 布爾值類型

    NullBooleanField(Field):
        - 可以為空的布爾值

    CharField(Field)
        - 字符類型
        - 必須提供max_length參數(shù)芳室， max_length表示字符長(zhǎng)度

    TextField(Field)
        - 文本類型

    EmailField(CharField)：
        - 字符串類型，Django Admin以及ModelForm中提供驗(yàn)證機(jī)制

    IPAddressField(Field)
        - 字符串類型刹勃，Django Admin以及ModelForm中提供驗(yàn)證 IPV4 機(jī)制

    GenericIPAddressField(Field)
        - 字符串類型堪侯，Django Admin以及ModelForm中提供驗(yàn)證 Ipv4和Ipv6
        - 參數(shù)：
            protocol，用于指定Ipv4或Ipv6荔仁， 'both',"ipv4","ipv6"
            unpack_ipv4伍宦， 如果指定為True芽死，則輸入::ffff:192.0.2.1時(shí)候，可解析為192.0.2.1次洼，開啟此功能关贵，需要protocol="both"

    URLField(CharField)
        - 字符串類型，Django Admin以及ModelForm中提供驗(yàn)證 URL

    SlugField(CharField)
        - 字符串類型卖毁，Django Admin以及ModelForm中提供驗(yàn)證支持 字母揖曾、數(shù)字、下劃線亥啦、連接符（減號(hào)）

    CommaSeparatedIntegerField(CharField)
        - 字符串類型炭剪，格式必須為逗號(hào)分割的數(shù)字

    UUIDField(Field)
        - 字符串類型，Django Admin以及ModelForm中提供對(duì)UUID格式的驗(yàn)證

    FilePathField(Field)
        - 字符串禁悠，Django Admin以及ModelForm中提供讀取文件夾下文件的功能
        - 參數(shù)：
                path,                      文件夾路徑
                match=None,                正則匹配
                recursive=False,           遞歸下面的文件夾
                allow_files=True,          允許文件
                allow_folders=False,       允許文件夾

    FileField(Field)
        - 字符串念祭，路徑保存在數(shù)據(jù)庫(kù)，文件上傳到指定目錄
        - 參數(shù)：
            upload_to = ""      上傳文件的保存路徑
            storage = None      存儲(chǔ)組件碍侦，默認(rèn)django.core.files.storage.FileSystemStorage

    ImageField(FileField)
        - 字符串粱坤，路徑保存在數(shù)據(jù)庫(kù)，文件上傳到指定目錄
        - 參數(shù)：
            upload_to = ""      上傳文件的保存路徑
            storage = None      存儲(chǔ)組件瓷产，默認(rèn)django.core.files.storage.FileSystemStorage
            width_field=None,   上傳圖片的高度保存的數(shù)據(jù)庫(kù)字段名（字符串）
            height_field=None   上傳圖片的寬度保存的數(shù)據(jù)庫(kù)字段名（字符串）

    DateTimeField(DateField)
        - 日期+時(shí)間格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]

    DateField(DateTimeCheckMixin, Field)
        - 日期格式      YYYY-MM-DD

    TimeField(DateTimeCheckMixin, Field)
        - 時(shí)間格式      HH:MM[:ss[.uuuuuu]]

    DurationField(Field)
        - 長(zhǎng)整數(shù)站玄，時(shí)間間隔，數(shù)據(jù)庫(kù)中按照bigint存儲(chǔ)濒旦，ORM中獲取的值為datetime.timedelta類型

    FloatField(Field)
        - 浮點(diǎn)型

    DecimalField(Field)
        - 10進(jìn)制小數(shù)
        - 參數(shù)：
            max_digits株旷，小數(shù)總長(zhǎng)度
            decimal_places，小數(shù)位長(zhǎng)度

    BinaryField(Field)
        - 二進(jìn)制類型

自定義字段

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):
        super().__init__(max_length=max_length, *args, **kwargs)
        self.length = max_length

    def db_type(self, connection):
        """
        限定生成數(shù)據(jù)庫(kù)表的字段類型為char尔邓，長(zhǎng)度為length指定的值
        """
        return 'char(%s)' % self.length


class Class(models.Model):
    id = models.AutoField(primary_key=True)
    title = models.CharField(max_length=25)
    # 使用上面自定義的char類型的字段
    cname = FixedCharField(max_length=25)

創(chuàng)建的表結(jié)構(gòu)：

2.png

附ORM字段與數(shù)據(jù)庫(kù)實(shí)際字段的對(duì)應(yīng)關(guān)系

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

字段參數(shù)

null：用于表示某個(gè)字段可以為空

unique：如果設(shè)置為unique=True 則該字段在此表中必須是唯一的晾剖。

db_index：如果db_index=True 則代表著為此字段設(shè)置數(shù)據(jù)庫(kù)索引。

default：為該字段設(shè)置默認(rèn)值梯嗽。

時(shí)間字段獨(dú)有的屬性

DatetimeField齿尽、DateField、TimeField這個(gè)三個(gè)時(shí)間字段灯节，都可以設(shè)置如下屬性循头。

auto_now_add：配置auto_now_add=True，創(chuàng)建數(shù)據(jù)記錄的時(shí)候會(huì)把當(dāng)前時(shí)間添加到數(shù)據(jù)庫(kù)炎疆。

auto_now：配置上auto_now=True卡骂，每次更新數(shù)據(jù)記錄的時(shí)候會(huì)更新該字段。

關(guān)系字段

ForeignKey：外鍵類型在ORM中用來(lái)表示外鍵關(guān)聯(lián)關(guān)系形入，一般把ForeignKey字段設(shè)置在 '一對(duì)多'中'多'的一方全跨。

ForeignKey可以和其他表做關(guān)聯(lián)關(guān)系同時(shí)也可以和自身做關(guān)聯(lián)關(guān)系。

字段參數(shù)

to：設(shè)置要關(guān)聯(lián)的表

to_field：設(shè)置要關(guān)聯(lián)的字段

related_name：反向操作室亿遂，使用的字段名浓若，用于代替原反向查詢時(shí)的“表名_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")

當(dāng)我們要查詢某個(gè)班級(jí)關(guān)聯(lián)的學(xué)生的（反向查詢）時(shí)候盒使，我們會(huì)這么寫：

models.Classes.objects.first().student_set.all()

當(dāng)我們?cè)贔oreignKey字段中添加了參數(shù)related_name后，

class Student(models.Model):
    name = models.CharField(max_length=32)
    theclass = models.ForeignKey(to="Classes", related_name="students")

此時(shí)七嫌，當(dāng)我們要查詢某個(gè)班級(jí)關(guān)聯(lián)的所有學(xué)生（反向查詢）時(shí)，我們會(huì)這么寫：

models.Classes.objects.first().students.all()

related_query_name：反向查詢操作室苞慢，使用的連接前綴诵原，用于替換表名。

on_delete：當(dāng)刪除關(guān)聯(lián)表中的數(shù)據(jù)時(shí)挽放，當(dāng)前表與其關(guān)聯(lián)的行的行為绍赛。

models.CASCADE
刪除關(guān)聯(lián)數(shù)據(jù)，與之關(guān)聯(lián)也刪除

models.DO_NOTHING
刪除關(guān)聯(lián)數(shù)據(jù)辑畦，引發(fā)錯(cuò)誤IntegrityError

models.PROTECT
刪除關(guān)聯(lián)數(shù)據(jù)吗蚌，引發(fā)錯(cuò)誤ProtectedError

models.SET_NULL
刪除關(guān)聯(lián)數(shù)據(jù)，與之關(guān)聯(lián)的值設(shè)置為null（前提FK字段需要設(shè)置為可空）

models.SET_DEFAULT
刪除關(guān)聯(lián)數(shù)據(jù)纯出，與之關(guān)聯(lián)的值設(shè)置為默認(rèn)值（前提FK字段需要設(shè)置默認(rèn)值）

models.SET

刪除關(guān)聯(lián)數(shù)據(jù)蚯妇，
a. 與之關(guān)聯(lián)的值設(shè)置為指定值，設(shè)置：models.SET(值)
b. 與之關(guān)聯(lián)的值設(shè)置為可執(zhí)行對(duì)象的返回值暂筝，設(shè)置：models.SET(可執(zhí)行對(duì)象)

def func():
    return 10

class MyModel(models.Model):
    user = models.ForeignKey(
        to="User",
        to_field="id"箩言，
        on_delete=models.SET(func)
    )

db_constraint：是否在數(shù)據(jù)庫(kù)中創(chuàng)建外鍵約束，默認(rèn)為True

OneToOneField

一對(duì)一字段
通常一對(duì)一字段用來(lái)擴(kuò)展已有字段焕襟。

一對(duì)一的關(guān)聯(lián)關(guān)系多用在當(dāng)一張表的不同字段查詢頻次差距過(guò)大的情況下陨收，將本可以存儲(chǔ)在一張表的字段拆開放置在兩張表中，然后將兩張表建立一對(duì)一的關(guān)聯(lián)關(guān)系鸵赖。

class Author(models.Model):
    name = models.CharField(max_length=32)
    info = models.OneToOneField(to='AuthorInfo')
    

class AuthorInfo(models.Model):
    phone = models.CharField(max_length=11)
    email = models.EmailField()

字段參數(shù)

to：設(shè)置要關(guān)聯(lián)的表
to_field：設(shè)置關(guān)聯(lián)字段
on_deleted：當(dāng)刪除關(guān)聯(lián)表中的數(shù)據(jù)時(shí)务漩，當(dāng)前表與其關(guān)聯(lián)的行的行為。

ManyTOManyField

用于表示多對(duì)多的關(guān)聯(lián)關(guān)系它褪。在數(shù)據(jù)庫(kù)中通過(guò)第三張表來(lái)建立關(guān)聯(lián)管理饵骨。

字段參數(shù)

to：設(shè)置要關(guān)聯(lián)的表
related_name：反向操作時(shí)，使用的字段名列赎，用于代替原反向查詢時(shí)的'表名_set'宏悦。
related_query_name：反向查詢操作時(shí)，使用的連接前綴包吝，用于替換表名饼煞。
symmetrical：僅用于多對(duì)多自關(guān)聯(lián)時(shí)，制定內(nèi)部是否穿那個(gè)鍵反向操作的字段诗越。默認(rèn)為True砖瞧。
舉個(gè)例子：

class Person(models.Model):
    name = models.CharField(max_length=16)
    friends = models.ManyToManyField("self")

此時(shí)，person對(duì)象就沒有person_set屬性嚷狞。

class Person(models.Model):
    name = models.CharField(max_length=16)
    friends = models.ManyToManyField("self", symmetrical=False)

此時(shí)块促，person對(duì)象現(xiàn)在就可以使用person_set屬性進(jìn)行反向查詢荣堰。

through：在使用ManyToManyField字段時(shí)，Django將自動(dòng)生成一張表來(lái)管理多對(duì)多的關(guān)聯(lián)關(guān)系竭翠。但我們也可以手動(dòng)創(chuàng)建第三張表來(lái)管理多對(duì)多關(guān)系振坚，此時(shí)就需要通過(guò)through來(lái)指定第三張表的表名。
through_fields：設(shè)置關(guān)聯(lián)的字段
db_table：默認(rèn)創(chuàng)建第三張表時(shí)斋扰，數(shù)據(jù)庫(kù)中表的名字渡八。

多對(duì)多的三種關(guān)聯(lián)關(guān)系方式

方式一：自行創(chuàng)建第三張表

class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="書名")


class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")


# 自己創(chuàng)建第三張表，分別通過(guò)外鍵關(guān)聯(lián)書和作者
class Author2Book(models.Model):
    author = models.ForeignKey(to="Author")
    book = models.ForeignKey(to="Book")

    class Meta:
        unique_together = ("author", "book")

方式二：通過(guò)ManyTOManyField自動(dòng)創(chuàng)建第三張表

class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="書名")


# 通過(guò)ORM自帶的ManyToManyField自動(dòng)創(chuàng)建第三張表
class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")
    books = models.ManyToManyField(to="Book", related_name="authors")

方式三：設(shè)置ManyToManyField并指定自行創(chuàng)關(guān)鍵的第三張表

class Book(models.Model):
    title = models.CharField(max_length=32, verbose_name="書名")


# 自己創(chuàng)建第三張表传货，并通過(guò)ManyToManyField指定關(guān)聯(lián)
class Author(models.Model):
    name = models.CharField(max_length=32, verbose_name="作者姓名")
    books = models.ManyToManyField(to="Book", through="Author2Book", through_fields=("author", "book"))
    # through_fields接受一個(gè)2元組（'field1'屎鳍，'field2'）：
    # 其中field1是定義ManyToManyField的模型外鍵的名（author），field2是關(guān)聯(lián)目標(biāo)模型（book）的外鍵名问裕。


class Author2Book(models.Model):
    author = models.ForeignKey(to="Author")
    book = models.ForeignKey(to="Book")

    class Meta:
        unique_together = ("author", "book")

注意：

當(dāng)我們需要在第三張關(guān)系表中存儲(chǔ)額外的字段時(shí)逮壁，就要使用第三種方式。

但是當(dāng)我們使用第三種方式創(chuàng)建多對(duì)多關(guān)聯(lián)關(guān)系時(shí)粮宛，就無(wú)法使用set窥淆、add、remove巍杈、clear方法來(lái)管理多對(duì)多的關(guān)系了祖乳，需要通過(guò)第三張表的model來(lái)管理多對(duì)多關(guān)系。

元信息

ORM對(duì)應(yīng)的類里面包含了另一個(gè)Meta類秉氧，而Meta類封裝了一些數(shù)據(jù)庫(kù)的信息眷昆。主要字段如下：

db_table：ORM在數(shù)據(jù)庫(kù)中的表名默認(rèn)是app_類名，可以通過(guò)db_table重寫表名汁咏。
index_together：聯(lián)合索引
unique_together：聯(lián)合唯一索引
ordering：指定默認(rèn)按什么字段排序亚斋。只有設(shè)置了改屬性，我們查詢到的結(jié)果才可以被reverse()攘滩。