20.Django5入门教程-ORM模型常用属性

繁华c

已于 2024-09-18 16:12:08 修改

阅读量993

点赞数 18

文章标签： django 后端数据库 python

于 2024-09-18 14:30:17 首次发布

本文链接：https://blog.csdn.net/u013342594/article/details/142332522

版权

一、常用字段：

在Django中，定义了一些Field来与数据库表中的字段类型来进行映射。以下将介绍那些常用的字段类型。

1 AutoField：

映射到数据库中是int类型，可以有自动增长的特性。一般不需要使用这个类型，如果不指定主键，那么模型会自动的生成一个叫做id的自动增长的主键。如果你想指定一个其他名字的并且具有自动增长的主键，使用AutoField也是可以的。

2. BigAutoField：

64位的整形，类似于AutoField，只不过是产生的数据的范围是从1-9223372036854775807。

setting.py中 DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'是给模型中没有设置id的时候给id自增加的类型

3. BooleanField：

在模型层面接收的是True/False。在数据库层面是tinyint类型。如果没有指定默认值，默认值是None。

4. CharField：

在数据库层面是varchar类型。在Python层面就是普通的字符串。这个类型在使用的时候必须要指定最大的长度，也即必须要传递max_length这个关键字参数进去。

5. DateField：

日期类型。在Python中是datetime.date类型，可以记录年月日。在映射到数据库中也是date类型。使用这个Field可以传递以下几个参数：

auto_now：在每次这个数据保存的时候，都使用当前的时间。比如作为一个记录修改日期的字段，可以将这个属性设置为True。
auto_now_add：在每次数据第一次被添加进去的时候，都使用当前的时间。比如作为一个记录第一次入库的字段，可以将这个属性设置为True。

6. DateTimeField：

日期时间类型，类似于DateField。不仅仅可以存储日期，还可以存储时间。映射到数据库中是datetime类型。这个Field也可以使用auto_now和auto_now_add两个属性。

7. TimeField：

时间类型。在数据库中是time类型。在Python中是datetime.time类型。

8. EmailField：

类似于CharField。在数据库底层也是一个varchar类型。最大长度是254个字符。

9. FileField：

用来存储文件的。这个请参考后面的文件上传章节部分。

10. ImageField：

用来存储图片文件的。这个请参考后面的图片上传章节部分。

11. FloatField：

浮点类型。映射到数据库中是float类型。

12. IntegerField：

整形。值的区间是-2147483648——2147483647。

13. BigIntegerField：

大整形。值的区间是-9223372036854775808——9223372036854775807。

14. PositiveIntegerField：

正整形。值的区间是0——2147483647。

15. SmallIntegerField：

小整形。值的区间是-32768——32767。

16. PositiveSmallIntegerField：

正小整形。值的区间是0——32767。

17. TextField：

大量的文本类型。映射到数据库中是longtext类型。

18. UUIDField：

只能存储uuid格式的字符串。uuid是一个32位的全球唯一的字符串，一般用来作为主键。

19. URLField：

类似于CharField，只不过只能用来存储url格式的字符串。并且默认的max_length是200。

Field的常用参数：

1. null：

如果设置为True，Django将会在映射表的时候指定是否为空。默认是为False。在使用字符串相关的Field（CharField/TextField）的时候，官方推荐尽量不要使用这个参数，也就是保持默认值False。因为Django在处理字符串相关的Field的时候，即使这个Field的null=False，如果你没有给这个Field传递任何值，那么Django也会使用一个空的字符串""来作为默认值存储进去。因此如果再使用null=True，Django会产生两种空值的情形（NULL或者空字符串）。如果想要在表单验证的时候允许这个字符串为空，那么建议使用blank=True。如果你的Field是BooleanField，那么对应的可空的字段则为NullBooleanField。

2. blank：

标识这个字段在表单验证的时候是否可以为空。默认是False。
这个和null是有区别的，null是一个纯数据库级别的。而blank是表单验证级别的。

3. db_column：

这个字段在数据库中的名字。如果没有设置这个参数，那么将会使用模型中属性的名字。

4. default：

默认值。可以为一个值，或者是一个函数，但是不支持lambda表达式。并且不支持列表/字典/集合等可变的数据结构。

5. primary_key：

是否为主键。默认是False。

6. unique：

在表中这个字段的值是否唯一。一般是设置手机号码/邮箱等。

