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_112233d+', 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)
触发Model验证及错误提示

更多: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')
 67 symmetrical = None,  # 仅用于多对多自关联时,symmetrical用于指定内部是否创建反向操作的字段
 68 # 做如下操作时,不同的symmetrical会有不同的可选字段
 69 models.BB.objects.filter(...)
 70 
 71 # 可选字段有:code, id, m1
 72 class BB(models.Model):
 73     code = models.CharField(max_length=12)
 74     m1 = models.ManyToManyField('self', symmetrical=True)
 75 
 76 # 可选字段有: bb, code, id, m1
 77 class BB(models.Model):
 78     code = models.CharField(max_length=12)
 79     m1 = models.ManyToManyField('self', symmetrical=False) 
 80     through = None,  # 自定义第三张表时,使用字段用于指定关系表
 81     through_fields = None,  # 自定义第三张表时,使用字段用于指定关系表中那些字段做多对多关系表
 82 from django.db import models
 83 
 84 class Person(models.Model):
 85     name = models.CharField(max_length=50)
 86 
 87 class Group(models.Model):
 88     name = models.CharField(max_length=128)
 89     members = models.ManyToManyField(
 90         Person,
 91         through='Membership',
 92         through_fields=('group', 'person'),
 93     )
 94 
 95 class Membership(models.Model):
 96     group = models.ForeignKey(Group, on_delete=models.CASCADE)
 97     person = models.ForeignKey(Person, on_delete=models.CASCADE)
 98     inviter = models.ForeignKey(
 99         Person,
100         on_delete=models.CASCADE,
101         related_name="membership_invites",
102     )
103     invite_reason = models.CharField(max_length=64)
104 
105 db_constraint = True,  # 是否在数据库中创建外键约束
106 db_table = None,  # 默认创建第三张表时,数据库中表的名称
字段以及参数

二、操作表

1. 基本操作

 1 #
 2 #
 3 # models.Tb1.objects.create(c1='xx', c2='oo')  增加一条数据,可以接受字典类型数据 **kwargs
 4 
 5 # obj = models.Tb1(c1='xx', c2='oo')
 6 # obj.save()
 7 
 8 #
 9 #
10 # models.Tb1.objects.get(id=123)         # 获取单条数据,不存在则报错(不建议)
11 # models.Tb1.objects.all()               # 获取全部
12 # models.Tb1.objects.filter(name='seven') # 获取指定条件的数据
13 
14 #
15 #
16 # models.Tb1.objects.filter(name='seven').delete() # 删除指定条件的数据
17 
18 #
19 # models.Tb1.objects.filter(name='seven').update(gender='0')  # 将指定条件的数据更新,均支持 **kwargs
20 # obj = models.Tb1.objects.get(id=1)
21 # obj.c1 = '111'
22 # obj.save()                                                 # 修改单条数据
基本操作

2. 进阶操作

利用双下划线“__”将字段和对应的操作连接起来

 1 # 获取个数
 2 #
 3 # models.Tb1.objects.filter(name='seven').count()
 4 
 5 # 大于,小于
 6 #
 7 # models.Tb1.objects.filter(id__gt=1)              # 获取id大于1的值
 8 # models.Tb1.objects.filter(id__gte=1)              # 获取id大于等于1的值
 9 # models.Tb1.objects.filter(id__lt=10)             # 获取id小于10的值
