当前位置： 首页 > news >正文

Django--ORM 常用字段及属性介绍

news 来源：原创 2024/5/4 23:32:02

目录

常用字段

AutoField字段

IntegerField 字段

CharField字段

DateField 字段

DateTimeField字段

auto_now_add参数

auto_now 参数

BoolenField字段

TextField字段

EmailField 字段

ImageField 字段

参数

字段参数

null

unique

db_index

default

choice参数

外键字段

1. ForgignKey字段

ForeignKey字段参数

to

to_field

on_delete

db_constraint

2. OneToOneField字段

一对一字段

OneToOneField 字段参数

ManyToManyField字段

多对多字段

ManyToManyField字段参数

字段合集

ORM 与MySQL对应关系

常用字段

AutoField字段

int自增列, 必须填入参数primary_key=True, 当model中如果没有自增列,则自动会创建一个列明为id的列, 

IntegerField 字段

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

CharField字段

字符类型, 必须提供max_length参数, max_length表示字符长度

这里需要知道的是Django中的CharField对应的MySQL数据库中的varchar类型, 没有设置对应char类型的字段, 但是Django允许我们自定义新的字段, 下边我来自定义对应数据库的char类型

from django.db import models

#Django中没有对应的char类型字段，但是我们可以自己创建

class FixCharField(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):
        '''
        限定生成的数据库表字段类型char，长度为max_length指定的值
        :param connection:
        :return:
        '''
        return 'char(%s)'%self.max_length

      
#应用上面自定义的char类型
class Test(models.Model):
    id=models.AutoField(primary_key=True)
    title=models.CharField(max_length=32)
    class_name=FixCharField(max_length=16)
    gender_choice=((1,'男'),(2,'女'),(3,'保密'))
    gender=models.SmallIntegerField(choices=gender_choice,default=3)

DateField 字段

日期字段,日期格式YYYY-MM-DD. 相当于python中的datetime.date()实例

DateTimeField字段

日期时间字段, 格式YYYY-MM-DD HH:MM[:ss[.uuuuu]][TZ], 相当于python中的datetime()实例

auto_now_add参数

配置auto_now_add=True, 创建数据记录的时候会把当前的时间添加带数据库

auto_now 参数

配置auto_now=true, 每次更新数据记录的时候会更新改字段

BoolenField字段

给这个字段传bool值,会自动转成0或者1, 一般用在二选一状态

TextField字段

用于存储大段文本, 且不需要指定字段参数,内容没有大小限制

EmailField 字段

字符串, 路径保存在数据库, 文件上传到指定目录

 参数：
upload_to = "" 上传文件的保存路径
storage = None 存储组件，默认django.core.files.storage.FileSystemStorage

ImageField 字段

字符串, 路径保存在数据库, 文件上传到指定目录

参数

upload_to = '' '' 上传文件的保存路径

storage=None 存储组件, 默认django.core.files.storage.FileSystemStorage

width_field=None 上传图片的宽度保存的数据库字段名(字符串)

height_field=None 上传图片的高度保存的数据库字段名(字符串)

字段参数

null

用于表示某个字段可以为空

unique

如果设置为unique=True 则改字段在此表中必须使唯一的

db_index

如果db_index=True则代表为此字段设置索引

default

为该字段那设置默认值

choice参数

针对某个字段可以举例完全的情况, 我们一半都是使用choice参数

class Server(models.Model):
    host = models.CharField(max_length=32)
    status_choice = {
            (1,'在线')
            (2,'不在线'),
        )
    status = models.IntegerField(choices=status_choice)

    desc_Choice=(
            ('hh',666),
            ('zz',000),
        )
    desc = models.CharField(max_length=32,choices=desc_choice)

新建数据库之后, 在数据库中存储的字段就是status 和 desc而不是各自对应的值

Server.objects.create(host='127.0.0.1',status=1,desc='不在选择表中')
Server.objects.create(host='127.0.0.2',status-2,desc='hh')
res = Server.objects.filter(pk=1).first()
print(res.status)
# 1

想要查看各自对应的值需要借助于get_字段名_display()

res = Server.objects.filter(pk=1).first()
print(res.status)
print(res.get_status_display())

print(res.desc)
print(res.get_desc_display())
# 1
# 在线
# 不在选择表中
# 不在选择表中


res = Server.objects.filter(pk=2).first()
print(res.status)
print(res.get_status_display())

print(res.desc)
print(res.get_desc_display())
# 2
# 不在线
# hh
# 6666666

外键字段

1. ForgignKey字段

外键类型在ORM中用来表示外键关联关系, 一般把ForeignKey字段设置在'一对多'中'多'的一方.

ForeignKey可以和其他表做关联关系同时也可以和自身做关联关系

ForeignKey字段参数

to

设置要关联的表

to_field

设置要关联的表的字段,不写默认为主键

on_delete

当删除关联表中的数据时, 当前表与其关联的行的行为. 

models.DO_NOTHING
删除关联数据，引发错误IntegrityError，去掉外键关系


models.PROTECT
删除关联数据，引发错误ProtectedError


