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:指定默認按什么字段排序