10 # models.Tb1.objects.filter(id__lte=10)             # 获取id小于等于10的值
11 # models.Tb1.objects.filter(id__lt=10, id__gt=1)   # 获取id大于1 且 小于10的值
12 
13 # in
14 #
15 # models.Tb1.objects.filter(id__in=[11, 22, 33])   # 获取id等于11、22、33的数据
16 # not in
17 # models.Tb1.objects.exclude(id__in=[11, 22, 33])  # not in
18 
19 # isnull
20 # Entry.objects.filter(pub_date__isnull=True)
21 
22 # contains
23 #
24 # models.Tb1.objects.filter(name__contains="ven")  # 区分大小写
25 # models.Tb1.objects.filter(name__icontains="ven") # icontains大小写不敏感
26 # models.Tb1.objects.exclude(name__icontains="ven")    # 不包含“ven”
27 
28 # range
29 #
30 # models.Tb1.objects.filter(id__range=[1, 2])   # 闭区间范围bettwen and
31 
32 # 其他类似
33 #
34 # startswith,istartswith, endswith, iendswith,
35 
36 # order by
37 #
38 # models.Tb1.objects.filter(name='seven').order_by('id')    # asc
39 # models.Tb1.objects.filter(name='seven').order_by('-id')   # desc
40 
41 # group by
42 #
43 # from django.db.models import Count, Min, Max, Sum
44 # models.Tb1.objects.filter(c1=1).values('id').annotate(c=Count('num'))
45 # SELECT "app01_tb1"."id", COUNT("app01_tb1"."num") AS "c" FROM "app01_tb1" WHERE "app01_tb1"."c1" = 1 GROUP BY "app01_tb1"."id"
46 
47 # limit 、offset
48 #
49 # models.Tb1.objects.all()[10:20]    # 左闭右开
50 
51 # regex正则匹配,iregex 不区分大小写
52 #
53 # Entry.objects.get(title__regex=r'^(An?|The) +')
54 # Entry.objects.get(title__iregex=r'^(an?|the) +')
55 
56 # date
57 #
58 # Entry.objects.filter(pub_date__date=datetime.date(2005, 1, 1))
59 # Entry.objects.filter(pub_date__date__gt=datetime.date(2005, 1, 1))
60 
61 # year
62 #
63 # Entry.objects.filter(pub_date__year=2005)
64 # Entry.objects.filter(pub_date__year__gte=2005)
65 
66 # month
67 #
68 # Entry.objects.filter(pub_date__month=12)
69 # Entry.objects.filter(pub_date__month__gte=6)
70 
71 # day
72 #
73 # Entry.objects.filter(pub_date__day=3)
74 # Entry.objects.filter(pub_date__day__gte=3)
75 
76 # week_day
77 #
78 # Entry.objects.filter(pub_date__week_day=2)
79 # Entry.objects.filter(pub_date__week_day__gte=2)
80 
81 # hour
82 #
83 # Event.objects.filter(timestamp__hour=23)
84 # Event.objects.filter(time__hour=5)
85 # Event.objects.filter(timestamp__hour__gte=12)
86 
87 # minute
88 #
89 # Event.objects.filter(timestamp__minute=29)
90 # Event.objects.filter(time__minute=46)
91 # Event.objects.filter(timestamp__minute__gte=29)
92 
93 # second
94 #
95 # Event.objects.filter(timestamp__second=31)
96 # Event.objects.filter(time__second=2)
97 # Event.objects.filter(timestamp__second__gte=31)
进阶操作

