Django - ORM操作

主要内容

  • 1.ORM 概述
  • 2.创建表
  • 3.查询方法(13)
  • 4.单表双下划线
  • 5.外键的操作
  • 6.多对多的操作
  • 7.聚合查询
  • 8.分组查询
  • 9.F&Q查询
  • 10.事物

1.ORM概述

(1)ORM概念

对象关系映射(Object Relational Mapping,简称ORM)模式

  • 是一种为了解决面向对象与关系数据库存在的互不匹配的现象的技术。
  • 简单的说,ORM是通过使用描述对象和数据库之间映射的元数据,将程序中的对象自动持久化到关系数据库中。
  • ORM在业务逻辑层和数据库层之间充当了桥梁的作用。

(2)ORM的由来

  • 让我们从O/R开始。字母O起源于"对象"(Object),而R则来自于"关系"(Relational)。
  • 几乎所有的软件开发过程中都会涉及到对象和关系数据库。在用户层面和业务逻辑层面,我们是面向对象的。当对象的信息发生变化的时候,我们就需要把对象的信息保存在关系数据库中。
  • 按照之前的方式来进行开发就会出现程序员会在自己的业务逻辑代码中夹杂很多SQL语句用来增加、读取、修改、删除相关数据,而这些代码通常都是极其相似或者重复的。

(3) ORM的优势

  • ORM解决的主要问题是对象和关系的映射。它通常将一个类和一张表一一对应,类的每个实例对应表中的一条记录,类的每个属性对应表中的每个字段。 
  • ORM提供了对数据库的映射,不用直接编写SQL代码,只需操作对象就能对数据库操作数据。
  • 让软件开发人员专注于业务逻辑的处理,提高了开发效率

(4) ORM 的劣势

  • ORM的缺点是会在一定程度上牺牲程序的执行效率。
  • ORM的操作是有限的,也就是ORM定义好的操作是可以完成的,一些复杂的查询操作是完成不了。
  • ORM用多了SQL语句就不会写了,关系数据库相关技能退化...

2.创建表

2.1基本结构

from django.db import models   
class userinfo(models.Model):
    name = models.CharField(max_length=30)
    email = models.EmailField()
    memo = models.TextField()
AutoField(Field)
        - int自增列,必须填入参数 primary_key=True

    BigAutoField(AutoField)
        - bigint自增列,必须填入参数 primary_key=True

        注:当model中如果没有自增列,则自动会创建一个列名为id的列
        from django.db import models

        class UserInfo(models.Model):
            # 自动创建一个列名为id的且为自增的整数列
            username = models.CharField(max_length=32)

        class Group(models.Model):
            # 自定义自增列
            nid = models.AutoField(primary_key=True)
            name = models.CharField(max_length=32)

    SmallIntegerField(IntegerField):
        - 小整数 -32768 ~ 32767

    PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正小整数 0 ~ 32767
    IntegerField(Field)
        - 整数列(有符号的) -2147483648 ~ 2147483647

    PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
        - 正整数 0 ~ 2147483647

    BigIntegerField(IntegerField):
        - 长整型(有符号的) -9223372036854775808 ~ 9223372036854775807

    自定义无符号整数字段

        class UnsignedIntegerField(models.IntegerField):
            def db_type(self, connection):
                return 'integer UNSIGNED'

        PS: 返回值为字段在数据库中的属性,Django字段默认的值为:
            'AutoField': 'integer AUTO_INCREMENT',
            'BigAutoField': 'bigint AUTO_INCREMENT',
            'BinaryField': 'longblob',
            'BooleanField': 'bool',
            'CharField': 'varchar(%(max_length)s)',
            'CommaSeparatedIntegerField': 'varchar(%(max_length)s)',
            'DateField': 'date',
            'DateTimeField': 'datetime',
            'DecimalField': 'numeric(%(max_digits)s, %(decimal_places)s)',
            'DurationField': 'bigint',
            'FileField': 'varchar(%(max_length)s)',
            'FilePathField': 'varchar(%(max_length)s)',
            'FloatField': 'double precision',
            'IntegerField': 'integer',
            'BigIntegerField': 'bigint',
            'IPAddressField': 'char(15)',
            'GenericIPAddressField': 'char(39)',
            'NullBooleanField': 'bool',
            'OneToOneField': 'integer',
            'PositiveIntegerField': 'integer UNSIGNED',
            'PositiveSmallIntegerField': 'smallint UNSIGNED',
            'SlugField': 'varchar(%(max_length)s)',
            'SmallIntegerField': 'smallint',
            'TextField': 'longtext',
            'TimeField': 'time',
            'UUIDField': 'char(32)',

    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           数据库中字段的列名
    db_tablespace
    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'), ]
                            )

