Django—Model操作
Posted 三百六十行，行行转IT
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Django—Model操作相关的知识，希望对你有一定的参考价值。
Django 模型是与数据库相关的，与数据库相关的代码一般写在 models.py 中，Django 支持 Sqlite3、mysql、PostgreSQL 等数据库，只需要在 settings.py 中配置即可，不用更改 models.py 中的代码，丰富的 API 极大的方便了使用。
一、创建表
1. 基本结构
1 from django.db import models 2 3 class UserInfo(models.Model): 4 #若不指定主键，则会自动创建int类型的id列为主键 5 name = models.CharField(max_length=30) 6 email = models.EmailField() 7 memo = models.TextField()
写完models.py文件后，执行以下命令即可在相应的数据库中创建表：
$ python3 manage.py makemigrations
$ python3 manage.py migrate
- 字段
1 AutoField(Field) 2 - int自增列，必须填入参数 primary_key=True 3 4 BigAutoField(AutoField) 5 - bigint自增列，必须填入参数 primary_key=True 6 7 注：当model中如果没有自增列，则自动会创建一个列名为id的列 8 9 from django.db import models 10 11 class UserInfo(models.Model): 12 # 自动创建一个列名为id的且为自增的整数列 13 username = models.CharField(max_length=32) 14 15 class Group(models.Model): 16 # 自定义自增列 17 nid = models.AutoField(primary_key=True) 18 name = models.CharField(max_length=32) 19 20 SmallIntegerField(IntegerField): 21 - 小整数 -32768 ～ 32767 22 23 PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) 24 - 正小整数 0 ～ 32767 25 26 IntegerField(Field) 27 - 整数列(有符号的) -2147483648 ～ 2147483647 28 29 PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField) 30 - 正整数 0 ～ 2147483647 31 32 BigIntegerField(IntegerField): 33 - 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807 34 35 BooleanField(Field) 36 - 布尔值类型 37 38 NullBooleanField(Field): 39 - 可以为空的布尔值 40 41 CharField(Field) 42 - 字符类型 43 - 必须提供max_length参数， max_length表示字符长度 44 45 TextField(Field) 46 - 文本类型 47 48 EmailField(CharField)： 49 - 字符串类型，Django Admin以及ModelForm中提供验证机制 50 51 IPAddressField(Field) 52 - 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制 53 54 GenericIPAddressField(Field) 55 - 字符串类型，Django Admin以及ModelForm中提供验证 Ipv4和Ipv6 56 - 参数： 57 protocol，用于指定Ipv4或Ipv6， \'both\',"ipv4","ipv6" 58 unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启刺功能，需要protocol="both" 59 60 URLField(CharField) 61 - 字符串类型，Django Admin以及ModelForm中提供验证 URL 62 63 SlugField(CharField) 64 - 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号） 65 66 CommaSeparatedIntegerField(CharField) 67 - 字符串类型，格式必须为逗号分割的数字 68 69 UUIDField(Field) 70 - 字符串类型，Django Admin以及ModelForm中提供对UUID格式的验证 71 72 FilePathField(Field) 73 - 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能 74 - 参数： 75 path, 文件夹路径 76 match=None, 正则匹配 77 recursive=False, 递归下面的文件夹 78 allow_files=True, 允许文件 79 allow_folders=False, 允许文件夹 80 81 FileField(Field) 82 - 字符串，路径保存在数据库，文件上传到指定目录 83 - 参数： 84 upload_to = "" 上传文件的保存路径 85 storage = None 存储组件，默认django.core.files.storage.FileSystemStorage 86 87 ImageField(FileField) 88 - 字符串，路径保存在数据库，文件上传到指定目录 89 - 参数： 90 upload_to = "" 上传文件的保存路径 91 storage = None 存储组件，默认django.core.files.storage.FileSystemStorage 92 width_field=None, 上传图片的高度保存的数据库字段名（字符串） 93 height_field=None 上传图片的宽度保存的数据库字段名（字符串） 94 95 DateTimeField(DateField) 96 - 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ] 97 98 DateField(DateTimeCheckMixin, Field) 99 - 日期格式 YYYY-MM-DD 100 101 TimeField(DateTimeCheckMixin, Field) 102 - 时间格式 HH:MM[:ss[.uuuuuu]] 103 104 DurationField(Field) 105 - 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型 106 107 FloatField(Field) 108 - 浮点型 109 110 DecimalField(Field) 111 - 10进制小数 112 - 参数： 113 max_digits，小数总长度 114 decimal_places，小数位长度 115 116 BinaryField(Field) 117 - 二进制类型
1 自定义无符号整数字段 2 3 class UnsignedIntegerField(models.IntegerField): 4 def db_type(self, connection): 5 return \'integer UNSIGNED\' 6 7 PS: 返回值为字段在数据库中的属性，Django字段默认的值为： 8 \'AutoField\': \'integer AUTO_INCREMENT\', 9 \'BigAutoField\': \'bigint AUTO_INCREMENT\', 10 \'BinaryField\': \'longblob\', 11 \'BooleanField\': \'bool\', 12 \'CharField\': \'varchar(%(max_length)s)\', 13 \'CommaSeparatedIntegerField\': \'varchar(%(max_length)s)\', 14 \'DateField\': \'date\', 15 \'DateTimeField\': \'datetime\', 16 \'DecimalField\': \'numeric(%(max_digits)s, %(decimal_places)s)\', 17 \'DurationField\': \'bigint\', 18 \'FileField\': \'varchar(%(max_length)s)\', 19 \'FilePathField\': \'varchar(%(max_length)s)\', 20 \'FloatField\': \'double precision\', 21 \'IntegerField\': \'integer\', 22 \'BigIntegerField\': \'bigint\', 23 \'IPAddressField\': \'char(15)\', 24 \'GenericIPAddressField\': \'char(39)\', 25 \'NullBooleanField\': \'bool\', 26 \'OneToOneField\': \'integer\', 27 \'PositiveIntegerField\': \'integer UNSIGNED\', 28 \'PositiveSmallIntegerField\': \'smallint UNSIGNED\', 29 \'SlugField\': \'varchar(%(max_length)s)\', 30 \'SmallIntegerField\': \'smallint\', 31 \'TextField\': \'longtext\', 32 \'TimeField\': \'time\', 33 \'UUIDField\': \'char(32)\',
- 参数
1 null 数据库中字段是否可以为空 2 db_column 数据库中字段的列名 3 default 数据库中字段的默认值 4 primary_key 数据库中字段是否为主键 5 db_index 数据库中字段是否可以建立索引 6 unique 数据库中字段是否可以建立唯一索引 7 unique_for_date 数据库中字段【日期】部分是否可以建立唯一索引 8 unique_for_month 数据库中字段【月】部分是否可以建立唯一索引 9 unique_for_year 数据库中字段【年】部分是否可以建立唯一索引 10 11 verbose_name Admin中显示的字段名称 12 blank Admin中是否允许用户输入为空 13 editable Admin中是否可以编辑 14 help_text Admin中该字段的提示信息 15 choices Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作 16 如：gf = models.IntegerField(choices=[(0, \'何穗\'),(1, \'大表姐\'),],default=1) 17 18 error_messages 自定义错误信息（字典类型），从而定制想要显示的错误信息； 19 字典健：null, blank, invalid, invalid_choice, unique, and unique_for_date 20 如：{\'null\': "不能为空.", \'invalid\': \'格式错误\'} 21 22 validators 自定义错误验证（列表类型），从而定制想要的验证规则 23 from django.core.validators import RegexValidator 24 from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\\ 25 MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator 26 如： 27 test = models.CharField( 28 max_length=32, 29 error_messages={ 30 \'c1\': \'优先错信息1\', 31 \'c2\': \'优先错信息2\', 32 \'c3\': \'优先错信息3\', 33 }, 34 validators=[ 35 RegexValidator(regex=\'root_\\d+\', message=\'错误了\', code=\'c1\'), 36 RegexValidator(regex=\'root_112233\\d+\', message=\'又错误了\', code=\'c2\'), 37 EmailValidator(message=\'又错误了\', code=\'c3\'), ] 38 )
- 元信息
1 class UserInfo(models.Model): 2 nid = models.AutoField(primary_key=True) 3 username = models.CharField(max_length=32) 4 class Meta: 5 # 数据库中生成的表名称 默认 app名称 + 下划线 + 类名 6 db_table = "table_name" 7 8 # 联合索引 9 index_together = [ 10 ("pub_date", "deadline"), 11 ] 12 13 # 联合唯一索引 14 unique_together = (("driver", "restaurant"),) 15 16 # admin中显示的表名称 17 verbose_name 18 19 # verbose_name加s 20 verbose_name_plural
- 触发Model中的验证及错误提示
1 1.触发Model中的验证和错误提示有两种方式： 2 a.Django 3 Admin中的错误信息会优先根据Admiin内部的ModelForm错误信息提示，如果都成功，才来检查Model的字段并显示指定错误信息 4 b.调用Model对象的 5 clean_fields 6 方法，如： 7 # models.py 8 class UserInfo(models.Model): 9 nid = models.AutoField(primary_key=True) 10 username = models.CharField(max_length=32) 11 12 email = models.EmailField(error_messages={\'invalid\': \'格式错了.\'}) 13 14 # views.py 15 def index(request): 16 obj = models.UserInfo(username=\'11234\', email=\'uu\') 17 try: 18 print(obj.clean_fields()) 19 except Exception as e: 20 print(e) 21 return HttpResponse(\'ok\') 22 23 # Model的clean方法是一个钩子，可用于定制操作，如：上述的异常处理。 24 25 26 2.Admin中修改错误提示 27 # admin.py 28 from django.contrib import admin 29 from model_club import models 30 from django import forms 31 32 33 class UserInfoForm(forms.ModelForm): 34 username = forms.CharField(error_messages={\'required\': \'用户名不能为空.\'}) 35 email = forms.EmailField(error_messages={\'invalid\': \'邮箱格式错误.\'}) 36 age = forms.IntegerField(initial=1, error_messages={\'required\': \'请输入数值.\', \'invalid\': \'年龄必须为数值.\'}) 37 38 class Meta: 39 model = models.UserInfo 40 # fields = (\'username\',) 41 fields = "__all__" 42 43 44 class UserInfoAdmin(admin.ModelAdmin): 45 form = UserInfoForm 46 47 48 admin.site.register(models.UserInfo, UserInfoAdmin)
更多：https://docs.djangoproject.com/en/1.10/ref/models/options/
2. 连表结构
- 一对多：models.ForeignKey(其他表)
- 多对多：models.ManyToManyField(其他表)
- 一对一：models.OneToOneField(其他表)
应用场景：
一对多：当一张表中创建一行数据时，有一个单选的下拉框（可以被重复选择）
例如：创建用户信息时候，需要选择一个用户类型【普通用户】【金牌用户】【铂金用户】等
多对多：在某表中创建一行数据是，有一个可以多选的下拉框
例如：创建用户信息，需要为用户指定多个爱好
一对一：在某表中创建一行数据时，有一个单选的下拉框（下拉框中的内容被用过一次就消失了
例如：原有含10列数据的一张表保存相关信息，经过一段时间之后，10列无法满足需求，需要为原来的表再添加5列数据
1 ForeignKey(ForeignObject) # ForeignObject(RelatedField) 2 to, # 要进行关联的表名 3 to_field = None, # 要关联的表中的字段名称 4 on_delete = None, # 当删除关联表中的数据时，当前表与其关联的行的行为 5 - models.CASCADE，删除关联数据，与之关联也删除 6 - models.DO_NOTHING，删除关联数据，引发错误IntegrityError 7 - models.PROTECT，删除关联数据，引发错误ProtectedError 8 - models.SET_NULL，删除关联数据，与之关联的值设置为null（前提FK字段需要设置为可空） 9 - models.SET_DEFAULT，删除关联数据，与之关联的值设置为默认值（前提FK字段需要设置默认值） 10 - models.SET，删除关联数据， 11 a.与之关联的值设置为指定值，设置：models.SET(值) 12 b.与之关联的值设置为可执行对象的返回值，设置：models.SET(可执行对象) 13 14 def func(): 15 return 10 16 17 class MyModel(models.Model): 18 user = models.ForeignKey( 19 to="User", 20 to_field="id" 21 on_delete = models.SET(func),) 22 23 related_name = None, # 反向操作时，使用的字段名，用于代替 【表名_set】 如： obj.表名_set.all() 24 related_query_name = None, # 反向操作时，使用的连接前缀，用于替换【表名】 如： models.UserGroup.objects.filter(表名__字段名=1).values(\'表名__字段名\') 25 limit_choices_to = None, # 在Admin或ModelForm中显示关联数据时，提供的条件： 26 # 如： 27 - limit_choices_to = {\'nid__gt\': 5} 28 - limit_choices_to = lambda: {\'nid__gt\': 5} 29 30 from django.db.models import Q 31 - limit_choices_to = Q(nid__gt=10) 32 - limit_choices_to = Q(nid=8) | Q(nid__gt=10) 33 - limit_choices_to = lambda: Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption=\'root\') 34 db_constraint = True # 是否在数据库中创建外键约束 35 parent_link = False # 在Admin中是否显示关联数据 36 37 OneToOneField(ForeignKey) 38 to, # 要进行关联的表名 39 to_field = None # 要关联的表中的字段名称 40 on_delete = None, # 当删除关联表中的数据时，当前表与其关联的行的行为 41 42 ###### 对于一对一 ###### 43 # 1. 一对一其实就是 一对多 + 唯一索引 44 # 2.当两个类之间有继承关系时，默认会创建一个一对一字段 45 # 如下会在A表中额外增加一个c_ptr_id列且唯一： 46 class C(models.Model): 47 nid = models.AutoField(primary_key=True) 48 part = models.CharField(max_length=12) 49 50 class A(C): 51 id = models.AutoField(primary_key=True) 52 code = models.CharField(max_length=1) 53 54 ManyToManyField(RelatedField) 55 to, # 要进行关联的表名 56 related_name = None, # 反向操作时，使用的字段名，用于代替 【表名_set】 如： obj.表名_set.all() 57 related_query_name = None, # 反向操作时，使用的连接前缀，用于替换【表名】 如： models.UserGroup.objects.filter(表名__字段名=1).values(\'表名__字段名\') 58 limit_choices_to = None, # 在Admin或ModelForm中显示关联数据时，提供的条件： 59 # 如： 60 - limit_choices_to = {\'nid__gt\': 5} 61 - limit_choices_to = lambda: {\'nid__gt\': 5} 62 63 from django.db.models import Q 64 - limit_choices_to = Q(nid__gt=10) 65 - limit_choices_to = Q(nid=8) | Q(nid__gt=10) 66 - limit_choices_to = lambda: Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption=\'root\'以上是关于Django—Model操作的主要内容，如果未能解决你的问题，请参考以下文章