3. 高级操作

 1 # extra
 2 #
 3 # extra(self, select=None, where=None, params=None, tables=None, order_by=None, select_params=None)
 4 #    Entry.objects.extra(select={'new_id': "select col from sometable where othercol > %s"}, select_params=(1,))
 5 #    Entry.objects.extra(where=['headline=%s'], params=['Lennon'])
 6 #    Entry.objects.extra(where=["foo='a' OR bar = 'a'", "baz = 'a'"])
 7 #    Entry.objects.extra(select={'new_id': "select id from tb where id > %s"}, select_params=(1,), order_by=['-nid'])
 8 
 9     models.UserInfo.objects.extra(
10         select={'newid':'select count(1) from app01_usertype where id>%s'},
11         select_params=[1,],
12         where = ['age>%s'],
13         params=[18,],
14         order_by=['-age'],
15         tables=['app01_usertype']
16     )
17     """
18     select 
19         app01_userinfo.id,
20         # select 映射
21         (select count(1) from app01_usertype where id>1) as newid
22     # tables 连表
23     from app01_userinfo,app01_usertype
24     # 条件
25     where 
26         app01_userinfo.age > 18
27     # 排序
28     order by 
29         app01_userinfo.age desc
30     """
31 
32 
33 # F
34 # 更新时用于获取原来的值
35 # from django.db.models import F
36 # models.Tb1.objects.update(num=F('num')+1)
37 
38 
39 # Q
40 # 用于构造复杂查询条件
41 # from django.db.models import Q
42 # 方式一:
43 # Q(nid__gt=10)
44 # Q(nid=8) | Q(nid__gt=10)
45 # Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption='root')
46 
47 # 方式二:
48 # con = Q()
49 
50 # q1 = Q()
51 # q1.connector = 'OR'
52 # q1.children.append(('id', 1))
53 # q1.children.append(('id', 10))
54 # q1.children.append(('id', 9))
55 
56 # q2 = Q()
57 # q2.connector = 'OR'
58 # q2.children.append(('c1', 1))
59 # q2.children.append(('c1', 10))
60 # q2.children.append(('c1', 9))
61 
62 # con.add(q1, 'AND')
63 # con.add(q2, 'AND')
64 #
65 # models.Tb1.objects.filter(con)
66 
67 
68 # 执行原生SQL
69 #
70 # from django.db import connection, connections
71 # cursor = connection.cursor()  # cursor = connections['default'].cursor()
72 # cursor.execute("""SELECT * from auth_user where id = %s""", [1])
73 # row = cursor.fetchone()
高级操作

