2.5 模型

2.5.1 ORM介绍

2.5.1.1 ORM概念

对象关系映射（Object Relational Mapping，简称ORM）模式是一种为了解决面向对象与关系数据库存在的互不匹配的现象的技术。

简单的说，ORM是通过使用描述对象和数据库之间映射的元数据，将程序中的对象自动持久化到关系数据库中。

ORM在业务逻辑层和数据库层之间充当了桥梁的作用。

2.5.1.2 ORM由来

让我们从O/R开始。字母O起源于"对象"(Object),而R则来自于"关系"(Relational)。

几乎所有的软件开发过程中都会涉及到对象和关系数据库。在用户层面和业务逻辑层面，我们是面向对象的。当对象的信息发生变化的时候，我们就需要把对象的信息保存在关系数据库中。

按照之前的方式来进行开发就会出现程序员会在自己的业务逻辑代码中夹杂很多SQL语句用来增加、读取、修改、删除相关数据，而这些代码通常都是重复的。

2.5.1.3 ORM的优势

ORM解决的主要问题是对象和关系的映射。它通常把一个类和一个表一一对应，类的每个实例对应表中的一条记录，类的每个属性对应表中的每个字段。

ORM提供了对数据库的映射，不用直接编写SQL代码，只需像操作对象一样从数据库操作数据。

让软件开发人员专注于业务逻辑的处理，提高了开发效率。

2.5.1.4 ORM的劣势

ORM的缺点是会在一定程度上牺牲程序的执行效率。

ORM用多了SQL语句就不会写了，关系数据库相关技能退化...

ORM总结

ORM只是一种工具，工具确实能解决一些重复，简单的劳动。这是不可否认的。

但我们不能指望某个工具能一劳永逸地解决所有问题，一些特殊问题还是需要特殊处理的。

但是在整个软件开发过程中需要特殊处理的情况应该都是很少的，否则所谓的工具也就失去了它存在的意义。

2.5.2 Django中的ORM

2.5.2.1 Django项目使用MySQL数据库

1. 在Django项目的settings.py文件中，配置数据库连接信息：

  1. DATABASES = {
  2.     "default": {
  3.         "ENGINE": "django.db.backends.mysql",
  4.         "NAME": "你的数据库名称",  # 需要自己手动创建数据库
  5.         "USER": "数据库用户名",
  6.         "PASSWORD": "数据库密码",
  7.         "HOST": "数据库IP",
  8.         "POST": 3306
  9.     }
  10. }

2. 在Django项目的__init__.py文件中写如下代码，告诉Django使用pymysql模块连接MySQL数据库:

  1. import pymysql
  2.  
  3. pymysql.install_as_MySQLdb()

2.5.2.2 Model

在Django中model是你数据的单一、明确的信息来源。它包含了你存储的数据的重要字段和行为。通常，一个模型（model）映射到一个数据库表，

基本情况：

  • 每个模型都是一个Python类，它是django.db.models.Model的子类。
  • 模型的每个属性都代表一个数据库字段。
  • 综上所述，Django为您提供了一个自动生成的数据库访问API，详询官方文档链接。

2.5.2.3 快速入门

下面这个例子定义了一个 Person 模型，包含 first_name 和 last_name。

  1. from django.db import models
  2.  
  3. class Person(models.Model):
  4.     first_name = models.CharField(max_length=30)
  5.     last_name = models.CharField(max_length=30)

first_name 和 last_name 是模型的字段。每个字段被指定为一个类属性，每个属性映射到一个数据库列。

上面的 Person 模型将会像这样创建一个数据库表：

  1. CREATE TABLE myapp_person (
  2.     "id" serial NOT NULL PRIMARY KEY,
  3.     "first_name" varchar(30) NOT NULL,
  4.     "last_name" varchar(30) NOT NULL
  5. );

一些说明：

  • 表myapp_person的名称是自动生成的，如果你要自定义表名，需要在model的Meta类中指定 db_table 参数，强烈建议使用小写表名，特别是使用MySQL作为后端数据库时。
  • id字段是自动添加的，如果你想要指定自定义主键，只需在其中一个字段中指定 primary_key=True 即可。如果Django发现你已经明确地设置了Field.primary_key，它将不会添加自动ID列。
  • 本示例中的CREATE TABLE SQL使用PostgreSQL语法进行格式化，但值得注意的是，Django会根据配置文件中指定的数据库后端类型来生成相应的SQL语句。
  • Django支持MySQL5.5及更高版本。