参数
参数
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"),)

            # admin中显示的表名称
            verbose_name

            # verbose_name加s
            verbose_name_plural
        
    更多:https://docs.djangoproject.com/en/1.10/ref/models/options/

元信息
元信息
1.触发Model中的验证和错误提示有两种方式:
        a. Django Admin中的错误信息会优先根据Admiin内部的ModelForm错误信息提示,如果都成功,才来检查Model的字段并显示指定错误信息
        b. 调用Model对象的 clean_fields 方法,如:
            # models.py
            class UserInfo(models.Model):
                nid = models.AutoField(primary_key=True)
                username = models.CharField(max_length=32)

                email = models.EmailField(error_messages={'invalid': '格式错了.'})

            # views.py
            def index(request):
                obj = models.UserInfo(username='11234', email='uu')
                try:
                    print(obj.clean_fields())
                except Exception as e:
                    print(e)
                return HttpResponse('ok')

           # Model的clean方法是一个钩子,可用于定制操作,如:上述的异常处理。

    2.Admin中修改错误提示
        # admin.py
        from django.contrib import admin
        from model_club import models
        from django import forms


        class UserInfoForm(forms.ModelForm):
            username = forms.CharField(error_messages={'required': '用户名不能为空.'})
            email = forms.EmailField(error_messages={'invalid': '邮箱格式错误.'})
            age = forms.IntegerField(initial=1, error_messages={'required': '请输入数值.', 'invalid': '年龄必须为数值.'})

            class Meta:
                model = models.UserInfo
                # fields = ('username',)
                fields = "__all__"


        class UserInfoAdmin(admin.ModelAdmin):
            form = UserInfoForm


        admin.site.register(models.UserInfo, UserInfoAdmin)

拓展知识
其他

2.2 连表结构

  • 一对多:models.ForeignKey(其他表)
  • 多对多:models.ManyToManyField(其他表)
  • 一对一:models.OneToOneField(其他表)
应用场景:

