python-django 模型model字段类型说明

ゝ一世哀愁。 2021-11-26 11:10 339阅读 0赞

# [python-django 模型model字段类型说明][python-django _model] #

**V=models.CharField(max\_length=None<, \*\*options>)　　　　\#varchar**

**V=models.EmailField(<max\_length=75, \*\*options="">)　　　　\#varchar**

**V=models.URLField(<verify\_exists=true, \*\*options="" max\_length="200,">)　　　　\#varchar**

**V=models.FileField(upload\_to=None<, max\_length=100, \*\*options>)　　　　\#varchar \#upload\_to指定保存目录可带格式，**

**V=models.ImageField(upload\_to=None<, height\_field=None, width\_field=None, max\_length=100, \*\*options>)**

**V=models.IPAddressField(<\*\*options>)　　　　\#varchar**

**V=models.FilePathField(path=None<, match=None, recursive=False, max\_length=100, \*\*options>)　\#varchar**

**V=models.SlugField(<max\_length=50, \*\*options="">)　　　　\#varchar，标签，内含索引**

**V=models.CommaSeparatedIntegerField(max\_length=None<, \*\*options>)　　　　\#varchar**

**V=models.IntegerField(<\*\*options>)　　　　\#int**

**V=models.PositiveIntegerField(<\*\*options>)　　　　\#int 正整数**

**V=models.SmallIntegerField(<\*\*options>)　　　　\#smallint**

**V=models.PositiveSmallIntegerField(<\*\*options>)　　　　\#smallint 正整数**

** **

**V=models.AutoField(\*\*options)　　　　\#int；在Django代码内是自增**

**V=models.DecimalField(max\_digits=None, decimal\_places=None<, \*\*options>)　　　　\#decimal**

**V=models.FloatField(<\*\*options>)　　　　\#real V=models.BooleanField(\*\*options)　　　　\#boolean或bit**

**V=models.NullBooleanField(<\*\*options>)　　　　\#bit字段上可以设置上null值**

**V=models.DateField(<auto\_now=false, \*\*options="" auto\_now\_add="False,">)　　\#date \#auto\_now最后修改记录的日期；auto\_now\_add添加记录的日期**

**V=models.DateTimeField(<auto\_now=false, \*\*options="" auto\_now\_add="False,">)　　　　\#datetime**

**V=models.TimeField(<auto\_now=false, \*\*options="" auto\_now\_add="False,">)　　　　\#time**

**V=models.TextField(<\*\*options>)　　　　\#text**

**V=models.XMLField(schema\_path=None<, \*\*options>)　　　　\#text ——————————————————————————–**

**V=models.ForeignKey(othermodel<, \*\*options>)　　　　\#外键，关联其它模型，创建关联索引**

**V=models.ManyToManyField(othermodel<, \*\*options>)　　　　\#多对多，关联其它模型，创建关联表**

**V=models.OneToOneField(othermodel<, parent\_link=False, \*\*options>)　　　　\#一对一，字段关联表属性**

** **

**django 中model 作为数据资源指定了字段以及一些处理该相应的功能。通常情况下，每个model对应数据库中的一张表 每个model都是从django.core.meta.Model中派生出来的model中每个属性(class attribute)对应着数据库表中的一个字段非字段信息(Model metadata)在类中被称作METAField Objects每个class attributes对应着数据库中的一个字段，其应该是由meta.Filed的派生的。**

**from django.core import metaclass Person(meta.Model):    first\_name = meta.CharField(maxlength=30)    last\_name = meta.CharFiled("lastname",maxlength=30) 除了 ForeignKey, ManytoManyFiled OneToOneField 使用verbose\_name关键字以外，第一个可选参数是用来为字段命名的，如果不设置，系统会自动为起起名。sites = meta.ManyToManyField(site,verbose\_name="list of sites")**

**Field 选项**

**null     null 缺省设置为false.通常不将其用于字符型字段上，比如CharField,TextField上.字符型字段如果没有值会返回空字符串。**

**blank    该字段是否可以为空。如果为假，则必须有值**

**choices    一个用来选择值的2维元组。第一个值是实际存储的值，第二个用来方便进行选择。    SEX\_CHOICES= (('F','Female'),('M','Male'),) coredb\_columndb\_index    如果为真将为此字段创建索引**

