Django 常用欄位和引數

Yven發表於2018-11-14
Django

一.ORM欄位

型別 說明
AutoField 一個自動增加的整數型別欄位。通常你不需要自己編寫它，Django會自動幫你新增欄位：`id = models.AutoField(primary_key=True)`，這是一個自增欄位，從1開始計數。如果你非要自己設定主鍵，那麼請務必將欄位設定為`primary_key=True。Django在一個模型中只允許有一個自增欄位，並且該欄位必須為主鍵！ | | BigAutoField | (1.10新增)64位整數型別自增欄位，數字範圍更大，從1到9223372036854775807 | | BigIntegerField | 64位整數字段（看清楚，非自增），類似IntegerField ，-9223372036854775808 到9223372036854775807。在Django的模板表單裡體現為一個textinput標籤。 | | BinaryField | 二進位制資料型別。使用受限，少用。 | | **BooleanField** | 布林值型別。預設值是None。在HTML表單中體現為CheckboxInput標籤。如果要接收null值，請使用NullBooleanField。 | | **CharField** | 字串型別。必須接收一個max_length引數，表示字串長度不能超過該值。預設的表單標籤是input text。最常用的filed，沒有之一！ | | CommaSeparatedIntegerField | 逗號分隔的整數型別。必須接收一個max_length引數。常用於表示較大的金額數目，例如1,000,000元。 | | **DateField** | class DateField(auto_now=False, auto_now_add=False, options)`日期型別。一個Python中的datetime.date的例項。在HTML中表現為TextInput標籤。在admin後臺中，Django會幫你自動新增一個JS的日曆表和一個“Today”快捷方式，以及附加的日期合法性驗證。兩個重要引數：（引數互斥，不能共存）`auto_now`:每當物件被儲存時將欄位設為當前日期，常用於儲存最後修改時間。`auto_now_add`：每當物件被建立時，設為當前日期，常用於儲存建立日期(注意，它是不可修改的)。設定上面兩個引數就相當於給field新增了`editable=False`和`blank=True`屬性。如果想具有修改屬性，請用default引數。例子：`pub_time = models.DateField(auto_now_add=True)，自動新增發布時間。 | | DateTimeField | 日期時間型別。Python的datetime.datetime的例項。與DateField相比就是多了小時、分和秒的顯示，其它功能、引數、用法、預設值等等都一樣。 | | DecimalField | 固定精度的十進位制小數。相當於Python的Decimal例項，必須提供兩個指定的引數！引數max_digits`：最大的位數，必須大於或等於小數點位數 。`decimal_places`：小數點位數，精度。 當`localize=False`時，它在HTML表現為NumberInput標籤，否則是text型別。例子：儲存最大不超過999，帶有2位小數位精度的數，定義如下：`models.DecimalField(…, max_digits=5, decimal_places=2)。 | | DurationField | 持續時間型別。儲存一定期間的時間長度。類似Python中的timedelta。在不同的資料庫實現中有不同的表示方法。常用於進行時間之間的加減運算。但是小心了，這裡有坑，PostgreSQL等資料庫之間有相容性問題！ | | **EmailField** | 郵箱型別，預設max_length最大長度254位。使用這個欄位的好處是，可以使用DJango內建的EmailValidator進行郵箱地址合法性驗證。 | | **FileField** | class FileField(upload_to=None, max_length=100, options)上傳檔案型別，後面單獨介紹。 | | FilePathField | 檔案路徑型別，後面單獨介紹 | | FloatField | 浮點數型別，參考整數型別 | | **ImageField** | 影像型別，後面單獨介紹。 | | **IntegerField** | 整數型別，最常用的欄位之一。取值範圍-2147483648到2147483647。在HTML中表現為NumberInput標籤。 | | **GenericIPAddressField** | class GenericIPAddressField(protocol=`both`, unpack_ipv4=False, **options)[source]`,IPV4或者IPV6地址，字串形式，例如`192.0.2.30或者2a02:42fe::4`在HTML中表現為TextInput標籤。引數`protocol預設值為‘both’，可選‘IPv4’或者‘IPv6’，表示你的IP地址型別。 | | NullBooleanField | 類似布林欄位，只不過額外允許NULL`作為選項之一。
PositiveIntegerField 正整數字段，包含0,最大2147483647。
PositiveSmallIntegerField 較小的正整數字段，從0到32767。
SlugField slug是一個新聞行業的術語。一個slug就是一個某種東西的簡短標籤，包含字母、數字、下劃線或者連線線，通常用於URLs中。可以設定max_length引數，預設為50。
SmallIntegerField 小整數，包含-32768到32767。
TextField 大量文字內容，在HTML中表現為Textarea標籤，最常用的欄位型別之一！如果你為它設定一個max_length引數，那麼在前端頁面中會受到輸入字元數量限制，然而在模型和資料庫層面卻不受影響。只有CharField才能同時作用於兩者。
TimeField 時間欄位，Python中datetime.time的例項。接收同DateField一樣的引數，只作用於小時、分和秒。
URLField 一個用於儲存URL地址的字串型別，預設最大長度200。
UUIDField 用於儲存通用唯一識別碼（Universally Unique Identifier）的欄位。使用Python的UUID類。在PostgreSQL資料庫中儲存為uuid型別，其它資料庫中為char(32)。這個欄位是自增主鍵的最佳替代品，後面有例子展示。

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

