Django ORM 常用字段和参数,BooleanFie


一、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) ==> 99999.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 按照天筛选数据

 

五、自定义char类型


Django中的CharField对应的MySQL数据库中的varchar类型。

没有设置对应char类型的字段,但是Django允许自定义新的字段,对应于数据库的char类型。

自定义字段在实际项目应用中可能会经常用到,需要对它留个印象!

from django.db import models

class MyCharField(models.Field):
    '''
    自定义的 char类型 的字段类
    '''
    def __init__(self, max_length, *args **kwargs):
        self.max_length = max_length
        # 关键字方式传值
        super().__init__(max_length = max_length, *args, **kwargs)

    def db_type(self, connection):
        '''
        数据类型约束条件,max_length 指定的值
        :param connection:
        :return:
        '''
        return 'char(%s)' % self.max_length
    
# 自定义字段使用
class MyModel(models.Model):
    nid = models.AutoField(primary_key = True)
    title = models.CharField(max_length = 32)
    mychar = MyCharField(max_length=16, null = True)

 

六、字段合集


字段合集
 AutoField(Field)
    - int自增列,必须填入参数 primary_key=True

BigAutoField(AutoField)
    - bigint自增列,必须填入参数 primary_key=True

    注:当model中如果没有自增列,则自动会创建一个列名为id的列
    from django.db import models

    class UserInfo(models.Model):
        # 自动创建一个列名为id的且为自增的整数列
        username = models.CharField(max_length=32)

    class Group(models.Model):
        # 自定义自增列
        nid = models.AutoField(primary_key=True)
        name = models.CharField(max_length=32)

SmallIntegerField(IntegerField):
    - 小整数 -32768 ~ 32767

PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
    - 正小整数 0 ~ 32767
IntegerField(Field)
    - 整数列(有符号的) -2147483648 ~ 2147483647

PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
    - 正整数 0 ~ 2147483647

BigIntegerField(IntegerField):
    - 长整型(有符号的) -9223372036854775808 ~ 9223372036854775807

BooleanField(Field)
    - 布尔值类型

NullBooleanField(Field):
    - 可以为空的布尔值

CharField(Field)
    - 字符类型
    - 必须提供max_length参数, max_length表示字符长度

TextField(Field)
    - 文本类型

EmailField(CharField):
    - 字符串类型,Django Admin以及ModelForm中提供验证机制

IPAddressField(Field)
    - 字符串类型,Django Admin以及ModelForm中提供验证 IPV4 机制

GenericIPAddressField(Field)
    - 字符串类型,Django Admin以及ModelForm中提供验证 Ipv4和Ipv6
    - 参数:
        protocol,用于指定Ipv4或Ipv6, 'both',"ipv4","ipv6"
        unpack_ipv4, 如果指定为True,则输入::ffff:192.0.2.1时候,可解析为192.0.2.1,开启此功能,需要protocol="both"

URLField(CharField)
    - 字符串类型,Django Admin以及ModelForm中提供验证 URL

SlugField(CharField)
    - 字符串类型,Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符(减号)

CommaSeparatedIntegerField(CharField)
    - 字符串类型,格式必须为逗号分割的数字

UUIDField(Field)
    - 字符串类型,Django Admin以及ModelForm中提供对UUID格式的验证

FilePathField(Field)
    - 字符串,Django Admin以及ModelForm中提供读取文件夹下文件的功能
    - 参数:
            path,                      文件夹路径
            match=None,                正则匹配
            recursive=False,           递归下面的文件夹
            allow_files=True,          允许文件
            allow_folders=False,       允许文件夹

FileField(Field)
    - 字符串,路径保存在数据库,文件上传到指定目录
    - 参数:
        upload_to = ""      上传文件的保存路径
        storage = None      存储组件,默认django.core.files.storage.FileSystemStorage

ImageField(FileField)
    - 字符串,路径保存在数据库,文件上传到指定目录
    - 参数:
        upload_to = ""      上传文件的保存路径
        storage = None      存储组件,默认django.core.files.storage.FileSystemStorage
        width_field=None,   上传图片的高度保存的数据库字段名(字符串)
        height_field=None   上传图片的宽度保存的数据库字段名(字符串)

DateTimeField(DateField)
    - 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]

DateField(DateTimeCheckMixin, Field)
    - 日期格式      YYYY-MM-DD

TimeField(DateTimeCheckMixin, Field)
    - 时间格式      HH:MM[:ss[.uuuuuu]]

DurationField(Field)
    - 长整数,时间间隔,数据库中按照bigint存储,ORM中获取的值为datetime.timedelta类型

FloatField(Field)
    - 浮点型

DecimalField(Field)
    - 10进制小数
    - 参数:
        max_digits,小数总长度
        decimal_places,小数位长度

BinaryField(Field)
    - 二进制类型

 

七、ORM字段与MySQL字段对应关系


ORM字段与MySQL字段对应关系
 对应关系:
    '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)'

 

八、Django 终端打印SQL语句


如果你想知道你对数据库进行操作时,Django 内部到底是怎么执行它的SQL语句时可以加下面的配置来查看。

在Django 项目的 settings.py 文件中,在最后复制粘贴如下代码。

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console':{
            'level':'DEBUG',
            'class':'logging.StreamHandler',
        },
    },
    'loggers': {
        'django.db.backends': {
            'handlers': ['console'],
            'propagate': True,
            'level':'DEBUG',
        },
    }
}

配置好之后,再执行任何对数据库进行操作的语句时,会自动将 Django 执行的 SQL 语句打印到终端上。

补充:

  • 除了配置外,还可以通过 .query 即可查看查询语句。

评论关闭