models.SET_NULL
删除关联数据，与之关联的值设置为null（前提FK字段需要设置为可空）


models.SET_DEFAULT
删除关联数据，与之关联的值设置为默认值（前提FK字段需要设置默认值）

models.CASCADE
删除关联数据，与之关联的值也删除

models.SET(值或者函数名)

删除关联数据，
a. 与之关联的值设置为指定值，设置：models.SET(值)
b. 与之关联的值设置为可执行对象的返回值，设置：models.SET(可执行对象)

例如:

def func():
    return 10

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

db_constraint

是否在数据库中创建外键约束, 默认为True

2. OneToOneField字段

一对一字段

通常一对一字段用来扩展已有字段 , 通俗的说就是一个人的所以信息不是放在一张表里的. 简单的信息一张表, 隐私的信息存另一张表, 之间通过一对一外键关联..

OneToOneField 字段参数

to_ 设置要关联的表

to_field_设置要关联的字段

on_delete_ 当删除关联表中的数据时. 当前表与其关联的行的行为. (参考上边的例子)

ManyToManyField字段

多对多字段

区别于原生SQL创建多对多需要手动创建一张关系表, ORM ManyToManyField 自动创建第三张关系表, 并且创建出的字段时虚拟字段,不会再表中展示出来

ManyToManyField字段参数

to_设置要关联的表

to_field_ 设置要关联的字段

on_delete_当删除关联表中的数据时, 当前表与其关联的行的行为(参考上面的例子)

字段合集

		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对应关系

对应关系：
    '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)',

相关文章：

  • y122.第七章 服务网格与治理-Istio从入门到精通 -- 流量治理实战进阶(八)
  • 【Mysql】Mysql视图、触发器、存储过程、游标
  • 0902（045天 集合框架09 总结点 问）
  • 算法学习-贪心问题（持续更新中）
  • SpringBoot+Shiro+JWT实现授权
  • 与归并排序相关的一些问题
  • 【C语言拓展】缓冲区、结构体大小计算、命令行参数
  • 《华为数据之道》总结
  • java基于springboot+vue+elementui的会员制在线读书图书购物管理平台
  • python：数据类型、编码方式（base64、utf--8）、python中的进制、\u,\x,0x区别
  • 操作系统中的进程是什么?(详细讲解进程调度相关PCB信息)
  • Java并发 JUC工具类：Semaphore详解
  • Android 开发框架——Glide 图片加载框架
  • CentOS 7 安装教程（基于虚拟机安装）
  • IOC理论
  • eclipse的离线汉化
  • Java，console输出实时的转向GUI textbox
  • JS 面试题总结
  • PHP 使用 Swoole - TaskWorker 实现异步操作 Mysql
  • spring cloud gateway 源码解析（4）跨域问题处理
  • 基于OpenResty的Lua Web框架lor0.0.2预览版发布
  • 基于web的全景—— Pannellum小试
  • 跨域
  • 如何在 Tornado 中实现 Middleware
  • 用 vue 组件自定义 v-model， 实现一个 Tab 组件。
  • RDS-Mysql 物理备份恢复到本地数据库上
  • 进程与线程（三）——进程/线程间通信
  • $().each和$.each的区别
  • $redis-setphp_redis Set命令，php操作Redis Set函数介绍
  • （ 用例图）定义了系统的功能需求，它是从系统的外部看系统功能，并不描述系统内部对功能的具体实现
  • （6）设计一个TimeMap
  • （Redis使用系列） Springboot 使用redis实现接口Api限流 十
  • （草履虫都可以看懂的）PyQt子窗口向主窗口传递参数，主窗口接收子窗口信号、参数。
  • （附源码）ssm基于jsp高校选课系统 毕业设计 291627
  • (附源码)计算机毕业设计高校学生选课系统
  • （接口封装）
  • ./configure、make、make install 命令
  • .gitignore文件_Git：.gitignore
  • .net分布式压力测试工具(Beetle.DT)
  • .Net开发笔记（二十）创建一个需要授权的第三方组件
  • .NET命令行（CLI）常用命令
  • .NET项目中存在多个web.config文件时的加载顺序
  • [ 2222 ]http://e.eqxiu.com/s/wJMf15Ku
  • [ 云计算 | AWS ] AI 编程助手新势力 Amazon CodeWhisperer：优势功能及实用技巧
  • [ACL2022] Text Smoothing: 一种在文本分类任务上的数据增强方法
  • [AIGC 大数据基础]hive浅谈
  • [BT]BUUCTF刷题第8天（3.26）
  • [BUAA软工]第一次博客作业---阅读《构建之法》
  • [BZOJ] 2427: [HAOI2010]软件安装
  • [C/C++] C/C++中数字与字符串之间的转换
  • [hdu 2826] The troubles of lmy [简单计算几何 - 相似]
  • [JavaWeb学习] Spring Ioc和DI概念思想
  • [leetcode 双指针]
  • [one_demo_18]js定时器的示例
  • [OpenWrt]RAX3000一根线实现上网和看IPTV