4. 其它操作

  1 ##################################################################
  2 # PUBLIC METHODS THAT ALTER ATTRIBUTES AND RETURN A NEW QUERYSET #
  3 ##################################################################
  4 
  5 def all(self)
  6     # 获取所有的数据对象
  7 
  8 def filter(self, *args, **kwargs)
  9     # 条件查询
 10     # 条件可以是:参数,字典,Q
 11 
 12 def exclude(self, *args, **kwargs)
 13     # 条件查询
 14     # 条件可以是:参数,字典,Q
 15 
 16 def select_related(self, *fields)
 17      性能相关:表之间进行join连表操作,一次性获取关联的数据。
 18      model.tb.objects.all().select_related()
 19      model.tb.objects.all().select_related('外键字段')
 20      model.tb.objects.all().select_related('外键字段__外键字段')
 21 
 22 def prefetch_related(self, *lookups)
 23     性能相关:多表连表操作时速度会慢,使用其执行多次SQL查询在Python代码中实现连表操作。
 24             # 获取所有用户表
 25             # 获取用户类型表where id in (用户表中的查到的所有用户ID)
 26             models.UserInfo.objects.prefetch_related('外键字段')
 27 
 28             from django.db.models import Count, Case, When, IntegerField
 29             Article.objects.annotate(
 30                 numviews=Count(Case(
 31                     When(readership__what_time__lt=treshold, then=1),
 32                     output_field=CharField(),
 33                 ))
 34             )
 35 
 36             students = Student.objects.all().annotate(num_excused_absences=models.Sum(
 37                 models.Case(
 38                     models.When(absence__type='Excused', then=1),
 39                 default=0,
 40                 output_field=models.IntegerField()
 41             )))
 42 
 43 def annotate(self, *args, **kwargs)
 44     # 用于实现聚合group by查询
 45 
 46     from django.db.models import Count, Avg, Max, Min, Sum
 47 
 48     v = models.UserInfo.objects.values('u_id').annotate(uid=Count('u_id'))
 49     # SELECT u_id, COUNT(ui) AS `uid` FROM UserInfo GROUP BY u_id
 50 
 51     v = models.UserInfo.objects.values('u_id').annotate(uid=Count('u_id')).filter(uid__gt=1)
 52     # SELECT u_id, COUNT(ui_id) AS `uid` FROM UserInfo GROUP BY u_id having count(u_id) > 1
 53 
 54     v = models.UserInfo.objects.values('u_id').annotate(uid=Count('u_id',distinct=True)).filter(uid__gt=1)
 55     # SELECT u_id, COUNT( DISTINCT ui_id) AS `uid` FROM UserInfo GROUP BY u_id having count(u_id) > 1
 56 
 57 def distinct(self, *field_names)
 58     # 用于distinct去重
 59     models.UserInfo.objects.values('nid').distinct()
 60     # select distinct nid from userinfo
 61 
 62     注:只有在PostgreSQL中才能直接使用distinct进行去重,其它数据库都应在values之后使用
 63 
 64 def order_by(self, *field_names)
 65     # 用于排序
 66     models.UserInfo.objects.all().order_by('-id','age')
 67 
 68 def extra(self, select=None, where=None, params=None, tables=None, order_by=None, select_params=None)
 69     # 构造额外的查询条件或者映射,如:子查询
 70 
 71     Entry.objects.extra(select={'new_id': "select col from sometable where othercol > %s"}, select_params=(1,))
 72     Entry.objects.extra(where=['headline=%s'], params=['Lennon'])
 73     Entry.objects.extra(where=["foo='a' OR bar = 'a'", "baz = 'a'"])
 74     Entry.objects.extra(select={'new_id': "select id from tb where id > %s"}, select_params=(1,), order_by=['-nid'])
 75 
 76  def reverse(self):
 77     # 倒序
 78     models.UserInfo.objects.all().order_by('-nid').reverse()
 79     # 注:如果存在order_by,reverse则是倒序,如果多个排序则一一倒序
 80 
 81 
 82  def defer(self, *fields):
 83     models.UserInfo.objects.defer('username','id')
 84  85     models.UserInfo.objects.filter(...).defer('username','id')
 86     #映射中排除某列数据
 87 
 88  def only(self, *fields):
 89     #仅取某个表中的数据
 90      models.UserInfo.objects.only('username','id')
 91  92      models.UserInfo.objects.filter(...).only('username','id')
 93 
 94  def using(self, alias):
 95      指定使用的数据库,参数为别名(setting中的设置)
 96 
 97 
 98 ##################################################
 99 # PUBLIC METHODS THAT RETURN A QUERYSET SUBCLASS #