更多Field参数请参考官方文档：模型字段参考 | Django 文档 | Django

三、模型中`Meta`配置：

对于一些模型级别的配置。我们可以在模型中定义一个类，叫做Meta。然后在这个类中添加一些类属性来控制模型的作用。比如我们想要在数据库映射的时候使用自己指定的表名，而不是使用模型的名称。那么我们可以在Meta类中添加一个db_table的属性。示例代码如下：

class Book(models.Model):
	name = models.CharField(max_length=20,null=False)
	desc = models.CharField(max_length=100,name='description',db_column="description1")

	class Meta:
		db_table = 'book_model'

以下将对Meta类中的一些常用配置进行解释。

1. db_table：

这个模型映射到数据库中的表名。如果没有指定这个参数，那么在映射的时候将会使用模型名来作为默认的表名。

2. ordering：

设置在提取数据的排序方式。后面章节会讲到如何查找数据。比如我想在查找数据的时候根据添加的时间排序，那么示例代码如下：

class Book(models.Model):
	name = models.CharField(max_length=20,null=False)
	desc = models.CharField(max_length=100,name='description',db_column="description1")
	pub_date = models.DateTimeField(auto_now_add=True)

	class Meta:
		db_table = 'book_model'
		ordering = ['pub_date']

更多的配置后面会慢慢介绍到。
官方文档：https://docs.djangoproject.com/en/3.1/ref/models/options/

下面是基于上面的一个事例

创建一个model:

class BookDetails(models.Model):
    # AutoField 类型，自动增长的主键
    id = models.AutoField(primary_key=True)
    # BigAutoField 类型，64位的自动增长的主键
    #big_id = models.BigAutoField(primary_key=False)
    # BooleanField 类型
    is_published = models.BooleanField(default=True)
    # CharField 类型，需要指定最大长度
    title = models.CharField(max_length=100)
    # DateField 类型
    publish_date = models.DateField(auto_now_add=True)
    # DateTimeField 类型
    last_modified = models.DateTimeField(auto_now=True)
    # TimeField 类型
    publish_time = models.TimeField()
    # EmailField 类型
    author_email = models.EmailField()
    # FileField 类型，用于存储文件
    document = models.FileField(upload_to='documents/')
    # ImageField 类型，用于存储图片
    cover_image = models.ImageField(upload_to='images/')
    # FloatField 类型
    rating = models.FloatField()
    # IntegerField 类型
    page_count = models.IntegerField()
    # BigIntegerField 类型
    big_integer = models.BigIntegerField()
    # PositiveIntegerField 类型
    positive_integer = models.PositiveIntegerField()
    # SmallIntegerField 类型
    small_integer = models.SmallIntegerField()
    # PositiveSmallIntegerField 类型
    positive_small_integer = models.PositiveSmallIntegerField()
    # TextField 类型
    description = models.TextField()
    # UUIDField 类型
    uuid = models.UUIDField()
    # URLField 类型
    website = models.URLField(max_length=200)

    class Meta:
        # 指定模型映射到数据库中的表名
        db_table = 'book_details'
        # 指定提取数据的排序方式
        ordering = ['publish_date']

    def __str__(self):
        return self.title

上面使用了 ImageField，但没有安装 Pillow 库。Pillow 是一个用于处理图像的 Python 库，Django 依赖它来处理 ImageField 类型。

pip install Pillow

运行以下命令，使用清华大学的 PyPI 镜像来安装 Pillow

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple Pillow

运行数据库映射和同步命令

python manage.py makemigrations
python mange.py migrate

创建后可以在数据库中看到

增加一条数据事例：

from .models import BookDetails

from datetime import datetime
    import uuid

    # 创建 Book 实例
    book_instance = BookDetails(
        title='示例书籍',
        is_published=True,
        publish_date=datetime(2023, 1, 1),
        last_modified=datetime.now(),
        publish_time=datetime.now().time(),
        author_email='author@example.com',
        document='path/to/your/document.pdf',
        cover_image='path/to/your/cover_image.jpg',
        rating=4.5,
        page_count=300,
        big_integer=9223372036854775807,
        positive_integer=2147483647,
        small_integer=32767,
        positive_small_integer=32767,
        description='这是一本示例书籍的详细描述。',
        uuid=uuid.uuid4(),
        website='https://www.example.com'
    )
    # 保存实例到数据库
    book_instance.save()

创建后数据库里面的数据：