一对多:当一张表中创建一行数据时,有一个单选的下拉框(可以被重复选择)
例如:创建用户信息时候,需要选择一个用户类型【普通用户】【金牌用户】【铂金用户】等。
多对多:在某表中创建一行数据是,有一个可以多选的下拉框
例如:创建用户信息,需要为用户指定多个爱好
一对一:在某表中创建一行数据时,有一个单选的下拉框(下拉框中的内容被用过一次就消失了
例如:原有含10列数据的一张表保存相关信息,经过一段时间之后,10列无法满足需求,需要为原来的表再添加5列数据
ForeignKey(ForeignObject) # ForeignObject(RelatedField)
        to,                         # 要进行关联的表名
        to_field=None,              # 要关联的表中的字段名称
        on_delete=None,             # 当删除关联表中的数据时,当前表与其关联的行的行为
                                        - models.CASCADE,删除关联数据,与之关联也删除
                                        - models.DO_NOTHING,删除关联数据,引发错误IntegrityError
                                        - models.PROTECT,删除关联数据,引发错误ProtectedError
                                        - models.SET_NULL,删除关联数据,与之关联的值设置为null(前提FK字段需要设置为可空)
                                        - models.SET_DEFAULT,删除关联数据,与之关联的值设置为默认值(前提FK字段需要设置默认值)
                                        - models.SET,删除关联数据,
                                                      a. 与之关联的值设置为指定值,设置:models.SET(值)
                                                      b. 与之关联的值设置为可执行对象的返回值,设置:models.SET(可执行对象)

                                                        def func():
                                                            return 10

                                                        class MyModel(models.Model):
                                                            user = models.ForeignKey(
                                                                to="User",
                                                                to_field="id"
                                                                on_delete=models.SET(func),)
        related_name=None,          # 反向操作时,使用的字段名,用于代替 【表名_set】 如: obj.表名_set.all()
        related_query_name=None,    # 反向操作时,使用的连接前缀,用于替换【表名】     如: models.UserGroup.objects.filter(表名__字段名=1).values('表名__字段名')
        limit_choices_to=None,      # 在Admin或ModelForm中显示关联数据时,提供的条件:
                                    # 如:
                                            - limit_choices_to={'nid__gt': 5}
                                            - limit_choices_to=lambda : {'nid__gt': 5}

                                            from django.db.models import Q
                                            - limit_choices_to=Q(nid__gt=10)
                                            - limit_choices_to=Q(nid=8) | Q(nid__gt=10)
                                            - limit_choices_to=lambda : Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption='root')
        db_constraint=True          # 是否在数据库中创建外键约束
        parent_link=False           # 在Admin中是否显示关联数据


    OneToOneField(ForeignKey)
        to,                         # 要进行关联的表名
        to_field=None               # 要关联的表中的字段名称
        on_delete=None,             # 当删除关联表中的数据时,当前表与其关联的行的行为

                                    ###### 对于一对一 ######
                                    # 1. 一对一其实就是 一对多 + 唯一索引
                                    # 2.当两个类之间有继承关系时,默认会创建一个一对一字段
                                    # 如下会在A表中额外增加一个c_ptr_id列且唯一:
                                            class C(models.Model):
                                                nid = models.AutoField(primary_key=True)
                                                part = models.CharField(max_length=12)

                                            class A(C):
                                                id = models.AutoField(primary_key=True)
                                                code = models.CharField(max_length=1)

    ManyToManyField(RelatedField)
        to,                         # 要进行关联的表名
        related_name=None,          # 反向操作时,使用的字段名,用于代替 【表名_set】 如: obj.表名_set.all()
        related_query_name=None,    # 反向操作时,使用的连接前缀,用于替换【表名】     如: models.UserGroup.objects.filter(表名__字段名=1).values('表名__字段名')
        limit_choices_to=None,      # 在Admin或ModelForm中显示关联数据时,提供的条件:
                                    # 如:
                                            - limit_choices_to={'nid__gt': 5}
                                            - limit_choices_to=lambda : {'nid__gt': 5}

                                            from django.db.models import Q
                                            - limit_choices_to=Q(nid__gt=10)
                                            - limit_choices_to=Q(nid=8) | Q(nid__gt=10)
                                            - limit_choices_to=lambda : Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption='root')
        symmetrical=None,           # 仅用于多对多自关联时,symmetrical用于指定内部是否创建反向操作的字段
                                    # 做如下操作时,不同的symmetrical会有不同的可选字段
                                        models.BB.objects.filter(...)

                                        # 可选字段有:code, id, m1
                                            class BB(models.Model):

                                            code = models.CharField(max_length=12)
                                            m1 = models.ManyToManyField('self',symmetrical=True)

                                        # 可选字段有: bb, code, id, m1
                                            class BB(models.Model):

                                            code = models.CharField(max_length=12)
                                            m1 = models.ManyToManyField('self',symmetrical=False)

        through=None,               # 自定义第三张表时,使用字段用于指定关系表
        through_fields=None,        # 自定义第三张表时,使用字段用于指定关系表中那些字段做多对多关系表
                                        from django.db import models

                                        class Person(models.Model):
                                            name = models.CharField(max_length=50)

                                        class Group(models.Model):
                                            name = models.CharField(max_length=128)
                                            members = models.ManyToManyField(
                                                Person,
                                                through='Membership',
                                                through_fields=('group', 'person'),
                                            )

                                        class Membership(models.Model):
                                            group = models.ForeignKey(Group, on_delete=models.CASCADE)
                                            person = models.ForeignKey(Person, on_delete=models.CASCADE)
                                            inviter = models.ForeignKey(
                                                Person,
                                                on_delete=models.CASCADE,
                                                related_name="membership_invites",
                                            )
                                            invite_reason = models.CharField(max_length=64)
        db_constraint=True,         # 是否在数据库中创建外键约束
        db_table=None,              # 默认创建第三张表时,数据库中表的名称