100 ##################################################
101 
102 def raw(self, raw_query, params=None, translations=None, using=None):
103     # 执行原生SQL
104     models.UserInfo.objects.raw('select * from userinfo')
105 
106     # 如果SQL是其他表时,必须将名字设置为当前UserInfo对象的主键列名
107     models.UserInfo.objects.raw('select id as nid from 其他表')
108 
109     # 为原生SQL设置参数
110     models.UserInfo.objects.raw('select id as nid from userinfo where nid>%s', params=[12,])
111 
112     # 将获取的列名转换为指定列名
113     name_map = {'first': 'first_name', 'last': 'last_name', 'bd': 'birth_date', 'pk': 'id'}
114     Person.objects.raw('SELECT * FROM some_other_table', translations=name_map)
115 
116     # 指定数据库
117     models.UserInfo.objects.raw('select * from userinfo', using="default")
118 
119     ################### 原生SQL ###################
120     from django.db import connection, connections
121     cursor = connection.cursor()  # cursor = connections['default'].cursor()
122     cursor.execute("""SELECT * from auth_user where id = %s""", [1])
123     row = cursor.fetchone() # fetchall()/fetchmany(..)
124 
125 
126 def values(self, *fields):
127     # 获取每行数据为字典格式
128 
129 def values_list(self, *fields, **kwargs):
130     # 获取每行数据为元祖
131 
132 def dates(self, field_name, kind, order='ASC'):
133     # 根据时间进行某一部分进行去重查找并截取指定内容
134     # kind只能是:"year"(年), "month"(年-月), "day"(年-月-日)
135     # order只能是:"ASC"  "DESC"
136     # 并获取转换后的时间
137         - year : 年-01-01
138         - month: 年-月-01
139         - day  : 年-月-140 
141     models.DatePlus.objects.dates('ctime','day','DESC')
142 
143 def datetimes(self, field_name, kind, order='ASC', tzinfo=None):
144     # 根据时间进行某一部分进行去重查找并截取指定内容,将时间转换为指定时区时间
145     # kind只能是 "year", "month", "day", "hour", "minute", "second"
146     # order只能是:"ASC"  "DESC"
147     # tzinfo时区对象
148     models.DDD.objects.datetimes('ctime','hour',tzinfo=pytz.UTC)
149     models.DDD.objects.datetimes('ctime','hour',tzinfo=pytz.timezone('Asia/Shanghai'))
150 
151     """
152     pip3 install pytz
153     import pytz
154     pytz.all_timezones
155     pytz.timezone(‘Asia/Shanghai’)
156     """
157 
158 def none(self):
159     # 空QuerySet对象
160 
161 
162 ####################################
163 # METHODS THAT DO DATABASE QUERIES #
164 ####################################
165 
166 def aggregate(self, *args, **kwargs):
167    # 聚合函数,获取字典类型聚合结果
168    from django.db.models import Count, Avg, Max, Min, Sum
169    result = models.UserInfo.objects.aggregate(k=Count('u_id', distinct=True), n=Count('nid'))
170    ===> {'k': 3, 'n': 4}
171 
172 def count(self):
173    # 获取个数
174 
175 def get(self, *args, **kwargs):
176    # 获取单个对象
177 
178 def create(self, **kwargs):
179    # 创建对象
180 
181 def bulk_create(self, objs, batch_size=None):
182     # 批量插入
183     # batch_size表示一次插入的个数
184     objs = [
185         models.DDD(name='r11'),
186         models.DDD(name='r22')
187     ]
188     models.DDD.objects.bulk_create(objs, 10)
189 
190 def get_or_create(self, defaults=None, **kwargs):
191     # 如果存在,则获取,否则,创建
192     # defaults 指定创建时,其他字段的值
193     obj, created = models.UserInfo.objects.get_or_create(username='root1', defaults={'email': '1111111','u_id': 2, 't_id': 2})
194 
195 def update_or_create(self, defaults=None, **kwargs):
196     # 如果存在,则更新,否则,创建
197     # defaults 指定创建时或更新时的其他字段
198     obj, created = models.UserInfo.objects.update_or_create(username='root1', defaults={'email': '1111111','u_id': 2, 't_id': 1})
199 
200 def first(self):
201    # 获取第一个
202 
203 def last(self):
204    # 获取最后一个
205 
206 def in_bulk(self, id_list=None):
207    # 根据主键ID进行查找
208    id_list = [11,21,31]
209    models.DDD.objects.in_bulk(id_list)
210 
211 def delete(self):
212    # 删除
213 
214 def update(self, **kwargs):
215     # 更新
216 
217 def exists(self):
218    # 是否有结果
其他操作

三、实例

1. 具有ForeignKey的跨表操作

 1 from django.db import models
 2 
 3 
 4 class Foo(models.Model):
 5     caption = models.CharField(max_length=16)
 6 
 7 
 8 class UserType(models.Model):
 9     type = models.CharField(max_length=16)
10     uf = models.ForeignKey(Foo)
11 
12 
13 class UserInfo(models.Model):
14     name = models.CharField(max_length=16)
15     age = models.IntegerField()
16     ut = models.ForeignKey(UserType)
表结构

正向操作

 1 # views.py
 2 
 3 def test(request):
 4     f1 = models.UserInfo.objects.filter(id__lt=6)
 5     print('正向obj跨表')
 6     for i in f1:
 7         print(i.name, i.ut_id, i.ut.type)
 8 
 9     f2 = models.UserInfo.objects.values('name', 'ut_id', 'ut__type').filter(id__lt=6)