**default    缺省值**

**editable    如果为假，admin模式下将不能改写。缺省为真**

**help\_text    admin模式下帮助文档**

**primary\_key    设置主键。如果没有设置django创建表时会自动加上    id = meta.AutoField('ID', primary\_key=True)    primary\_key=True implies blank=False, null=False and unique=True. Only one primary key is allowed on an object. radio\_admin    用于admin模式下将select转换为radio显示。只用于ForeignKey或者设置了choices**

**unique    数据唯一**

**unique\_for\_date    title =  meta.CharField(maxlength=30,unique\_for\_date='pub\_date')    系统将不允许title和pub\_date两个都相同的数据重复出现 unique\_for\_month / unique\_for\_year**

**validator\_list    有效性检查。非有效产生 django.core.validators.ValidationError 错误**

**Field Types**

**AutoField     自动增长的整型字段。通常无需自己添加**

**BooleanFieldCharField    对于大量文字应该使用TextField。参数： maxlength**

**DateField    参数：**

**auto\_now  自动设置为对象保存时刻的时间。对于类似最后改动之类的应用很有效   **

**auto\_now\_add  从最初保存对象至今的增量时间**

**DateTimeField 同上EmailField     检查是否为email的CharField字段**

**FileField    保存文件的相对路径名称    绝对路径需要在setting中设置 MEDIA\_ROOT。对于ImageField设置 MEDIA\_URL。    参数upload\_to.相对于MEDIA\_ROOT目录的子目录    通过get\_<fieldname>\_url获取绝对路径**

**FilePathField    通过给定参数获取文件列表（个人感觉）    path 必须要有。 文件系统的绝对路径    match 可选。一个正则表达式。用来做文件筛选过滤    recursive 可选。True 包含子目录查找    FilePathField(path="/home/images", match="foo.\*" , recursive=True)**

**FloatField    浮点数字段。两个必须选项    max\_digits 数字最多位数    decimal\_places 小数点位置    meta.FloatField(...,max\_digits=5,decimal\_places=2)   /100.00 ImageField   **

**基本上同FileField.会进行文件格式检查。两个额外选项    height\_field, width\_field 如果设置这两项，会自动对图片进行缩放后再保存   **

**需要 [python][] Imaging library**

**IntegerFieldIPAddressField   **

**"10.1.1.3" NullBooleanField   **

**比BooleanField多了一个NULL状态 PhoneNumberField   **

**美国格式电话号码 xxx-xxx-xxxx. CharField PositiveIntegerField   **

**正整数 PositiveSmallIntegerField    一个小的正整数。根据数据库的设置 SlugField    小片断。**

**什么都可以。通常用来存url    SlugField 被暗指 maxlength=50 db\_index=True   **

**选项： prepopulate\_from 一个用来自动生成slug的字段列表 SmallIntegerFieldTextField TimeField   **

**选项： auto-population(可能不对) from DateField and DateTimeField URLField   **

**选项： verify\_exists  如果为True ，系统自动检查该url是否存在不为404 USStateField   **

**两字符美国州简写 XMLField    保存xml数据。   **

**选项：schema\_path .指定relaxNG格式schema用来检验xml合法性**

** **

**字段列表纵览表**

** **