字段以及参数
字段参数

 

注: 另外需注意  # 自定义一个char类型字段

class MyCharField(models.Field):
    '''
    自定义的char类型字段表
    '''
    def __init__(self,max_length,*args,**kwargs):
        self.max_length = max_length
        super(MyCharField, self).__init__(max_length=max_length,*args,**kwargs)

    def db_type(self,connection):
        '''
        限定生成数据库表的字段类型为char,长度为max_length指定的值
        '''
        return 'char(%s)'% self.max_length
#定义一个person类,我们需要自定义一个字段来定义 11位的手机号
class Person(models.Model):
    id = models.AutoField(primary_key=True)
    name = models.CharField(max_length=32)
    age = models.IntegerField()
    birth = models.DateTimeField(auto_now=True)
    phone = MyCharField(max_length=11,)

#自定义字段
class MyCharField(models.Field):
    '''
    自定义的char类型字段表
    '''
    def __init__(self,max_length,*args,**kwargs):
        self.max_length = max_length
        super(MyCharField, self).__init__(max_length=max_length,*args,**kwargs)

    def db_type(self,connection):
        '''
        限定生成数据库表的字段类型为char,长度为max_length指定的值
        '''
        return 'char(%s)'% self.max_length

注:此时执行数据库的迁移命令会报错

E:\Python_workspace\第四阶段 - Django\ORM_practice>python manage.py makemigrations
You are trying to add a non-nullable field 'phone' to person without a default; we can't do that (the database needs something to populate existing rows).
Please select a fix:
 1) Provide a one-off default now (will be set on all existing rows with a null value for this column)
 2) Quit, and let me add a default in models.py
Select an option: 1
Please enter the default value now, as valid Python
The datetime and django.utils.timezone modules are available, so you can do e.g. timezone.now
Type 'exit' to exit this prompt
>>> 12345678901
Migrations for 'app01':
  app01\migrations\0009_person_phone.py
    - Add field phone to person 
#就是当新增字段时后需要告诉数据库之前的字段是什么数据
#选择1 就是提供默认值给之前的参数

3.查询方法(13)

import os
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "ORM_practice.settings")
import django
django.setup()

from app01 import models

#all() #获取所有数据 (对象列表)
ret = models.Person.objects.all()
#filter() #获取满足条件的所有对象(对象列表)
ret1 = models.Person.objects.filter(id =2)
 #获取一个对象,没有或者是多个的时候会报错
#get()
ret2 = models.Person.objects.get(id =3)

#exclude() #获取不满足条件的所有对象 (对象列表)
ret3= models.Person.objects.exclude(id=1)


#values() 获取对象的字段名和值
#不指定字段名   获取所有的字段名和值 (对象列表)
ret4 = models.Person.objects.all().values()

#指定字段名 获取指定字段的名和值  (列表)
ret5 = models.Person.objects.all().values('name','id')
# for i in ret:
#     print(i,type(i))

#value_list 获取对象的值
#不指定字段名 获取所有字段的值
# 指定字段名  获取指定字段值

ret6= models.Person.objects.all().values_list('id','name')
# for i in ret:
#     print(i,type(i))

#排序,默认升序,加 - 降序 (指定多个排序,按第一个升序,遇到相同时候再降序)
#order_by
ret7= models.Person.objects.all().order_by('age','-id')

#reverse()  给已经排好序的结果倒叙排序
ret8 = models.Person.objects.all().order_by('age','id').reverse()   #倒叙排序
ret9 = models.Person.objects.all().reverse()  #并不能倒叙排序
# print (ret8)
# print (ret9)

#distinct  会对完全相同的内容去重(但不是某一字段相同就去重)

#count 计数
ret10 = models.Person.objects.all().count()
print (ret)

#first  last  取第一个 最后一个  对象
ret = models.Person.objects.all().first()

#exists() 判断数据是否存在
ret11= models.Person.objects.filter(id=3).exists()
# print(ret)    #True

QuerySet相关方法

