Django ORM 常用字段和参数-Python-娇小赤鸦-木叶科研通

作者:娇小赤鸦
分类: Python

一、models中的常用字段

1 AutoField

AutoField(primary_key=True) 主键字段
int自增列，必须填入参数 primary_key=True。当model中如果没有自增列，则自动会创建一个列名为 id的列。

2 CharField

CharField(max_length=32) varchar(32)
字符类型，必须提供max_length参数， max_length表示字符长度。对应的数据库中是varchar类型。

3 IntegerField

IntegerField() int
一个整数类型,范围在 -2147483648 to 2147483647。(一般不用它来存手机号(位数也不够)，直接用字符串存)。

4 BigIntergerField

BigIntergerField() bigint
长整型(有符号的) -9223372036854775808 ～ 9223372036854775807

5 DecimalField

DecimalField() decimal
- 10进制小数
- 参数：
max_digits，小数总长度
decimal_places，小数位长度

6 EmailField

EmailField() varchart(254)
字符串类型，Django Admin以及 ModelForm中提供验证机制。

7 DateField

DateField() date
日期格式 YYYY-MM-DD

8 DateTimeField

DateTimeField() datetime
日期时间字段，格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]，相当于Python中的datetime.datetime()实例。

9 BooleanField

BooleanField(Field)
给该字段传布尔值会对应成数字0/1
is_delete
is_status
is_vip

10 TextField

TextField(Field)
- 文本类型存储大段文本。

11 FileField

FileField(Field)
- 字符串，路径保存在数据库，文件上传到指定目录，只存文件路径。
upload_to = '指定文件路径'。
给该字段传文件对象文件会自动保存到 upload_to 指定的文件夹下然后该字段存文件的路径。

二、字段参数

参数	说明
primary_key	主键
max_length	最大字符长度
verbose_name	对应的名字
null	字段可以为空
default	默认值
max_digits	数字允许的最大位数
decimal_places	小数的最大位数
unique	unique=True 字段在此表中必须是唯一的
db_index	db_index=True 字段设置索引
auto_now	每次更新数据记录的时候会更新该字段
auto_now_add	创建数据记录的时候会把当前时间添加到数据库
to	设置关联的表
to_field	设置关联的字段
db_constraint	是否创建外键约束，默认True
related_name	修改正向查询的字段名，之后就可以使用修改后的字段名，类似于起别名

三、关系字段

ForeignKey

外键类型在ORM中用来表示外键关联关系，一般把ForeignKey字段设置在 "一对多" 中 "多"的一方。
ForeignKey可以和其他表做关联关系同时也可以和自身做关联关系。

字段参数

to 设置要关联的表。
to_field 设置要关联的表的字段。
on_delete 当删除关联表中的数据时，当前表与其关联的行的行为。
db_constraint 是否在数据库中创建外键约束，默认为True。

on_delete 外键详细配置

models.CASCADE

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

models.SET_NULL

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

models.PROTECT

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

models.SET_DEFAULT

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

models.SET()

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

models.DO_NOTHING

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

四、必知必会

返回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	按照天筛选数据

六、字段合集

字段合集

 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 即可查看查询语句。

六、字段合集

字段合集

 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)'

转载自: https://www.cnblogs.com/huaxiayuyi/p/16704128.html

Django ORM 常用字段和参数

一、models中的常用字段

二、字段参数

三、关系字段

四、必知必会

五、双下划线

六、字段合集

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

八、Django 终端打印SQL语句

六、字段合集

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

标签