<table> 
 <tbody> 
 <tr> 
 <td> 字段名 </td> 
 <td> 参数 </td> 
 <td> 意义 </td> 
 </tr> 
 <tr> 
 <td> AutoField&nbsp; </td> 
 <td>&nbsp;</td> 
 <td> 一个能够根据可用ID自增的&nbsp;IntegerField&nbsp; </td> 
 </tr> 
 <tr> 
 <td> BooleanField </td> 
 <td>&nbsp;</td> 
 <td> 一个真／假（true/false）字段 </td> 
 </tr> 
 <tr> 
 <td> CharField </td> 
 <td> &nbsp;(max_length) </td> 
 <td> 一个字符串字段，适用于中小长度的字符串。对于长段的文字，请使用&nbsp;TextField </td> 
 </tr> 
 <tr> 
 <td> CommaSeparatedIntegerField </td> 
 <td> &nbsp;(max_length) </td> 
 <td> 一个用逗号分隔开的整数字段 </td> 
 </tr> 
 <tr> 
 <td> DateField </td> 
 <td> ([auto_now],&nbsp;[auto_now_add]) </td> 
 <td> 日期字段 </td> 
 </tr> 
 <tr> 
 <td> DateTimeField </td> 
 <td>&nbsp;</td> 
 <td> 时间日期字段,接受跟&nbsp;DateField&nbsp;一样的额外选项 </td> 
 </tr> 
 <tr> 
 <td> EmailField </td> 
 <td>&nbsp;</td> 
 <td> 一个能检查值是否是有效的电子邮件地址的&nbsp;CharField&nbsp; </td> 
 </tr> 
 <tr> 
 <td> FileField&nbsp; </td> 
 <td> (upload_to) </td> 
 <td> 一个文件上传字段 </td> 
 </tr> 
 <tr> 
 <td> FilePathField </td> 
 <td> (path,[match],[recursive]) </td> 
 <td> 一个拥有若干可选项的字段，选项被限定为文件系统中某个目录下的文件名 </td> 
 </tr> 
 <tr> 
 <td> FloatField </td> 
 <td> (max_digits,decimal_places) </td> 
 <td> 一个浮点数，对应Python中的&nbsp;float&nbsp;实例 </td> 
 </tr> 
 <tr> 
 <td> ImageField </td> 
 <td> (upload_to,&nbsp;[height_field]&nbsp;,[width_field]) </td> 
 <td> 像&nbsp;FileField&nbsp;一样，只不过要验证上传的对象是一个有效的图片。 </td> 
 </tr> 
 <tr> 
 <td> IntegerField </td> 
 <td>&nbsp;</td> 
 <td> 一个整数。 </td> 
 </tr> 
 <tr> 
 <td> IPAddressField </td> 
 <td>&nbsp;</td> 
 <td> 一个IP地址，以字符串格式表示（例如：&nbsp;"24.124.1.30"&nbsp;）。 </td> 
 </tr> 
 <tr> 
 <td> NullBooleanField </td> 
 <td>&nbsp;</td> 
 <td> 就像一个&nbsp;BooleanField&nbsp;，但它支持&nbsp;None&nbsp;/Null&nbsp;。 </td> 
 </tr> 
 <tr> 
 <td> PhoneNumberField&nbsp; </td> 
 <td>&nbsp;</td> 
 <td> 它是一个&nbsp;CharField&nbsp;，并且会检查值是否是一个合法的美式电话格式 </td> 
 </tr> 
 <tr> 
 <td> PositiveIntegerField&nbsp; </td> 
 <td>&nbsp;</td> 
 <td> 和&nbsp;IntegerField&nbsp;类似，但必须是正值。 </td> 
 </tr> 
 <tr> 
 <td> PositiveSmallIntegerField&nbsp; </td> 
 <td>&nbsp;</td> 
 <td> 与&nbsp;PositiveIntegerField&nbsp;类似，但只允许小于一定值的值,最大值取决于数据库. </td> 
 </tr> 
 <tr> 
 <td> SlugField </td> 
 <td>&nbsp;</td> 
 <td> &nbsp;嵌条&nbsp;就是一段内容的简短标签，这段内容只能包含字母、数字、下 划线或连字符。通常用于URL中 </td> 
 </tr> 
 <tr> 
 <td> SmallIntegerField </td> 
 <td>&nbsp;</td> 
 <td> 和&nbsp;IntegerField&nbsp;类似，但是只允许在一个数据库相关的范围内的数值（通常是-32,768到 +32,767） </td> 
 </tr> 
 <tr> 
 <td> TextField </td> 
 <td>&nbsp;</td> 
 <td> 一个不限长度的文字字段 </td> 
 </tr> 
 <tr> 
 <td> TimeField&nbsp; </td> 
 <td>&nbsp;</td> 
 <td> 时分秒的时间显示。它接受的可指定参数与&nbsp;DateField&nbsp;和&nbsp;DateTimeField&nbsp;相同。 </td> 
 </tr> 
 <tr> 
 <td> URLField </td> 
 <td>&nbsp;</td> 
 <td> 用来存储URL的字段。 </td> 
 </tr> 
 <tr> 
 <td> USStateField </td> 
 <td>&nbsp;</td> 
 <td> 美国州名称缩写，两个字母。 </td> 
 </tr> 
 <tr> 
 <td> XMLField&nbsp; </td> 
 <td> (schema_path) </td> 
 <td> 它就是一个&nbsp;TextField&nbsp;，只不过要检查值是匹配指定schema的合法XML。 </td> 
 </tr> 
 </tbody> 
