Django之Model操作数据库

BOYE / 2023-08-09 / 原文

ORM简介

O(objects):类和对象。R(Relation):关系，关系数据库中的表格。M(Mapping):映射。

Django ORM框架的功能：

建立模型类和表之间的对应关系，允许我们通过面向对象的方式来操作数据库。
根据设计的模型类生成数据库中的表格。
通过方便的配置就可以进行数据库的切换。

数据库的配置

#sqlite3,mysql,oracle,postgresql等数据库。Django默认使用的是sqlite3数据库，settigs.py里面
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',#默认使用的数据库引擎是sqlite3，项目自动创建
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),#指定数据库所在的路径
    }
}

#mysql配置
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',#表示使用的是mysql数据库的引擎
        'NAME': 'db1',      #数据库的名字，可以在mysql的提示符下先创建好
        'USER':'root',      #数据库用户名
        'PASSWORD':'123456',      #数据库密码
        'HOST':'',          #数据库主机，留空默认为"localhost"
        'PORT':'3306',      #数据库使用的端口
    }
}

MySQLdb对于py3支持不全,所以这里使用PyMySQL

pip install pymysql

#在项目名文件下的__init__.py文件中写入如下配置
import pymysql
pymysql.install_as_MySQLdb()

创建数据库表结构文件

from django.db import models
#在未指定primary_key的情况下,Django会默认创建一个id自增字段作为主键 
class Account(models.Model):
    account_name = models.CharField(max_length=20)
    account_id = models.IntegerField(primary_key=True)
    balance = models.DecimalField(max_digits=2, decimal_places=2)

执行命令生成到数据库

python manage.py makemigrations 
python manage.py migrate # 生成数据表

数据库字段

AutoField(Field)	- int自增列，必须填入参数 primary_key=True
BigAutoField(AutoField)	- bigint自增列，必须填入参数 primary_key=True
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)- 二进制类型

数据库字段参数

null                数据库中字段是否可以为空
db_column           数据库中字段的列名
default             数据库中字段的默认值
primary_key         数据库中字段是否为主键
db_index            数据库中字段是否可以建立索引
unique              数据库中字段是否可以建立唯一索引
unique_for_date     数据库中字段【日期】部分是否可以建立唯一索引
unique_for_month    数据库中字段【月】部分是否可以建立唯一索引
unique_for_year     数据库中字段【年】部分是否可以建立唯一索引
verbose_name        Admin中显示的字段名称
blank               Admin中是否允许用户输入为空
editable            Admin中是否可以编辑
help_text           Admin中该字段的提示信息
choices             Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作
					如：gf = models.IntegerField(choices=[(0, '何穗'),(1, '大表姐'),],default=1)
error_messages      自定义错误信息（字典类型），从而定制想要显示的错误信息；
					字典健：null, blank, invalid, invalid_choice, unique, and unique_for_date
					如：{'null': "不能为空.", 'invalid': '格式错误'}
validators          自定义错误验证（列表类型），从而定制想要的验证规则
 
from django.core.validators import RegexValidator
from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\
MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator
如：
	test = models.CharField(
		max_length=32,
		error_messages={
			'c1': '优先错信息1',
			'c2': '优先错信息2',
			'c3': '优先错信息3',
		},
		validators=[
			RegexValidator(regex='root_\d+', message='错误了', code='c1'),
			RegexValidator(regex='root_112233\d+', message='又错误了', code='c2'),
			EmailValidator(message='又错误了', code='c3'), ]
 
)

数据库Meta元信息

class UserInfo(models.Model):
        nid = models.AutoField(primary_key=True)
        username = models.CharField(max_length=32)
        class Meta:
            # 数据库中生成的表名称 默认 app名称 + 下划线 + 类名
            db_table = "table_name"
            # 联合索引
            index_together = [
                ("pub_date", "deadline"),
            ]
 
            # 联合唯一索引
            unique_together = (("driver", "restaurant"),)