一.ORM欄位 | 類型 | 說明 | | | | | AutoField | 一個自動增加的整數類型欄位。通常你不需要自己編寫它,Django會自動幫你添加欄位:\ ,這是一個自增欄位,從1開始計數。如果你非要自己設置主鍵,那麼請務必將欄位設置為\ 。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:指定預設按什麼欄位排序