二.ORM欄位引數

null:用於表示某個欄位可以為空
unique:如果設定為unique=True 則該欄位在此表中必須是唯一的
db_index:如果db_index=True則代表著為此欄位設定索引
default:為該欄位設定預設值

DateField和DateTimeField

auto_now_add:配置auto_now_add=True,建立資料記錄的適合會把當前時間新增到資料庫
auto_now:配置auto_now=True,每次更新資料記錄的時候會更新該欄位

三.關係型欄位

1.一對多(ForeignKey)

外來鍵型別在ORM中用來表示外來鍵關聯關係,一般把ForeignKey欄位設定在一對多關係中`多`的那一方。

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

引數:

to:設定要關聯的表
to_field:設定要關聯的表的欄位
related_name:反向操作時,使用的欄位名,用於代替反向查詢時的"表名_set"
related_query_name:反向查詢操作時,使用的連線字首,用於替換表名
on_delete:當刪除關聯表中的資料時,當前表與其關聯的行為
    引數值:
    models.CASCADE:表示刪除關聯資料,與之關聯也刪除
    models.DO_NOTHING:表示刪除關聯資料,什麼也不做
    models.PROTECT:刪除關聯資料,引發錯誤ProtectedError
    models.SET_DEFAULT:將外來鍵欄位設為預設值,只有當欄位設定了預設值,才能使用
    models.SET_NULL:將外來鍵欄位設為null,只有當欄位設定了null=True時,才能使用
db_constraint:是否在資料庫中建立外來鍵約束,預設為True

2.一對一(OneToOneField)

一對一關係非常類似具有unique=True屬性的外來鍵關係,但是反向關聯物件只有一個,這種關係型別多數用於當一個模型需要從別的模型擴充套件而來的情況.

該關係的第一位置引數為關聯的模型,用法和前面的一對多類似

to:設定要關聯的表
to_field:設定要關聯的表的欄位
on_delete:同ForeignKey

3.多對多(ManyToManyField)

多對多關係在資料庫中也是非常常見的關係型別,多對多的欄位可以定義在任何一方.

to:設定要關聯的表
related_name:同ForeignKey
related_query_name:同ForeignKey
symmetrical:僅用於多對多自關聯時,指定內部是否建立反向操作的欄位,預設為True
through:在使用ManyToManyField欄位時,Django將自動生成一張表來管理多對多的關聯關係,但我們也可以手動建立第三張表來管理多對多關係,此時就需要通過through來指定第三張表的表名
through_fields:設定關聯的欄位
db_table:預設建立第三張表時,資料庫中表的名稱

四.元資訊

ORM對應的類裡面包含另一個Meta類,而Meta類封裝了一些資料庫的資訊,主要欄位有:
db_table:ORM在資料庫中的表名預設是app_類名,可以通過db_table來設定
index_together:聯合索引
unique_together:聯合唯一索引
ordering:指定預設按什麼欄位排序

相關文章