Django orm 常用字段和参数

字段参数:

常见字段参数: null:用于表示某个字段可以为空 unique:如果设置为unique
=True 则该字段在此表中必须是唯一的 db_index:如果db_index=True 则代表着为此字段设置索引 default:为该字段设置默认值
   primary_key:int 自增
   max_length:字符长度
   max_digits:小数总长度
   decimal_place:小数位长度 时间字段参数: auto_now_add:配置auto_now_add
=True,创建数据记录的时候会把当前时间添加到数据库 auto_now:配置上auto_now=True,每次更新数据记录的时候会更新该字段 外键字段参数: to:设置要关联的表 to_field:设置要关联的表的字段 on_delete:当删除关联表中的数据时,当前表与其关联的行的行为。 db_constraint:是否在数据库中创建外键约束,默认为True。 related_name:子表在主表中对应的外键属性,反向引用 注: 1.ManyToManyField不能设置on_delete,OneToOneField、ForeignKey必须设置on_delete 2.django1.x系统默认级联,但是django2.x必须手动明确
    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表示字符长度
    
    自定义char字端(*****)      
        class MyChar(models.Field):
            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):
                return 'char(%s)'%self.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)
        - 二进制类型
    
    外键字段:               
        ForeignKey:外键类型在ORM中用来表示外键关联关系.
            字段设置:在 '一对多'''的一方
            注:ForeignKey可以和其他表做关联关系同时也可以和自身做关联关系
            参数:
                to:设置要关联的表
                to_field:设置要关联的表的字段
                on_delete:当删除关联表中的数据时,当前表与其关联的行的行为。
                    models.CASCADE:删除关联数据,与之关联也删除
                db_constraint:是否在数据库中创建外键约束,默认为True。
                related_name:子表在主表中对应的外键属性,反向引用   
        OneToOneField:一对一字段,通常一对一字段用来扩展已有字段
            字段位置:从逻辑正反向考虑,如作者表与作者详情表,作者删除级联删除详情,详情删除作者依旧存在,所以建议外键在详情表中
            参数:
                to:设置要关联的表
                to_field:设置要关联的表的字段
                on_delete:当删除关联表中的数据时,当前表与其关联的行的行为。
               related_name:子表在主表中对应的外键属性,反向引用
        ManyToManyField:多对多字段
                外键位置:外键在关系表中
                to:设置要关联的表
                to_field:设置要关联的表的字段
                on_delete:当删除关联表中的数据时,当前表与其关联的行的行为。
                  related_name:子表在主表中对应的外键属性,反向引用
            注:
               0.当你在使用django2.X版本的时候 在建立外键关系时(*****)
                    需要你手动添加几个关键点参数    models.cascade  db_constraints
                1.ManyToManyField不能设置on_delete,OneToOneField、ForeignKey必须设置on_delete
                    注:django1.x系统默认级联,但是django2.x必须手动明确
                2.db_constraint 
                    db_constraint             唯一约束
                    db_constraint = True      方便查询 约束字段
                    db_constraint = fales(*)  不约束字段 同时也可以查询,就是保留跨表查询的便利
                3.on_delete 外键的删除
                    1.on_delete = CASCADE:这就是默认的选项,级联删除,你无需显性指定它
                    2.on_delete = PROTECT:保护模式,如果采用该选项,删除的时候,会抛出ProtectedError错误
                    3.on_delete = SET_NULL:置空模式,删除的时候,外键字段被设置为空
                        注:前提就是blank=True, null=True,定义该字段的时候,允许为空
                    4.on_delete = SET_DEFAULT: 置默认值,删除的时候,外键字段设置为默认值,    
                    5.on_delete = DO_NOTHING: 该模式作者删除,详情不动
                4 related_name = 'xxx'  子表在主表中对应的外键属性,反向引用   
    '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)',
orm与sql 间的类比
原文地址:https://www.cnblogs.com/wyf20190411-/p/13744008.html