##################################################################
# PUBLIC METHODS THAT ALTER ATTRIBUTES AND RETURN A NEW QUERYSET #
##################################################################

def all(self)
    # 获取所有的数据对象

def filter(self, *args, **kwargs)
    # 条件查询
    # 条件可以是:参数,字典,Q

def exclude(self, *args, **kwargs)
    # 条件查询
    # 条件可以是:参数,字典,Q

def select_related(self, *fields)
    性能相关:表之间进行join连表操作,一次性获取关联的数据。

    总结:
    1. select_related主要针一对一和多对一关系进行优化。
    2. select_related使用SQL的JOIN语句进行优化,通过减少SQL查询的次数来进行优化、提高性能。

def prefetch_related(self, *lookups)
    性能相关:多表连表操作时速度会慢,使用其执行多次SQL查询在Python代码中实现连表操作。

    总结:
    1. 对于多对多字段(ManyToManyField)和一对多字段,可以使用prefetch_related()来进行优化。
    2. prefetch_related()的优化方式是分别查询每个表,然后用Python处理他们之间的关系。

def annotate(self, *args, **kwargs)
    # 用于实现聚合group by查询

    from django.db.models import Count, Avg, Max, Min, Sum

    v = models.UserInfo.objects.values('u_id').annotate(uid=Count('u_id'))
    # SELECT u_id, COUNT(ui) AS `uid` FROM UserInfo GROUP BY u_id

    v = models.UserInfo.objects.values('u_id').annotate(uid=Count('u_id')).filter(uid__gt=1)
    # SELECT u_id, COUNT(ui_id) AS `uid` FROM UserInfo GROUP BY u_id having count(u_id) > 1

    v = models.UserInfo.objects.values('u_id').annotate(uid=Count('u_id',distinct=True)).filter(uid__gt=1)
    # SELECT u_id, COUNT( DISTINCT ui_id) AS `uid` FROM UserInfo GROUP BY u_id having count(u_id) > 1

def distinct(self, *field_names)
    # 用于distinct去重
    models.UserInfo.objects.values('nid').distinct()
    # select distinct nid from userinfo

    注:只有在PostgreSQL中才能使用distinct进行去重

def order_by(self, *field_names)
    # 用于排序
    models.UserInfo.objects.all().order_by('-id','age')

def extra(self, select=None, where=None, params=None, tables=None, order_by=None, select_params=None)
    # 构造额外的查询条件或者映射,如:子查询

    Entry.objects.extra(select={'new_id': "select col from sometable where othercol > %s"}, select_params=(1,))
    Entry.objects.extra(where=['headline=%s'], params=['Lennon'])
    Entry.objects.extra(where=["foo='a' OR bar = 'a'", "baz = 'a'"])
    Entry.objects.extra(select={'new_id': "select id from tb where id > %s"}, select_params=(1,), order_by=['-nid'])

 def reverse(self):
    # 倒序
    models.UserInfo.objects.all().order_by('-nid').reverse()
    # 注:如果存在order_by,reverse则是倒序,如果多个排序则一一倒序


 def defer(self, *fields):
    models.UserInfo.objects.defer('username','id')
    或
    models.UserInfo.objects.filter(...).defer('username','id')
    #映射中排除某列数据

 def only(self, *fields):
    #仅取某个表中的数据
     models.UserInfo.objects.only('username','id')
     或
     models.UserInfo.objects.filter(...).only('username','id')

 def using(self, alias):
     指定使用的数据库,参数为别名(setting中的设置)


##################################################
# PUBLIC METHODS THAT RETURN A QUERYSET SUBCLASS #
##################################################

def raw(self, raw_query, params=None, translations=None, using=None):
    # 执行原生SQL
    models.UserInfo.objects.raw('select * from userinfo')

    # 如果SQL是其他表时,必须将名字设置为当前UserInfo对象的主键列名
    models.UserInfo.objects.raw('select id as nid from 其他表')

    # 为原生SQL设置参数
    models.UserInfo.objects.raw('select id as nid from userinfo where nid>%s', params=[12,])

    # 将获取的到列名转换为指定列名
    name_map = {'first': 'first_name', 'last': 'last_name', 'bd': 'birth_date', 'pk': 'id'}
    Person.objects.raw('SELECT * FROM some_other_table', translations=name_map)

    # 指定数据库
    models.UserInfo.objects.raw('select * from userinfo', using="default")

    ################### 原生SQL ###################
    from django.db import connection, connections
    cursor = connection.cursor()  # cursor = connections['default'].cursor()
    cursor.execute("""SELECT * from auth_user where id = %s""", [1])
    row = cursor.fetchone() # fetchall()/fetchmany(..)


