Django ORM 常用字段和参数

一、models中的常用字段类型

---

字段类型

成都创新互联公司专注于长丰网站建设服务及定制，我们拥有丰富的企业做网站经验。 热诚为您提供长丰营销型网站建设，长丰网站制作、长丰网页设计、长丰网站官网定制、小程序定制开发服务，打造长丰网络公司原创品牌,更为您提供长丰网站排名全网营销落地服务。

类型	说明
AutoField	自动增长的 IntegerField，通常不用指定，不指定时Django会自动创建属性名为 id 的自动增长属性。
BooleanField	布尔字段，值为True 或 False
NullBooleanField	支持Null、True、False三种值
CharField	字符串，参数max_length表示最大字符个数，对应mysql中的varchar。
TextField	大文本字段，一般大段文本（超过4000个字符）才使用。
IntegerField	整数
BigIntegerField	长整型(有符号的)
DecimalField	十进制浮点数， 参数max_digits表示总位数， 参数decimal_places表示小数位数,常用于表示分数和价格 Decimal(max_digits=7, decimal_places=2) ==> .99~ 0.00
FloatField	浮点数
DateField	日期 参数 auto_now 表示每次保存对象时，自动设置该字段为当前时间。 参数 auto_now_add 表示当对象第一次被创建时自动设置当前。 参数 auto_now_add 和 auto_now 是相互排斥的，一起使用会发生错误。
TimeField	时间，参数同 DateField。
DateTimeField	日期时间，参数同 DateField。
FileField	上传文件字段,django在文件字段中内置了文件上传保存类, django可以通过模型的字段存储自动保存上传文件, 但是, 在数据库中本质上保存的仅仅是文件在项目中的存储路径！！
ImageField	继承于 FileField，对上传的内容进行校验，确保是有效的图片。
EmailField	字符串类型，和邮箱相关

二、约束选项

---

选项	说明
null	如果为True，表示允许为空，默认值是False。相当于python的None。
blank	如果为True，则该字段允许为空白，默认值是False。 相当于python的空字符串，“”
db_column	字段的名称，如果未指定，则使用属性的名称。
db_index	若值为True, 则在表中会为此字段创建索引，默认值是False。 相当于SQL语句中的key。
default	默认值，当不填写数据时，使用该选项的值作为数据的默认值。
primary_key	如果为True，则该字段会成为模型的主键，默认值是False，一般不用设置，系统默认设置。
unique	如果为True，则该字段在表中必须有唯一值，默认值是False。相当于SQL语句中的unique。
max_length	最大字符长度
verbose_name	对应的名字，注释
max_digits	数字允许的最大位数
decimal_places	小数的最大位数
to	设置关联的表
to_field	设置关联的字段
db_constraint	是否创建外键约束，默认True
related_name	修改正向查询的字段名，之后就可以使用修改后的字段名，类似于起别名
on_delete	当删除关联表中的数据时，当前表与其关联的行的行为

注意：null 是数据库范畴的概念，blank 是表单验证范畴的。

外键

在设置外键时，需要通过 on_delete选项指明主表删除数据时，对于外键引用表数据如何处理，在django.db.models中包含了可选常量：

• CASCADE 级联操作，当主表中被连接的一条数据删除时，从表中所有与之关联的数据同时被删除

• PROTECT 当主表中的一行数据删除时，由于从表中相关字段是受保护的外键，所以都不允许删除

• SET_NULL 当主表中的一行数据删除时，从表中所有与之关联的数据的相关字段设置为null,此时注意定义外键时，这个字段必须可以允许为空

• SET_DEFAULT 当主表中的一行数据删除时，从表中所有相关的数据的关联字段设置为默认值，此时注意定义外键时，这个外键字段应该有一个默认值

• DO_NOTHING什么都不做，一切都看数据库级别的约束，注数据库级别的默认约束为RESTRICT,这个约束与django中的models.PROTECT相似

• SET() 当主表中的一条数据删除时，从表中所有的关联数据字段设置为SET()中设置的值，与models.SET_DEFAULT相似，只不过此时从表中的相关字段不需要设置default参数

def func():
    return 10

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

三、常用查询

---

返回QuerySet对象

• all() 查询所有结果。
• filter() 它包含了与所给筛选条件相匹配的对象。
• exclude() 排除在外，它包含了与所给筛选条件不匹配的对象。
• order_by() 对查询结果排序，默认升序/(-字段)降序。
• reverse() 对查询结果反向排序，前提是数据已经排序过了order_by()。
• distinct() 从返回结果中剔除重复纪录。

返回对象

• get() 返回与所给筛选条件相匹配的对象，返回结果有且只有一个，如果符合筛选条件的对象超过一个或者没有都会抛出错误。
• first() 返回第一条记录
• last() 返回最后一条记录

返回布尔值

• exists() 如果QuerySet包含数据，就返回True，否则返回False。

返回数字

• count() 统计当前数据的个数。

返回QuerySet

• values() 返回一个ValueQuerySet，一个特殊的QuerySet，运行后得到的并不是一系列model的实例化对象，而是一个可迭代的字典序列。
• values_list() 它与values()非常相似，它返回的是一个元组序列，values返回的是一个字典序列。

四、双下划线

---

filter里是不能写逻辑运算符的，而是给定了一个特定的方法去提供逻辑查询，那就是双下划线。

返回值 = models.User.objects.filter(字段__contains = '条件')

方法	功能
字段__gt	大于
字段__lt	小于
字段__gte	大于等于
字段__lte	小于等于
字段__in	成员运算、在什么里
字段__range	范围查询
字段__contains	模糊查询，区分大小写
字段__icontains	模糊查询，忽略大小写
字段__startswith	匹配开头
字段__endswith	匹配结尾
字段__regex	正则表达式
字段__year	按照年份筛选数据
字段__month	按照月份筛选数据
字段__day	按照天筛选数据

分享名称：Django ORM 常用字段和参数
链接URL：http://cdkjz.cn/article/dsogsjd.html