10     print('
正向values-字典,跨表')
11     for i in f2:
12         print(i)
13 
14     f3 = models.UserInfo.objects.values_list('name', 'ut_id', 'ut__type').filter(id__lt=6)
15     print('
正向values_list-元组,跨表')
16     for i in f3:
17         print(i)
18 
19 
20 #结果:
21 正向obj跨表
22 jack 1 VIP
23 jackson 1 VIP
24 oldjack 2 2B
25 jacky 3 普通
26 jackboy 1 VIP
27 
28 正向values-字典,跨表
29 {'name': 'jack', 'ut_id': 1, 'ut__type': 'VIP'}
30 {'name': 'jackson', 'ut_id': 1, 'ut__type': 'VIP'}
31 {'name': 'oldjack', 'ut_id': 2, 'ut__type': '2B'}
32 {'name': 'jacky', 'ut_id': 3, 'ut__type': '普通'}
33 {'name': 'jackboy', 'ut_id': 1, 'ut__type': 'VIP'}
34 
35 正向values_list-元组,跨表
36 ('jack', 1, 'VIP')
37 ('jackson', 1, 'VIP')
38 ('oldjack', 2, '2B')
39 ('jacky', 3, '普通')
40 ('jackboy', 1, 'VIP')
object,dict,tuple

反向操作

 1 # views.py
 2 
 3 
 4 def test(request):
 5     b1 = models.UserType.objects.all().first()
 6     print('
反向obj跨表')
 7     for i in b1.userinfo_set.all():
 8         print(b1.type, i.name)
 9 
10     b2 = models.UserType.objects.values('type', 'userinfo__name').first()
11     print('
反向values-字典,跨表')
12     print(b2)
13 
14     b3 = models.UserType.objects.values_list('type', 'userinfo__name').first()
15     print('
反向values_list-元组,跨表')
16     print(b3)
17 
18 
19 #结果
20 反向obj跨表
21 VIP jack
22 VIP jackson
23 VIP jackboy
24 
25 反向values-字典,跨表
26 {'type': 'VIP', 'userinfo__name': 'jack'}
27 
28 反向values_list-元组,跨表
29 ('VIP', 'jack')
object,dict,tuple

2. 具有ManytoManyField的跨表操作

  • 2.1 表结构:只使用ManytoManyField参数
  •  1 from django.db import models
     2 
     3 
     4 class Boys(models.Model):
     5     name = models.CharField(max_length=32)
     6     password = models.CharField(max_length=64, default=123)
     7 
     8 
     9 class Girls(models.Model):
    10     name = models.CharField(max_length=32)
    11     password = models.CharField(max_length=64, default=123)
    12     g_b = models.ManyToManyField(Boys)
    models.py
     1 from django.shortcuts import HttpResponse
     2 from app02 import models
     3 
     4 
     5 def test(request):
     6     #正向操作 获取与女孩abby约会过的男生姓名
     7     obj_girl = models.Girls.objects.filter(name='abby').first()
     8     obj_boys = obj_girl.g_b.all()    #
     9     for row in obj_boys:
    10         print(row.name)
    11 
    12     # 反向操作 获取与男孩eric约会过的女生姓名
    13     obj_boy = models.Boys.objects.filter(name='eric').first()
    14     obj_girls = obj_boy.girls_set.all()    # 小写表名_set
    15     for row in obj_girls:
    16         print(row.name)
    17     return HttpResponse('...')
    views.py
  • 2.2 表结构:利用ForeignKey自定义多对多关系表

  •  1 from django.db import models
     2 
     3 
     4 class Boys(models.Model):
     5     name = models.CharField(max_length=32)
     6     password = models.CharField(max_length=64, default=123)
     7 
     8 
     9 class Girls(models.Model):
    10     name = models.CharField(max_length=32)
    11     password = models.CharField(max_length=64, default=123)
    12 
    13 
    14 #自定义男女关系表
    15 class Love(models.Model):
    16     b = models.ForeignKey(Boys)
    17     g = models.ForeignKey(Girls)
    18     class Meta:
    19         unique_together = [
    20             ('b', 'g'),
    21         ]
    models.py
  •  1 from django.shortcuts import HttpResponse
     2 from app01 import models
     3 
     4 
     5 #获取与男孩jack约会过的女孩姓名
     6 def test(request):
     7     obj_boy = models.Boys.objects.filter(name='jack').first()
     8     girls_list = obj_boy.love_set.all()
     9     for row in girls_list:
    10         print(row.g.name)
    11 
    12     obj_girls = models.Love.objects.filter(b__name='jack')
    13     for row in obj_girls:
    14         print(row.g.name)
    15 
    16     value_girls = models.Love.objects.filter(b__name='jack').values('g__name')
    17     for row in value_girls:
    18         print(row['g__name'])
    19 
    20     value_list_girls = models.Love.objects.filter(b__name='jack').values_list('g__name')
    21     for row in value_list_girls:
    22         print(row[0])
    23         
    24     girls_list = models.Love.objects.filter(b__name='jack').select_related('g')
    25     for row in girls_list:
    26         print(row.g.name)
    27     return HttpResponse('...')
    views.py
  • 2.3 表结构:以上混合使用
  •  1 from django.db import models
     2 
     3 
     4 class Boys(models.Model):
     5     name = models.CharField(max_length=32)
     6     password = models.CharField(max_length=64, default=123)
     7 
     8 
     9 class Girls(models.Model):
    10     name = models.CharField(max_length=32)
    11     password = models.CharField(max_length=64, default=123)
    12     m2m = models.ManyToManyField(Boys)
    13 
    14 
    15 class Love(models.Model):
    16     b = models.ForeignKey(Boys)
    17     g = models.ForeignKey(Girls)
    18 
    19     class Meta:
    20         unique_together = [
    21             ('b', 'g'),
    22         ]
    models.py
     1 from django.shortcuts import render,HttpResponse
     2 from app03 import models
     3 
     4 
     5 def test(request):
     6     #为name为timo的女孩添加关系
     7     # obj = models.Girls.objects.filter(name='timo').first()
     8     # print(obj.id, obj.name)
     9     # obj.m2m.add(2)
    10     # obj.m2m.add(2,4)
    11     # obj.m2m.add(*[1,3,5])
    12 
    13     #移除关系
    14     # obj.m2m.remove(1)
    15     # obj.m2m.remove(2,3)
    16     # obj.m2m.remove(*[4,])
    17 
    18     #重置关系
    19     # obj.m2m.set([1,3,5])
    20 
    21     #获取Boys对象
    22     # boys_list = obj.m2m.all()
    23     # for row in boys_list:
    24     #     print(row.name)
    25     
    26     #清空关系
    27     # obj.m2m.clear()
    28     
    29     #反向获取与男孩jack有关系的女孩
    30     # obj = models.Boys.objects.filter(name='jack').first()
    31     # girls_list = obj.girls_set.all()
    32     # for row in girls_list:
    33     #     print(row.name)
    34     return HttpResponse('test')
    views.py

3. 自关联

  • ForeignKey自关联

  •  1 from django.db import models
     2 
     3 
     4 #FK自关联
     5 class Comment(models.Model):
     6     content = models.CharField(max_length=526)      # 主评论
     7     reply_id = models.ForeignKey('self', blank=True, null=True, related_name='reply')   # 回复内容的id
     8     parent_id = models.ForeignKey('self', blank=True, null=True, related_name='parent')     # 回复内容的主id
     9     
    10     
    11 #表结构
    12 """
    13 这是一条新闻。。。。。。。
    14     评论1:写得很好
    15         回复1:同意
    16             回复2:顶楼上
    17     评论2:赞一个
    18     评论3:莫装B
    19         回复1:就服你
    20 """
    models.py
     1 from django.shortcuts import render, HttpResponse
     2 from app04  import models
     3 
     4 
     5 def test(request):
     6     # objs = [
     7         # 先创建这些
     8         # models.Comment(id=1, content='写得不错', ),
     9         # models.Comment(id=2, content='真的吗?', ),
    10         # models.Comment(id=3, content='太了不起了!', ),
    11         # models.Comment(id=4, content='很喜欢', ),
    12         # 再创建这些
    13         # models.Comment(id=5, content='过奖过奖', reply_id_id=1),
    14         # models.Comment(id=6, content='听说的,不过很可信!', reply_id_id=2),
    15         # models.Comment(id=7, content='假的,已经被辟谣了。!', reply_id_id=6),
    16 
    17     # ]
    18     # models.Comment.objects.bulk_create(objs, 10)
    19 
    20     #获取评论1的所有回复
    21     obj1 = models.Comment.objects.filter(id=1).first()
    22     comments = obj1.parent.all()
    23     for row in comments:
    24         print(row.content)
    25 
    26     # 获取评论2的所有回复
    27     obj2 = models.Comment.objects.filter(id=2).first()
    28     comments = obj2.parent.all()
    29     for row in comments:
    30         print(row.content)
    31 
    32     return HttpResponse('test')
    views.py 
  • ManytoManyField自关联

  •  1 from django.db import models
     2 
     3 
     4 
     5 #MK自关联
     6 class User(models.Model):
     7     nickname = models.CharField(max_length=32)
     8     username = models.CharField(max_length=32)
     9     password = models.CharField(max_length=64)
    10     gender_choice = [
    11         (1, ''),
    12         (2, ''),
    13     ]
    14     gender = models.IntegerField(choices=gender_choice)
    15     m = models.ManyToManyField('self', blank=True)
    16 #默认情况下,这种关联关系是对称的,如果想取消这种对称关系,将symmetrical设为False
    models.py
     1 from django.shortcuts import render, HttpResponse
     2 from app04  import models
     3 
     4 
     5 def test(request):
     6     #创建数据
     7     # objs = [
     8     #     models.User(nickname='jack', username='jackupdown', password='123', gender=1),
     9     #     models.User(nickname='mic', username='michael', password='123', gender=1),
    10     #     models.User(nickname='apple', username='anderson', password='123', gender=1),
    11     #     models.User(nickname='prince', username='alice', password='abc', gender=2),
    12     #     models.User(nickname='sweeter', username='tracy', password='abc', gender=2),
    13     #     models.User(nickname='cake', username='angela', password='abc', gender=2),
    14     # ]
    15     #创建关系
    16     # models.User.objects.bulk_create(objs, 10)
    17     # obj_jack = models.User.objects.filter(id=1).first()
    18     # obj_jack.m.add(*[5, 6])
    19     # obj_mic = models.User.objects.filter(id=2).first()
    20     # obj_mic.m.add(*[4, 5, 6])
    21     # obj_cake = models.User.objects.filter(id=6).first()
    22     # obj_cake.m.add(*[1, 3])
    23 
    24     #获取关系
    25     #获取与jack约会的女生
    26     obj_jack = models.User.objects.filter(nickname='jack').first()
    27     girls = obj_jack.m.all()
    28     for row in girls:
    29         print(row.nickname)
    30     #获取与cake约会的男生
    31     obj_cake = models.User.objects.filter(nickname='cake').first()
    32     boys = obj_cake.m.all()
    33     for row in boys:
    34         print(row.nickname)
    35 
    36     return HttpResponse('test')
    views.py

参考资料:

1. Django之Model操作

2. Django文档——Model中的ForeignKey,ManyToManyField与OneToOneField

原文地址:https://www.cnblogs.com/OldJack/p/7085676.html