ORM（二）常用字段小记

旧城等待， 2021-09-29 10:52 483阅读 0赞

## 常用字段类型： ##

AutoField：字段自增，多用于ID主键字段，每个表中只能有一个AutoField字段类型。

id = models.AutoField(primary_key=True)  # 设置id字段为主键并自增长

AutoField字段是根据IntegerField类型自动递增的。而IntegerField的取值范围是：-2147483648到2147483647

BigAutoField：与AutoField功能相同都是自增，但是他的取值范围要更大：1到9223372036854775807

IntegerField：一个整数。取值范围-2147483648到2147483647。此字段的默认表单控件是 NumberInput当localize 为False或TextInput以其他方式。

BigIntegerField：一个64位整数，很像一个IntegerField不同之处在于它是保证从适合数字-9223372036854775808到 9223372036854775807。此字段的默认表单窗口小部件是a TextInput。

BinaryField：用于存储原始二进制数据的字段。它只支持bytes分配。请注意，此字段的功能有限。例如，无法过滤BinaryField值的查询集。也不可能在a BinaryField中包含a ModelForm。

PositiveIntegerField：像一个IntegerField，但必须是正数或零（0）。从价值观0到2147483647在Django支持的所有数据库的安全。0出于向后兼容性原因，接受该值。

BooleanField：真/假字段。此字段的默认表单窗口小部件是CheckboxInput。如果您需要接受null值，适用NullBooleanField。当Field.default 没有定义，默认值BooleanField是None。

NullBooleanField：像一个BooleanField，允许NULL作为选项之一。使用此而不是BooleanField使用null=True。此字段的默认表单窗口小部件是NullBooleanSelect。

CharField：字符串字段（varchar）。对于大量文本，请使用TextField。此字段的默认表单窗口小部件是TextInput。

CharField 有一个额外的必要参数：CharField(max\_length=20)字段的最大长度（以字符为单位）。max\_length在数据库级别和Django的验证中强制执行。

TextField：一个大的文本字段。此字段的默认表单窗口小部件是a Textarea。

如果指定max\_length属性，它将反映在Textarea自动生成的表单字段的 窗口小部件中。但是，它不会在模型或数据库级别强制执行。

DateField：日期，由Python datetime.date实例表示。

有一些额外的可选参数：

auto\_now：每次保存对象时自动将字段设置为当前时间，该字段仅在Model.save()后，会更新该字段的日期。

auto\_now\_add：首次创建对象时自动将字段设置为当前时间。此字段的默认表单窗口小部件是TextInput。管理员添加了一个JavaScript日历，以及“今天”的快捷方式。包含其他invalid\_date错误消息密钥。选项auto\_now\_add，auto\_now和default互相排斥。这些选项的任何组合都将导致错误。

DateTimeField：日期和时间，由Python datetime.datetime实例表示。采取相同的额外参数DateField。此字段的默认表单窗口小部件是单个 TextInput。管理员使用两个单独的 TextInput小部件和JavaScript快捷方式。

TimeField：一个时间，由Python datetime.time实例表示。接受相同的自动填充选项DateField。

此字段的默认表单窗口小部件是a TextInput。管理员添加了一些JavaScript快捷方式。

DecimalField：一个固定精度的十进制数，由Python Decimal实例表示。

有两个必需的参数：

DecimalField.max\_digits：数字中允许的最大位数。请注意，此数字必须大于或等于decimal\_places。

DecimalField.decimal\_places：与数字一起存储的小数位数。

此字段的默认表单控件是NumberInput 当localize为False或 TextInput以其他方式。

DurationField：用于存储时间段的字段 - 用Python建模 timedelta。在PostgreSQL上使用时，使用interval的数据类型是Oracle，数据类型是。否则使用一微秒。INTERVAL DAY(9) TO SECOND(6)bigint

EmailField：CharField检查该值是否为有效电子邮件地址的A. 它用于EmailValidator验证输入。

FileField：文件上传字段。Django Admin以及ModelForm中提供读取文件夹下文件的功能

参数：  
 path, 文件夹路径  
 match=None, 正则匹配  
 recursive=False, 递归下面的文件夹  
 allow\_files=True, 允许文件

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

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

FloatField：由float实例在Python中表示的浮点数。此字段的默认表单控件是NumberInput 当localize为False或 TextInput以其他方式。

ImageField：从中继承所有属性和方法FileField，但也验证上载的对象是有效图像。

除了可用于特殊属性FileField，一个ImageField也具有height和width属性。

为了便于查询这些属性，ImageField有两个额外的可选参数：

ImageField.height\_field：每次保存模型实例时，将使用图像高度自动填充的模型字段的名称。

ImageField.width\_field：每次保存模型实例时，将使用图像宽度自动填充的模型字段的名称。

ImageField实例在数据库中创建为varchar 默认最大长度为100个字符的列。与其他字段一样，您可以使用max\_length参数更改最大长度。

此字段的默认表单窗口小部件是a ClearableFileInput。

GenericIPAddressField：IPv4或IPv6地址，采用字符串格式（例如192.0.2.30或 2a02:42fe::4）。此字段的默认表单窗口小部件是TextInput。

GenericIPAddressField.protocol：限制指定协议的有效输入。可接受的值是'both'（默认），'IPv4' 或'IPv6'。匹配不区分大小写。

GenericIPAddressField.unpack\_ipv4：解压缩IPv4映射地址，如::ffff:192.0.2.1。如果启用此选项，则该地址将被解压缩到 192.0.2.1。默认为禁用。只能在protocol设置为时使用'both'。如果允许空值，则必须允许空值，因为空值存储为空。