2.5.2.4 字段 

  1.    AutoField(Field)
  2.         - int自增列，必须填入参数 primary_key=True
  3.  
  4.     BigAutoField(AutoField)
  5.         - bigint自增列，必须填入参数 primary_key=True
  6.  
  7.         注：当model中如果没有自增列，则自动会创建一个列名为id的列
  8.         from django.db import models
  9.  
  10.         class UserInfo(models.Model):
  11.             # 自动创建一个列名为id的且为自增的整数列
  12.             username = models.CharField(max_length=32)
  13.  
  14.         class Group(models.Model):
  15.             # 自定义自增列
  16.             nid = models.AutoField(primary_key=True)
  17.             name = models.CharField(max_length=32)
  18.  
  19.     SmallIntegerField(IntegerField):
  20.         - 小整数 -32768 ～ 32767
  21.  
  22.     PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
  23.         - 正小整数 0 ～ 32767
  24.     IntegerField(Field)
  25.         - 整数列(有符号的) -2147483648 ～ 2147483647
  26.  
  27.     PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
  28.         - 正整数 0 ～ 2147483647
  29.  
  30.     BigIntegerField(IntegerField):
  31.         - 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807
  32.  
  33.     BooleanField(Field)
  34.         - 布尔值类型
  35.  
  36.     NullBooleanField(Field):
  37.         - 可以为空的布尔值
  38.  
  39.     CharField(Field)
  40.         - 字符类型
  41.         - 必须提供max_length参数， max_length表示字符长度
  42.  
  43.     TextField(Field)
  44.         - 文本类型
  45.  
  46.     EmailField(CharField)：
  47.         - 字符串类型，Django Admin以及ModelForm中提供验证机制
  48.  
  49.     IPAddressField(Field)
  50.         - 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制
  51.  
  52.     GenericIPAddressField(Field)
  53.         - 字符串类型，Django Admin以及ModelForm中提供验证 Ipv4和Ipv6
  54.         - 参数：
  55.             protocol，用于指定Ipv4或Ipv6， 'both',"ipv4","ipv6"
  56.             unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启此功能，需要protocol="both"
  57.  
  58.     URLField(CharField)
  59.         - 字符串类型，Django Admin以及ModelForm中提供验证 URL
  60.  
  61.     SlugField(CharField)
  62.         - 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号）
  63.  
  64.     CommaSeparatedIntegerField(CharField)
  65.         - 字符串类型，格式必须为逗号分割的数字
  66.  
  67.     UUIDField(Field)
  68.         - 字符串类型，Django Admin以及ModelForm中提供对UUID格式的验证
  69.  
  70.     FilePathField(Field)
  71.         - 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
  72.         - 参数：
  73.                 path,                      文件夹路径
  74.                 match=None,                正则匹配
  75.                 recursive=False,           递归下面的文件夹
  76.                 allow_files=True,          允许文件
  77.                 allow_folders=False,       允许文件夹
  78.  
  79.     FileField(Field)
  80.         - 字符串，路径保存在数据库，文件上传到指定目录
  81.         - 参数：
  82.             upload_to = ""      上传文件的保存路径
  83.             storage = None      存储组件，默认django.core.files.storage.FileSystemStorage
  84.  
  85.     ImageField(FileField)
  86.         - 字符串，路径保存在数据库，文件上传到指定目录
  87.         - 参数：
  88.             upload_to = ""      上传文件的保存路径
  89.             storage = None      存储组件，默认django.core.files.storage.FileSystemStorage
  90.             width_field=None,   上传图片的高度保存的数据库字段名（字符串）
  91.             height_field=None   上传图片的宽度保存的数据库字段名（字符串）
  92.  
  93.     DateTimeField(DateField)
  94.         - 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]
  95.  
  96.     DateField(DateTimeCheckMixin, Field)
  97.         - 日期格式      YYYY-MM-DD
  98.  
  99.     TimeField(DateTimeCheckMixin, Field)
  100.         - 时间格式      HH:MM[:ss[.uuuuuu]]
  101.  
  102.     DurationField(Field)
  103.         - 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型
  104.  
  105.     FloatField(Field)
  106.         - 浮点型
  107.  
  108.     DecimalField(Field)
  109.         - 10进制小数
  110.         - 参数：
  111.             max_digits，小数总长度
  112.             decimal_places，小数位长度
  113.  
  114.     BinaryField(Field)
  115.         - 二进制类型

