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