def values(self, *fields):
    # 获取每行数据为字典格式

def values_list(self, *fields, **kwargs):
    # 获取每行数据为元祖

def dates(self, field_name, kind, order='ASC'):
    # 根据时间进行某一部分进行去重查找并截取指定内容
    # kind只能是:"year"(年), "month"(年-月), "day"(年-月-日)
    # order只能是:"ASC"  "DESC"
    # 并获取转换后的时间
        - year : 年-01-01
        - month: 年-月-01
        - day  : 年-月-日

    models.DatePlus.objects.dates('ctime','day','DESC')

def datetimes(self, field_name, kind, order='ASC', tzinfo=None):
    # 根据时间进行某一部分进行去重查找并截取指定内容,将时间转换为指定时区时间
    # kind只能是 "year", "month", "day", "hour", "minute", "second"
    # order只能是:"ASC"  "DESC"
    # tzinfo时区对象
    models.DDD.objects.datetimes('ctime','hour',tzinfo=pytz.UTC)
    models.DDD.objects.datetimes('ctime','hour',tzinfo=pytz.timezone('Asia/Shanghai'))

    """
    pip3 install pytz
    import pytz
    pytz.all_timezones
    pytz.timezone(‘Asia/Shanghai’)
    """

def none(self):
    # 空QuerySet对象


####################################
# METHODS THAT DO DATABASE QUERIES #
####################################

def aggregate(self, *args, **kwargs):
   # 聚合函数,获取字典类型聚合结果
   from django.db.models import Count, Avg, Max, Min, Sum
   result = models.UserInfo.objects.aggregate(k=Count('u_id', distinct=True), n=Count('nid'))
   ===> {'k': 3, 'n': 4}

def count(self):
   # 获取个数

def get(self, *args, **kwargs):
   # 获取单个对象

def create(self, **kwargs):
   # 创建对象

def bulk_create(self, objs, batch_size=None):
    # 批量插入
    # batch_size表示一次插入的个数
    objs = [
        models.DDD(name='r11'),
        models.DDD(name='r22')
    ]
    models.DDD.objects.bulk_create(objs, 10)

def get_or_create(self, defaults=None, **kwargs):
    # 如果存在,则获取,否则,创建
    # defaults 指定创建时,其他字段的值
    obj, created = models.UserInfo.objects.get_or_create(username='root1', defaults={'email': '1111111','u_id': 2, 't_id': 2})

def update_or_create(self, defaults=None, **kwargs):
    # 如果存在,则更新,否则,创建
    # defaults 指定创建时或更新时的其他字段
    obj, created = models.UserInfo.objects.update_or_create(username='root1', defaults={'email': '1111111','u_id': 2, 't_id': 1})

def first(self):
   # 获取第一个

def last(self):
   # 获取最后一个

def in_bulk(self, id_list=None):
   # 根据主键ID进行查找
   id_list = [11,21,31]
   models.DDD.objects.in_bulk(id_list)

def delete(self):
   # 删除

def update(self, **kwargs):
    # 更新

def exists(self):
   # 是否有结果

其他操作

QuerySet方法大全
相关方法

4.单表双下划线

import os
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "ORM_practice.settings")
import django
django.setup()

from app01 import models

ret =models.Person.objects.filter(id=1)  #获取id = 1 的对象列表
ret1 = models.Person.objects.filter(id__gt=1)   #greater than  获取所有 id>1的对象
# print(ret1)
ret2 = models.Person.objects.filter(id__gte =1)  #greater than equal 获取所有 id>=1的对象
# print(ret2)
ret3 = models.Person.objects.filter(id__lt=3)   #less than   获取所有id<3的对象
# print(ret3)
ret4 = models.Person.objects.filter(id__lte=3)   #less than   获取所有id<=3的对象
# print(ret4)