字段相关内容

自定义字段

  1. class UnsignedIntegerField(models.IntegerField):
  2.     def db_type(self, connection):
  3.         return 'integer UNSIGNED'
  4.  
  5. PS: 返回值为字段在数据库中的属性，Django字段默认的值为：
  6.     'AutoField': 'integer AUTO_INCREMENT',
  7.     'BigAutoField': 'bigint AUTO_INCREMENT',
  8.     'BinaryField': 'longblob',
  9.     'BooleanField': 'bool',
  10.     'CharField': 'varchar(%(max_length)s)',
  11.     'CommaSeparatedIntegerField': 'varchar(%(max_length)s)',
  12.     'DateField': 'date',
  13.     'DateTimeField': 'datetime',
  14.     'DecimalField': 'numeric(%(max_digits)s, %(decimal_places)s)',
  15.     'DurationField': 'bigint',
  16.     'FileField': 'varchar(%(max_length)s)',
  17.     'FilePathField': 'varchar(%(max_length)s)',
  18.     'FloatField': 'double precision',
  19.     'IntegerField': 'integer',
  20.     'BigIntegerField': 'bigint',
  21.     'IPAddressField': 'char(15)',
  22.     'GenericIPAddressField': 'char(39)',
  23.     'NullBooleanField': 'bool',
  24.     'OneToOneField': 'integer',
  25.     'PositiveIntegerField': 'integer UNSIGNED',
  26.     'PositiveSmallIntegerField': 'smallint UNSIGNED',
  27.     'SlugField': 'varchar(%(max_length)s)',
  28.     'SmallIntegerField': 'smallint',
  29.     'TextField': 'longtext',
  30.     'TimeField': 'time',
  31.     'UUIDField': 'char(32)',

自定义一个无符号整数字段

自定义char类型字段：

  1. class FixedCharField(models.Field):
  2.     """
  3.     自定义的char类型的字段类
  4.     """
  5.     def __init__(self, max_length, *args, **kwargs):
  6.         self.max_length = max_length
  7.         super(FixedCharField, self).__init__(max_length=max_length, *args, **kwargs)
  8.  
  9.     def db_type(self, connection):
  10.         """
  11.         限定生成数据库表的字段类型为char，长度为max_length指定的值
  12.         """
  13.         return 'char(%s)' % self.max_length
  14.  
  15. class Class(models.Model):
  16.     id = models.AutoField(primary_key=True)
  17.     title = models.CharField(max_length=25)
  18.     # 使用自定义的char类型的字段
  19.     cname = FixedCharField(max_length=25)

创建的表结构：

2.5.2.5 注意事项

  1. 1.触发Model中的验证和错误提示有两种方式：
  2.         a. Django Admin中的错误信息会优先根据Admiin内部的ModelForm错误信息提示，如果都成功，才来检查Model的字段并显示指定错误信息
  3.         b. 使用ModelForm
  4.         c. 调用Model对象的 clean_fields 方法，如：
  5.             # models.py
  6.             class UserInfo(models.Model):
  7.                 nid = models.AutoField(primary_key=True)
  8.                 username = models.CharField(max_length=32)
  9.  
  10.                 email = models.EmailField(error_messages={'invalid': '格式错了.'})
  11.  
  12.             # views.py
  13.             def index(request):
  14.                 obj = models.UserInfo(username='', email='uu')
  15.                 try:
  16.                     print(obj.clean_fields())
  17.                 except Exception as e:
  18.                     print(e)
  19.                 return HttpResponse('ok')
  20.  
  21.            # Model的clean方法是一个钩子，可用于定制操作，如：上述的异常处理。
  22.  
  23.     2.Admin中修改错误提示
  24.         # admin.py
  25.         from django.contrib import admin
  26.         from model_club import models
  27.         from django import forms
  28.  
  29.         class UserInfoForm(forms.ModelForm):
  30.             age = forms.IntegerField(initial=1, error_messages={'required': '请输入数值.', 'invalid': '年龄必须为数值.'})
  31.  
  32.             class Meta:
  33.                 model = models.UserInfo
  34.                 # fields = ('username',)
  35.                 fields = "__all__"
  36.                 exclude = ['title']
  37.                 labels = { 'name':'Writer', }
  38.                 help_texts = {'name':'some useful help text.',}
  39.                 error_messages={ 'name':{'max_length':"this writer name is too long"} }
  40.                 widgets={'name':Textarea(attrs={'cols':80,'rows':20})}
  41.  
  42.         class UserInfoAdmin(admin.ModelAdmin):
  43.             form = UserInfoForm
  44.  
  45.         admin.site.register(models.UserInfo, UserInfoAdmin)