</table>

** **

**通用字段参数列表（所有的字段类型都可以使用下面的参数，所有的都是可选的。）**

** **

<table> 
 <tbody> 
 <tr> 
 <td> 参数名 </td> 
 <td> 意义 </td> 
 </tr> 
 <tr> 
 <td> null&nbsp; </td> 
 <td> 如果设置为&nbsp;True&nbsp;的话，Django将在数据库中存储空值为&nbsp;NULL&nbsp;。默认为&nbsp;False&nbsp;。&nbsp; </td> 
 </tr> 
 <tr> 
 <td> blank&nbsp; </td> 
 <td> 如果是&nbsp;True&nbsp;，该字段允许留空，默认为&nbsp;False&nbsp;。 </td> 
 </tr> 
 <tr> 
 <td> choices </td> 
 <td> 一个包含双元素元组的可迭代的对象，用于给字段提供选项。 </td> 
 </tr> 
 <tr> 
 <td> db_column </td> 
 <td> 当前字段在数据库中对应的列的名字。 </td> 
 </tr> 
 <tr> 
 <td> db_index </td> 
 <td> 如果为&nbsp;True&nbsp;，Django会在创建表格（比如运行&nbsp;manage.py&nbsp;syncdb&nbsp;）时对这一列创建数据库索引。 </td> 
 </tr> 
 <tr> 
 <td> default </td> 
 <td> 字段的默认值 </td> 
 </tr> 
 <tr> 
 <td> editable&nbsp; </td> 
 <td> 如果为&nbsp;False&nbsp;，这个字段在管理界面或表单里将不能编辑。默认为&nbsp;True&nbsp;。 </td> 
 </tr> 
 <tr> 
 <td> help_text&nbsp; </td> 
 <td> 在管理界面表单对象里显示在字段下面的额外帮助文本。 </td> 
 </tr> 
 <tr> 
 <td> primary_key </td> 
 <td> 如果为&nbsp;True&nbsp;，这个字段就会成为模型的主键。 </td> 
 </tr> 
 <tr> 
 <td> radio_admin&nbsp; </td> 
 <td> 默认地，对于&nbsp;ForeignKey&nbsp;或者拥有&nbsp;choices&nbsp;设置的字段，Django管理界面会使用列表选择框（&lt;select&gt;）。如果&nbsp;radio_admin&nbsp;设置为&nbsp;True&nbsp;的话，Django就会使用单选按钮界面。&nbsp; </td> 
 </tr> 
 <tr> 
 <td> unique </td> 
 <td> 如果是&nbsp;True&nbsp;，这个字段的值在整个表中必须是唯一的。 </td> 
 </tr> 
 <tr> 
 <td> unique_for_date&nbsp; </td> 
 <td> 把它的值设成一个&nbsp;DataField&nbsp;或者&nbsp;DateTimeField&nbsp;的字段的名称，可以确保字段在这个日期内不会出现重复值。 </td> 
 </tr> 
 <tr> 
 <td> unique_for_month </td> 
 <td> 和&nbsp;unique_for_date&nbsp;类似，只是要求字段在指定字段的月份内唯一。 </td> 
 </tr> 
 <tr> 
 <td> unique_for_year </td> 
 <td> 和&nbsp;unique_for_date&nbsp;及&nbsp;unique_for_month&nbsp;类似，只是时间范围变成了一年。 </td> 
 </tr> 
 <tr> 
 <td> verbose_name </td> 
 <td> 除&nbsp;ForeignKey&nbsp;、&nbsp;ManyToManyField&nbsp;和&nbsp;OneToOneField&nbsp;之外的字段都接受一个详细名称作为第一个位置参数。 </td> 
 </tr> 
 </tbody> 
</table>

转载于:https://www.cnblogs.com/baili-luoyun/p/11075588.html

[python-django _model]: https://www.cnblogs.com/wt869054461/p/4014271.html
[python]: http://www.heycode.com/dict/python