ret5 = models.Person.objects.filter(id__gt=1,id__lt =3)  #获取id大于1但小于3的所有对象
# print(ret5)
ret6 = models.Person.objects.filter(id__range=[1,3]) #id 的范围  左右都包含
# print(ret6)
ret7= models.Person.objects.filter(id__in=[1,3])   #表示获取id在列表中的所有对象
# print(ret7)

ret8 = models.Person.objects.filter(name__contains='a')  #获取名字中包含"a"的对象
# print (ret8)
ret9= models.Person.objects.filter(name__icontains='alex')  #大小写都会被获取(包含)忽略大小写
# print(ret9)

ret10 = models.Person.objects.filter(name__startswith='a')    #以什么开头
ret11 = models.Person.objects.filter(name__istartswith='a')  #以什么开头,忽略大小写
# print(ret10)
# print(ret11)

ret12 = models.Person.objects.filter(name__endswith='x')    #以什么开头
ret13 = models.Person.objects.filter(name__iendswith='x')  #以什么开头,忽略大小写
print(ret12)
print(ret13)

ret14 = models.Person.objects.filter(birth__year=2018)
ret15= models.Person.objects.filter(birth__contains='2018-12')
print(ret14)
print(ret15)

5.外键的操作

import os

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "ORM_practice.settings")
import django
django.setup()

from app01 import models

#基于对象的查询
#正向查询   即有外键的一侧 查关联对象
#对Book设置了外键
book_obj = models.Book.objects.get(id=1)   #id为1的书籍
# print(book_obj)
# print(book_obj.publisher)   #关联的对象
# print(book_obj.publisher_id)   #关联对象的id
# print(book_obj.publisher.id)   #关联对象的id

#反向查询  被关联的对象 查询有外键的一侧
# pub_obj = models.Publisher.objects.get(id=1)
# print(pub_obj)


#----------------------------------------------------------------------------------------------
#查询出版社出版的所有书籍
# 不指定 related_name='books'
# print(pub_obj.book_set,type(pub_obj.book_set))
# print(pub_obj.book_set.all())

#基于字段的查询
# 不指定 related_name='books'

#查询指定(出版社字段) 出版的所有(书籍)
# ret1 = models.Book.objects.filter(publisher__name ='沙河出版社')
# print(ret1)

#查询指定(书籍字段) 是由哪个出版社出版
# ret2 =models.Publisher.objects.filter(book__title ='天龙八部')
# print(ret2)
#--------------------------------------------------------------------------

#-------------------------------------------------------------------------------
#查询出版社出版的所有书籍
#指定related_name = 'books' (给外键publisher 字段设置的)
# print(pub_obj.books,type(pub_obj.books))
# print(pub_obj.books.all())

#基于字段的查询
#指定related_name ='books'
#查询指定(书籍字段) 是由哪个出版社出版
# ret = models.Publisher.objects.filter(books__title ='天龙八部')
# print(ret)

#指定related_query_name='book'
# ret =models.Publisher.objects.filter(book__title ='神雕侠侣')
# print(ret)

#外键字段可以为null,才有remove 和clear 只能写对象
pub_obj = models.Publisher.objects.get(id = 1)
# pub_obj.books.remove(models.Book.objects.get(id =1))
# pub_obj.books.clear()
#会创建publisher_id为1
pub_obj.books.create(title='雪山飞狐')

6.多对多的操作

import os

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "ORM_practice.settings")
import django
django.setup()

from app01 import models

#基于对象的查询
#正向
author_obj = models.Author.objects.get(id=2)

#查询指定字段对象(作者)写的所有书籍
# print(author_obj.books,type(author_obj.books))
# print(author_obj.books.all())

#反向
book_obj = models.Book.objects.get(id=2)
#不指定related_name ='authors'
# print(book_obj.author_set.all())

#指定related_name ='authors'
# print(book_obj.authors.all())   [, ]>  因为作者没有定义str方法


#set 设置多对多关系
#全部重新设置id= 2 的三条数据全部清空
# author_obj.books.set([])