注意事项

字段参数

  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

元信息

多表关系和参数

  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.         related_name=None,          # 反向操作时，使用的字段名，用于代替 【表名_set】 如： obj.表名_set.all()
  23.         related_query_name=None,    # 反向操作时，使用的连接前缀，用于替换【表名】     如： models.UserGroup.objects.filter(表名__字段名=1).values('表名__字段名')
  24.         limit_choices_to=None,      # 在Admin或ModelForm中显示关联数据时，提供的条件：
  25.                                     # 如：
  26.                                             - limit_choices_to={'nid__gt': 5}
  27.                                             - limit_choices_to=lambda : {'nid__gt': 5}
  28.  
  29.                                             from django.db.models import Q
  30.                                             - limit_choices_to=Q(nid__gt=10)
  31.                                             - limit_choices_to=Q(nid=8) | Q(nid__gt=10)
  32.                                             - limit_choices_to=lambda : Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption='root')
  33.         db_constraint=True          # 是否在数据库中创建外键约束
  34.         parent_link=False           # 在Admin中是否显示关联数据
  35.  
  36.     OneToOneField(ForeignKey)
  37.         to,                         # 要进行关联的表名
  38.         to_field=None               # 要关联的表中的字段名称
  39.         on_delete=None,             # 当删除关联表中的数据时，当前表与其关联的行的行为
  40.  
  41.                                     ###### 对于一对一 ######
  42.                                     # 1. 一对一其实就是 一对多 + 唯一索引
  43.                                     # 2.当两个类之间有继承关系时，默认会创建一个一对一字段
  44.                                     # 如下会在A表中额外增加一个c_ptr_id列且唯一：
  45.                                             class C(models.Model):
  46.                                                 nid = models.AutoField(primary_key=True)
  47.                                                 part = models.CharField(max_length=12)
  48.  
  49.                                             class A(C):
  50.                                                 id = models.AutoField(primary_key=True)
  51.                                                 code = models.CharField(max_length=1)
  52.  
  53.     ManyToManyField(RelatedField)
  54.         to,                         # 要进行关联的表名
  55.         related_name=None,          # 反向操作时，使用的字段名，用于代替 【表名_set】 如： obj.表名_set.all()
  56.         related_query_name=None,    # 反向操作时，使用的连接前缀，用于替换【表名】     如： models.UserGroup.objects.filter(表名__字段名=1).values('表名__字段名')
  57.         limit_choices_to=None,      # 在Admin或ModelForm中显示关联数据时，提供的条件：
  58.                                     # 如：
  59.                                             - limit_choices_to={'nid__gt': 5}
  60.                                             - limit_choices_to=lambda : {'nid__gt': 5}
  61.  
  62.                                             from django.db.models import Q
  63.                                             - limit_choices_to=Q(nid__gt=10)
  64.                                             - limit_choices_to=Q(nid=8) | Q(nid__gt=10)
  65.                                             - limit_choices_to=lambda : Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption='root')
  66.         symmetrical=None,           # 仅用于多对多自关联时，symmetrical用于指定内部是否创建反向操作的字段
  67.                                     # 做如下操作时，不同的symmetrical会有不同的可选字段
  68.                                         models.BB.objects.filter(...)
  69.  
  70.                                         # 可选字段有：code, id, m1
  71.                                             class BB(models.Model):
  72.  
  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.  
  79.                                             code = models.CharField(max_length=12)
  80.                                             m1 = models.ManyToManyField('self',symmetrical=False)
  81.  
  82.         through=None,               # 自定义第三张表时，使用字段用于指定关系表
  83.         through_fields=None,        # 自定义第三张表时，使用字段用于指定关系表中那些字段做多对多关系表
  84.                                         from django.db import models
  85.  
  86.                                         class Person(models.Model):
  87.                                             name = models.CharField(max_length=50)
  88.  
  89.                                         class Group(models.Model):
  90.                                             name = models.CharField(max_length=128)
  91.                                             members = models.ManyToManyField(
  92.                                                 Person,
  93.                                                 through='Membership',
  94.                                                 through_fields=('group', 'person'),
  95.                                             )
  96.  
  97.                                         class Membership(models.Model):
  98.                                             group = models.ForeignKey(Group, on_delete=models.CASCADE)
  99.                                             person = models.ForeignKey(Person, on_delete=models.CASCADE)
  100.                                             inviter = models.ForeignKey(
  101.                                                 Person,
  102.                                                 on_delete=models.CASCADE,
  103.                                                 related_name="membership_invites",
  104.                                             )
  105.                                             invite_reason = models.CharField(max_length=64)
  106.         db_constraint=True,         # 是否在数据库中创建外键约束
  107.         db_table=None,              # 默认创建第三张表时，数据库中表的名称

