1. Python技术站首页
  2. Python开发

Django ORM 常用字段和参数

• Python开发

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

 

本站文章如无特殊说明，均为本站原创，如若转载，请注明出处：Django ORM 常用字段和参数 - Python技术站

赞 (0)
0 0 打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2023年4月2日
下一篇 2023年4月2日

相关文章

  • Django django-admin.py 命令详解 Python开发

    Django django-admin.py 命令详解

    一、Django 基本命令 下载 Django pip3 install django     # 默认下载最新版 pip3 install django==4.1  # 手动选择版本   创建Django 项目 格式：django-admin startproject 项目名 django-admin startproject mysite   创建APP…

    2023年4月2日
    00
  • Django 使用Pycharm 创建工程 Python开发

    Django 使用Pycharm 创建工程

    一、Pycharm 创建Django 工程 事实上，我们一般不使用命令行，而是直接在Pycharm 中创建Django 项目。 Pycharm 是进行Django 开发的最佳 IDE，请大家自行安装，建议使用最新的专业版本。 （非专业版的Pycharm 不提供Django 开发模块，非最新版的 Pycharm 可能对最新的 Python 或者 Django …

    2023年4月2日
    00
  • Django 静态文件配置 Python开发

    Django 静态文件配置

    一、静态文件配置 在 settings.py 文件的最后添加 # settings.py # Static files (CSS, JavaScript, Images) # https://docs.djangoproject.com/en/4.1/howto/static-files/ # STATIC SETTINGS STATIC_URL = ‘/s…

    2023年4月2日
    00

  • Django 之模版层

    一、模板简介 将前端页面和Python 的代码分离是一种的开发模式。 为此 Django专门提供了模板系统 (Template System，即模板层)来实现这种模式。 Django 的模板 = HTML代码 + 模板语法 存放于 templates 目录下的 html文件称之为模板文件，要返回的 html页面中的数据是动态的，那么必须在 html页面中嵌入…

    Python开发 2023年4月2日
    00

  • Django manage.py 命令详解

    manage.py 查看命令的作用的语句 C:\Users\Administrator> python manage.py help Type ‘manage.py help <subcommand>’ for help on a specific subcommand. Available subcommands: [auth] chan…

    Python开发 2023年4月2日
    00
  • Django 之必知必会三板斧 Python开发

    Django 之必知必会三板斧

    一、HttpResponse 在django.http 模块中定义了HttpResponse 对象的API，HttpRequest 对象由Django 自动创建，不调用模板，直接返回数据。 1 在 app/views.py 中导入模块，添加对应的函数 from django.shortcuts import HttpResponse, render, red…

    2023年4月2日
    00

  • Django 聚合分组F与Q查询及choices

    一、聚合查询 需要导入模块：from django.db.models import Max, Min, Sum, Count, Avg 关键语法：aggregate(聚合结果别名 = 聚合函数(参数)) 查询结果：使用聚合函数，从每一个组中获取结果：字典 注意点： 1 聚合函数必须在分组之后才能使用 2 没有分组，即默认整体就是一组 3 查询结果为 普通字…

    Python开发 2023年4月2日
    00

  • Django ORM 实现数据的单表 增删改查

    一、配置环境 1 Django 连接数据库(MySQL) DATABASES = { ‘default’: { ‘ENGINE’: ‘django.db.backends.mysql’, ‘NAME’: ‘xyz’, ‘USER’:’root’, ‘PASSWORD’:’root’, ‘HOST’:’IP地址’, ‘PORT’:3306, ‘CHARSET’…

    Python开发 2023年4月2日
    00
合作推广
合作推广
分享本页
返回顶部