# author_obj.books.set([1,2]) #y要关联对象的id (就是给id为1和id为2 的两本书设置多对多)


#add 添加对对多关系
# author_obj.books.add(3)   #要关联对象的id
# author_obj.books.add(models.Book.objects.get(id=3))   #要关联的对象

#remove 删除多对多的关系

# author_obj.books.remove(3)   #要关联对象的id
# author_obj.books.remove(models.Book.objects.get (id=2))  #要关联的对象

#clear()  #清空当前(id=2也就是author_obj对象)的多对多的关系
# author_obj.books.clear()

#create()
author_obj.books.create(title='楚留香传奇')

book_obj.authors.create(name='古龙2')

 7.聚合查询  (aggregate(*args,**kwargs))

通过对QuerySet进行计算,返回一个聚合值的字典。aggregate()中每一个参数都指定一个包含在字典中的返回值。即在查询集上生成聚合。

from django.db,models import Avg,Min,Sum,Max

#从整个查询集生成统计值
#示例 计算所有在售书的平均价钱
#书籍 --> 查询集  
         
Book.objects.all().aggregate(Avg('price'))

#aggregate()子句的参数描述的是我们想要计算的聚合值
#aggregate() 是QuerySet的一个终止子句,意思是:他返回它返回一个包含一些键值对的字典

ret = models.Book.objects.aggregate(Max('price'))
# 结果:{'price__max': Decimal('39.99')}

 ret = models.Book.objects.aggregate(max=Max('price')) # 结果:{'max': Decimal('39.99')}
#键的名称是聚合值的标识符,值是计算出来的聚合值
#键的名称是按照字段和聚合函数的名称自动生成出来的。如果你想要为聚合值指定一个名称,可以向聚合子句提供它:

8.分组查询(annotate(*args.**kwargs))

可以通过计算查询结果中每一个对象所关联的对象集合,从而得出总计值(也可以是平均值或总和),即为查询集的每一项生成聚合。

# 统计出每个出版社买的最便宜的书的价格
# 方法一    以出版社的id进行分组
ret = models.Publisher.objects.all().annotate(Min('book__price')).values()
 for i in ret:
     print(i)

# 方法二    values指定以什么字段进行分组,后面的values不能写其他额外的字段
ret = models.Book.objects.values('publisher__name').annotate(min=Min('price')).values('min')
 for i in ret:
    print(i)
#查找每个作者的姓名以及出的书籍数量
ret17 = models.Author.objects.all().annotate(count=Count('books__title')).values('name','count')
for i in ret17 :
     print(i)
#查找每个作者写的价格最高的书籍价格
ret16 = models.Author.objects.all().annotate(max=Max('books__price')).values('name','max')
for i in ret16:
    print(i)

9.F&Q查询

9.1 F查询

from django.db.models import F

#查询库存大于50的书籍
ret = models.Book.objects.filter(store__gt=50).values()
# for i in ret:
#     print(i)

#第一种用法,动态的获取想要获取的字段 (可以比较两列的值)
# 获取库存大于售出的书籍
ret2 = models.Book.objects.filter(store__gt=F('sale')).values()
for i in ret2:
    print(i)

#第二种用法  (使用update更新)
#库存不变时候,售出数量乘2
models.Book.objects.all().update(sale=F('sale')*2)

#注: update 和更新后使用save的区别
# update 它可以更新指定字段,可以是多个, 而后者会将所有的字段做更新

9.2 Q查询

from django.db.models import Q
ret = models.Book.objects.filter(Q(~Q(id__lt=3) | Q(id__gt=5))&Q(id__lt=4))
print(ret)

#    ~  取反 
#    |  或
#    & 与 AND

10. 事物

一系列操作要同时成功执行,或都不执行,保证原子性操作。

from app01 import models

from django.db import transaction

try:
    with transaction.atomic():
        models.Publisher.objects.create(name='新华出版社1')
        int('aaa')
        models.Publisher.objects.create(name='新华出版社2')
        models.Publisher.objects.create(name='新华出版社2')
except Exception as e:
        print(e)

 

转载于:https://www.cnblogs.com/wcx666/p/10079696.html

你可能感兴趣的:(Django - ORM操作)