多表关系和参数

2.5.2.6 ORM操作

基本操作

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

进阶操作

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

进阶操作

高级操作

  1. # extra
  2. # 在QuerySet的基础上继续执行子语句
  3. # extra(self, select=None, where=None, params=None, tables=None, order_by=None, select_params=None)
  4.  
  5. # select和select_params是一组，where和params是一组，tables用来设置from哪个表
  6. # Entry.objects.extra(select={'new_id': "select col from sometable where othercol > %s"}, select_params=(1,))
  7. # Entry.objects.extra(where=['headline=%s'], params=['Lennon'])
  8. # Entry.objects.extra(where=["foo='a' OR bar = 'a'", "baz = 'a'"])
  9. # Entry.objects.extra(select={'new_id': "select id from tb where id > %s"}, select_params=(1,), order_by=['-nid'])
  10.  
  11. 举个例子：
  12. models.UserInfo.objects.extra(
  13.                     select={'newid':'select count(1) from app01_usertype where id>%s'},
  14.                     select_params=[1,],
  15.                     where = ['age>%s'],
  16.                     params=[18,],
  17.                     order_by=['-age'],
  18.                     tables=['app01_usertype']
  19.                 )
  20.                 """
  21.                 select
  22.                     app01_userinfo.id,
  23.                     (select count(1) from app01_usertype where id>1) as newid
  24.                 from app01_userinfo,app01_usertype
  25.                 where
  26.                     app01_userinfo.age > 18
  27.                 order by
  28.                     app01_userinfo.age desc
  29.                 """
  30.  
  31. # 执行原生SQL
  32. # 更高灵活度的方式执行原生SQL语句
  33. # from django.db import connection, connections
  34. # cursor = connection.cursor()  # cursor = connections['default'].cursor()
  35. # cursor.execute("""SELECT * from auth_user where id = %s""", [1])
  36. # row = cursor.fetchone()

高级操作

QuerySet相关方法

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

QuerySet方法大全