SlugField：Slug是一个报纸术语。slu is是一种短标签，只包含字母，数字，下划线或连字符。它们通常用于URL。

与CharField类似，您可以指定max\_length（阅读有关数据库可移植性的说明以及max\_length该部分中的说明）。如果max\_length未指定，Django将使用默认长度50。

意味着设置Field.db\_index为True。

基于某个其他值的值自动预填充SlugField通常很有用。您可以在管理员中自动执行此操作 prepopulated\_fields。

SlugField.allow\_unicode：如果True，该字段除ASCII字母外还接受Unicode字母。默认为False。

SmallIntegerField：像一个IntegerField，但只允许某个（数据库相关）点下的值。从价值观-32768到32767在Django支持的所有数据库的安全。

URLField：一个CharField一个网址。

此字段的默认表单窗口小部件是a TextInput。

与所有CharField子类一样，URLField采用可选 max\_length参数。如果未指定 max\_length，则使用默认值200。

UUIDField：用于存储通用唯一标识符的字段。使用Python的 UUID类。在PostgreSQL上使用时，它以uuid数据类型存储，否则存储在 char(32)。

通用唯一标识符是AutoFieldfor的 一个很好的替代品primary\_key。数据库不会为您生成UUID，因此建议使用default：

import uuid
    from django.db import models
    
    class MyUUIDModel(models.Model):
        id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)

## 关系字段： ##

ForeignKey：多对一的关系。需要两个位置参数：与模型相关的类和on\_delete选项。（on\_delete实际上并不需要，但不提供它会给出弃用警告。在Django 2.0中将需要它。）

要创建递归关系 - 与自身具有多对一关系的对象 - 使用。models.ForeignKey('self', on\_delete=models.CASCADE)

如果需要在尚未定义的模型上创建关系，可以使用模型的名称，而不是模型对象本身：

on\_delete选项：

CASCADE：级联删除。Django模拟SQL约束ON DELETE CASCADE的行为，并删除包含ForeignKey的对象。

PROTECT：通过引发ProtectedError子类来 防止删除引用的对象 django.db.IntegrityError。

SET\_NULL：设置ForeignKeynull， 这是如果只可能 null是True。

SET\_DEFAULT：将ForeignKey其设置为默认值;，ForeignKey必须设置的默认值 。

DO\_NOTHING：不采取行动。如果数据库后端强制实施参照完整性，则IntegrityError除非您手动将SQL 约束添加到数据库字段，否则将导致这种情况。ON DELETE

SET（）：设置ForeignKey传递给的值SET()，或者传入 一个callable，调用它的结果。在大多数情况下，为了避免在导入models.py时执行查询，必须传递callable：

from django.conf import settings
    from django.contrib.auth import get_user_model
    from django.db import models
    
    def get_sentinel_user():
        return get_user_model().objects.get_or_create(username='deleted')[0]
    
    class MyModel(models.Model):
        user = models.ForeignKey(
            settings.AUTH_USER_MODEL,
            on_delete=models.SET(get_sentinel_user),
        )

ManyToManyField：多对多的关系。需要一个位置参数与模型相关的类，它与ForeignKey作用完全相同 ，包括递归和 惰性关系。

可以使用字段添加，删除或创建相关对象 RelatedManager。

OneToOneField：一对一的关系。从概念上讲，这类似于 ForeignKeywith unique=True，但关系的“反向”方面将直接返回单个对象。

这作为模型的主键是最有用的，它以某种方式“扩展”另一个模型; 例如，通过从子模型向父模型添加隐式一对一关系来实现多表继承。

需要一个位置参数：与模型相关的类。这与它的工作方式完全相同ForeignKey，包括有关递归 和惰性关系的所有选项。

如果没有related\_name为其指定参数OneToOneField，Django将使用当前模型的小写名称作为默认值。

##  自定义类型 ##

如果觉得orm提供的数据类型不能满足需求，可以自定义数据类型。如下定义一个char数据类型：

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

class MyCharField(models.Field):
        """
        自定义的char类型的字段类
        """
        def __init__(self, max_length, *args, **kwargs):
            self.max_length = max_length
            super(MyCharField, self).__init__(max_length=max_length, *args, **kwargs)
    
        def db_type(self, connection):
            """
            限定生成数据库表的字段类型为char，长度为max_length指定的值
            """
            return 'char(%s)' % self.max_length
    
    class Temp(models.Model):
        id = models.AutoField(primary_key=True)
        name = models.CharField(max_length=25)  # ORM自带数据类型
        # 使用自定义的char类型的字段
        cname = MyCharField(max_length=25)  # 使用自定义字段类型

自定义字段类型

执行迁移命令

python37 manage.py makemigrations

python37 manage.py migrate

最终生成表如下：

![1569555-20190410082136366-768661328.jpg][]

在数据库中查看如下：

![1569555-20190410082151922-734846646.jpg][]

参考文档：https://docs.djangoproject.com/en/1.11/ref/models/fields/\#django.db.models.AutoField

\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#

字段就简单到这里，关于字段里的参数，在以后的实例中用到在具体解释。下一章表的字段操作

\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#

转载于:https://www.cnblogs.com/caesar-id/p/10679653.html

[ContractedBlock.gif]: https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif
[ExpandedBlockStart.gif]: /images/20210725/49cb40be3376410488c9cd0c2f5cadd5.png
[1569555-20190410082136366-768661328.jpg]: /images/20210725/f6e77b27cf724546ae98975bfbc4fda8.png
[1569555-20190410082151922-734846646.jpg]: /images/20210725/91b0eaf9294742588eb04c50f6586efe.png