Django框架简介-模型系统的更多相关文章

  1. Django框架简介-路由系统

    2.2 路由系统 Django 1.11版本 URLConf官方文档 URL配置(URLconf)就像Django 所支撑网站的目录.它的本质是URL与要为该URL调用的视图函数之间的映射表. 你就是 ...

  2. Django框架简介-视图系统

    2.3 视图系统 一个视图函数(类),简称视图,是一个简单的Python 函数(类),它接受Web请求并且返回Web响应. 响应可以是一张网页的HTML内容,一个重定向,一个404错误,一个XML文档 ...

  3. Django框架简介-模板系统

    2.4 模板 官方文档 2.4.1 常用语法 只需要记两种特殊符号: {{  }}和 {% %} 变量相关的用{{}},逻辑相关的用{%%}. 2.4.1.1 变量 {{ 变量名 }} 变量名由字母数 ...

  4. Python学习（三十）—— Django框架简介

    转载自:http://www.cnblogs.com/liwenzhou/p/8296964.html Django框架简介 一.MVC框架和MTV框架(了解即可) MVC,全名是Model View ...

  5. Django框架简介及模板Template,filter

    Django框架简介 MVC框架和MTV框架 MVC,全名是Model View Controller,是软件工程中的一种软件架构模式,把软件系统分为三个基本部分:模型(Model).视图(View) ...

  6. Django框架简介与使用注意事项

    一.Django框架简介 MVC框架和MTV框架 MVC框架 MVC,全名是Model View Controller,是软件工程中的一种软件架构模式,把软件系统分为三个基本部分:模型(Model). ...

  7. python 之 Django框架(Django框架简介、视图装饰器、request对象、Response对象)

    12.33 Django框架简介: MVC,全名是Model View Controller,是软件工程中的一种软件架构模式,把软件系统分为三个基本部分:模型(Model).视图(View)和控制器( ...

  8. 将Python的Django框架与认证系统整合的方法

    将Python的Django框架与认证系统整合的方法 这篇文章主要介绍了将Python的Django框架与认证系统整合的方法,包括指定认证后台和编写认证后台等内容,需要的朋友可以参考下 将Django ...

  9. wsgiref模块、web框架、django框架简介

    """web框架:将前端.数据库整合到一起的基于互联网传输的python代码 web框架也可以简单的理解为是软件开发架构里面的'服务端'""" ...

随机推荐

  1. mac 配置vue+sanic环境准备工作

    Vue用到npm/cnpm.webpack ,准备工作主要是将这些安装上. 首先安装这些最好使用root用户. 第一步安装npm:npm是node.js的一部分,所以需要安装node.js. 安装no ...

  2. 如何执行shell命令

    可使用 git 命令行来执行shell命令,如 D 盘下的一 shell 脚本 test.sh 如下: echo "Hello world" 打开命令行,输入命令执行: 转载请注明 ...

  3. win7系统删除打印机后刷新又出现怎么办

    方法/步骤:1.进入桌面后,按下“Win + R”组合键打开运行窗口,在运行中输入“spool”并点击确定:2.之后会进入路径为“C:\Windows\System32\spool”的文件夹中,3.在 ...

  4. CentOS 7 zabbix实现微信报警

    环境 : LAMP  CentOS7  192.168.94.11 首先搭建LAMP环境 , 安装zabbix [root@zabbix-server ~]# wget http://repo.zab ...

  5. selenium webdriver报错 ConnectionResetError: [WinError 10054] 远程主机强迫关闭了一个现有的连接。

    昨天跑的好好的代码,今天突然报错: ConnectionResetError: [WinError 10054] 远程主机强迫关闭了一个现有的连接. 调查一下,原来是Chrome自动升级,而chrom ...

  6. Cookie写不进去问题深入调查 https Secure Cookie

    Cookie写不进去问题深入调查 https Secure Cookie 什么情形下,Cookie 会写不进去?https Secure Cookie像是语法错误那种显而易见的就不用说了,除此之外你可 ...

  7. SQL大数据查询优化

    常写的SQL可能主要以实现查询出结果为主,但如果数据量一大,就会突出SQL查询语句优化的性能独特之处.一般的数据库设计都会建索引查询,这样较全盘扫描查询的确快了不少.下面总结下SQL查询语句的几个优化 ...

  8. v-charts

    因为工作需要,使用v-chart也有一段时间了,期间针对配置图表也遇到了不少问题,在这里总结一下. 如何配置图表信息 echart的配置项可谓是相当的海量,能不看就不看.而v-chart对其进行了不少 ...

  9. 获取某个元素第一次出现在数组（json数组）的索引

    function firstIndex(arr, text) { // 若元素不存在在数组中返回-1 let firstVal = -1; for (let i = 0; i < arr.len ...

  10. Springboot 配置类（ @Configuration） 不能使用@Value注解从application.propertyes中加载值以及Environment为null解决方案

    最近遇到个场景,需要在使用@Bean注解定义bean的时候为对象设置一些属性,比如扫描路径,因为路径经常发布新特性的时候需要修改,所以就计划着放在配置文件中,然后通过@ConfigurationPro ...