django ORM

本文发布于Cylon的收藏册，转载请著名原文链接~

https://www.cnblogs.com/Dominic-Ji/p/11516152.html

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

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

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

django中仅测试ORM

导入model，然后直接使用对应对象进行ORM操作。

import os
if __name__ == "__main__":
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "app.settings")
    import django
    django.setup()
    from xxx import models
    models.User.objects.all()

连接数据库

django配置数据库

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'USER': 'root',
        'PASSWORD': '111',
        'HOST':'127.0.0.1',
        'NAME': 'book',
        'CHARSET': 'utf8'
    }
}

可选：pymysql 使用模块连接MySQL数据库:：在项目中__init__.py 文件中添加配置：

import pymysql
pymysql.install_as_MySQLdb()

创建（表）对象

ORM中，O (Object) 代表"对象"，而R(Relational) 则代表"关系"。所以创建表即创建一个类，字段则是类的属性。类的每个实例则对应表中的一条记录。

在Django中model就是你数据来源。通常，一个model映射到一个数据库表，一般情况下基本满足：

每个model（表）都是一个Python类，它是django.db.models.Model的子类即继承models.Model。
类的每个属性都代表一个字段（字段）。
实例化出的对象，代表表中的记录。

例如

class User(models.Model):
name = models.CharField(max_length=32)
age = models.IntegerField()
registration_time = models.DateField()

字段类型

Reference

字段类型说明

字段选项说明

必需掌握字段类型说明：

BigIntegerField or BigAutoField: 1~9223372036854775807 的64位自增int
CharField: 用于存储字符串，对应MySQL中varchar
DateField: python中的datetime.date.today() 即 Y-m-d
DateTimeField：timezone.now - django.utils.timezone.now()为YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]，相当于Python中的datetime.datetime()
DecimalField：小数，使用：models.DecimalField(..., max_digits=5, decimal_places=2)
BooleanField: 代表一个true/false的布尔值。
AutoField: int类型的自增列，必须填入参数primary_key=True 。当model中如果没有自增列，则自动会创建一个列名为id的列。

字段参数

Reference

字段选项说明

必须掌握的字段选项：

null：表示该字段是否允许空值，如果为true，django将在数据库中将空值存储为null。默认为false。使用：models.CharField(null=True)
db_index：是否对字段创建索引，如果为true，将为此字段创建数据库索引。
default：字段的默认值。这可以是值或可调用的对象。如果可调用它将每次创建新对象时调用它。
primary_key：primary_key=True，该字段为主键。

时间字段特殊参数：

auto_now_add: auto_now_add=True，仅在创建对象时将当前时间插入到数据库中。如果不设置
auto_now: auto_now=True，每次更新数据记录的时候会更新该字段。

增

save()

Python对象中表示数据库表数据，模型类表示数据库表，该类的实例表示数据库表中的记录。

要创建一个对象，然后调用save()将其保存到数据库中。

save() 直到调用时，才操作数据库，并且没有返回值。

save() 必须实例化后调用

b = models.User(name="zhangsan",age=18)
b.save()

create()

创建对象并且保存

models.User.objects.create(name="lisi", age=19)

删

delete()

delete() 在查询集中的所有行上执行SQL DELETE，并返回删除的对象数量和每个对象类型的删除次数的字典。

delete()无法对QuerySet 上调用delete()

models.User.objects.filter(pk=1).delete()

all() 查询所有数据 filter() 带有过滤条件的查询 exclude() 排除数据，exclude('xxx=xxx') order_by() 排序降序 models.User.objects.order_by('-age') reverse() 反转，反转的数据必须是 order_by()后的数据 distinct() 去重，主键是唯一值，需要过滤主键

返回值为特殊的QuerySet

values() 返回一个可迭代的字典序列。（列表套字典） values_list() 返回一个可迭代的元祖序列。（列表套QuerySet）

返回值为具体对象

get() first() last()

返回值布尔值：

exists()

返回值为数字

count() 统计当前数据个数

django 查看原生SQL的方法

``QuerySet 可以使用models.User.objects.values_list().query`
终端打印，在setting.py中配置下列
```
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console':{
            'level':'DEBUG',
            'class':'logging.StreamHandler',
        },
    },
    'loggers': {
        'django.db.backends': {
            'handlers': ['console'],
            'propagate': True,
            'level':'DEBUG',
        },
    }
}
```
条件查询

基于双下划线的查询

查询大于的18的用户 models.User.objects.filter(age__gt=12)

查询年龄为18,19,20岁的用户 models.User.objects.filter(age__in=[18,19,20])

查询90后用户 models.User.objects.filter(age__range=[22,31])

模糊查询：查询名字包含l 的用户：models.User.objects.filter(name__contains='li')

模糊查询：忽略大小写查询：models.User.objects.filter(name__icontains='li')

查询注册时间为 2020 7月份数据：models.User.objects.filter(registration_time__month=7)

多表操作

在django中外键的存在使得ORM框架在处理表关系的时候异常的强大。在Django中，外键类定义为：class ForeignKey(to,on_delete,**options) 。可以看到外键的参数大致分为：

to：引用那个model（表）。
on_delete：当使用了外键引用model（表）的数据被删除后的操作。

定义一个外键：

在关系数据库中外键的作用是在于将表彼此关联起来。Django提供了定义三种最常见的数据库关系类型的方法：多对一、多对多和一对一。

而关系型字段分为：

关系型字段	对应关系
ForeignKey	多对一
ManyToManyField	多对多
OneToOneField	一对一

如下：

一个作者可以写多本书，但一本书只能由一个出版社出版，使用 ForeignKey 可以直接使用Book实例中通过 Press 属性来操作对应的Press模型。
一本书可以由多个 Author 编写，也可以由一个作者 Author 编写，但一个作者( Author)也可以编写多本书 Book。
一般情况下，出版社仅记录Author的一个联系方式，也就是 Author 与 AuthorDetail 为一对一关系。

class Book(models.Model):
    title = models.CharField(max_length=32)
    price = models.DecimalField(max_digits=5, decimal_places=2)
    publishData = models.DateField(auto_now_add=True)

    press = models.ForeignKey(to="Press")
    author = models.ManyToManyField(to="Author")
    
class Press(models.Model):
    name = models.CharField(max_length=32,null=True)
    address = models.CharField(max_length=32)
    email = models.EmailField()

class Author(models.Model):
    name = models.CharField(max_length=32,null=True)
    age = models.IntegerField()
    authorDetail = models.OneToOneField(to="AuthorDetail")

class AuthorDetail(models.Model):
    phoneNumber = models.BigIntegerField()
    address = models.CharField(max_length=32)

外键的基本操作

添加外键关系：

bookobj = models.Book.objects.filter(pk=1).first()
bookobj.author.add(1) # 给主键为1的书籍绑定一个主键1的作者
bookobj.author.add([1,2,3]) # 给主键为1的书籍绑定多个作者

移除关系：bookobj.author.remove(1)

修改关系：bookobj.author.set(2)

清空该关系：bookobj.author.clear() # 清除所有这个作者的书

正反向概念

正向查询：在子表中，查询父表（外键所在表）的信息反向查询：通过父表，查询子表的信息

多表查询

查询口诀：正向查询按外键字段，反向查询按表名（model）

all() 当结果为多个时，需要使用.all() 如多对多，一对多

查询书籍1的出版社 正向查询

book = models.Book.objects.filter(pk=1).first()
print book.press.name

查询书籍1的作者 正向查询

book = models.Book.objects.filter(pk=1).first()
print book.author.all()

查询作者1的电话

auther = models.Author.objects.filter(pk=1).first()
print auther.authorDetail.phoneNumber

查询出版社拥有的书 反向查询

press = models.Press.objects.filter(pk=1).first()
books = press.book_set.all()

查询作者Phoenix写的书

auther = models.Author.objects.filter(name="Phoenix").first()
print auther.book_set.all()

根据手机号查询作者

phone = models.AuthorDetail.objects.filter(phoneNumber=1511111111).first()
print phone.author.name

基于下划线的查询

根据名称查询手机号

models.Author.objects.filter(name="Phoenix").values("authorDetail__phoneNumber")
# 获取两个表中的字段
models.Author.objects.filter(name="Phoenix").values("authorDetail__phoneNumber","name")

查询书籍1的作者名称

# 正向
models.Book.objects.filter(pk=1).values("author__name")
# 反向
models.AuthorDetail.objects.filter(author__name="Phoenix").values("phoneNumber","author__name")

查询书籍1的作者手机号

models.Book.objects.filter(pk=1).values("author__authorDetail__phoneNumber")

聚合查询 (aggregate)

aggregate() 是 QuerySet 的一个终止子句，意思是说，它返回一个包含一些键值对的字典。键的名称是聚合值的标识符，值是计算出来的聚合值。键的名称是按照字段和聚合函数的名称自动生成出来的。

使用聚合查询需要引入具体的类 from django.db.models import Avg,Max,Min,Count,Sum

获取书的总数 Book.objects.count()

对数据进行聚合查询：aggregate(别名 = 聚合函数名[avg,max..]("属性名称"))

分组查询（annotate）

分组查询一般会与聚合函数一起使用，使用前也许引入具体类：from django.db.models import Avg,Max,Min,Count,Sum

返回值：

分组后，用 values 取值，则返回值是 QuerySet 数据类型里面为一个个字典；
分组后，用 values_list 取值，则返回值是 QuerySet 数据类型里面为一个个元组。

分组位置 annotate：

values or values_list 在 annotate 前：values 或者 values_list 是声明以什么字段分组，annotate 执行分组。
values or values_list 在annotate后： annotate 表示直接以当前表的pk执行分组，values 或者 values_list 表示查询哪些字段，并且要将 annotate 里的聚合函数起别名，在 values 或者 values_list 里写其别名。

统计每本书的作者有几个

models.Book.objects.annotate(autherNum=Count('author__id')).values('autherNum','title')

统计出版社最便宜书的价格

 models.Press.objects.annotate(minPrice=Min('book__price')).values("name", "minPrice")

统计不止一个作者的书

models.Book.objects.annotate(autherCount=Count("author__id")).filter(autherCount__gt=1).values("title","autherCount")

统计作者出书的总价

models.Author.objects.annotate(bookPrice=Sum("book__price")).values("name","bookPrice")

根据指定字段分组

F&Q查询

F查询

F 可以在对Model字段值的转换时，无需从数据库中将值加载到内存中，进行操作后再save()。

例如。通常情况下，在更新数据时需先从数据库里将原数据加载到内存里，编辑后最后提交。

order = Order.objects.get(orderid='1')
order.amount += 1
order.save()

而F 可以直接对值进行运行而不必将数据从库中拉到内存中。例如

卖出大于库存的书籍

models.Book.objects.filter(sell__gt=F('stock'))

对所有书籍价格增加100

models.Book.objects.update(price=F('price')+100)

Q查询

ORM filter() 等方法中的关键字参数查询都是一起进行 AND 的。如需要执行更复杂的查询（例如OR语句），你可以使用Q对象。

Q是对查询条件进行字符串拼接，故可以组合 & 和| 等操作符以及使用括号进行分组来编写任意复杂的Q对象。同时，Q 对象可以使用~ 操作符取反。

Q 对象允许组合正常的查询和取反(NOT) 查询。

如**：查询作者是的Radamandis和Phoenix**

models.Book.objects.filter(Q(authors__name="Phoenix")|Q(authors__name="Radamandis"))

查询作者不是Phoenix的书

models.Book.objects.filter(~Q(author__name="Phoenix"))

也可以进行组合查询: 查询作者不是Phoenix 并且价格大于700

models.Book.objects.filter(~Q(author__name="Phoenix") & Q(publishData__gt="2021-08-04"))

Q的第二种使用方法

query = Q()
query.connector = 'OR' #默认为and
query.children.append(('id', 1))
query.children.append(('id', 2))
query.children.append(('id', 3))

models.Book.objects.filter(query)

事务

Reference

transactions

在操作多表，或多次变更数据时，这些数据的修改应该是一个整体事务，即要么一起成功，要么一起失败。Django 默认的事务行为是自动提交，即每执行一次则会自动提交到数据库。

在django中事务的使用是通过django.db.transaction模块提供的atomic来定义事务。所以使用事务需要先引入from django.db import transaction

事务的使用可以通过装饰器 或 with语句。

通过装饰器方式（全局事务），在整个函数内为一个事务，要么一起成功，要么一起失败。

@transaction.atomic
def test():
    models.Press.objects.create(name="Yasgot",address="Nordische Botschaften", email="yasgot.com@gamil.com")
    print "insert ok."
    time.sleep(10)
    models.Press.objects.create(name="Yasgot",address="Nordische Botschaften", email="yasgot.com@gamil.com")
    book = models.Press.objects.all()
    print book

通过with方式（局部事务），在函数中，使用 with transaction.atomic(): 代码块内的为一个事务。

def viewfunc(request):
	with transaction.atomic():
	# 这部分代码会在事务中执行

事务的异常处理

保存点

保存点（savepoint），在事务中可以做到部分回滚，而不是整个事务。

atomic() 为开启一个事务，而回滚是通过，transaction.rollback() 执行的完全回滚。而django也推荐仅使用atomic()。

savepoint(*using=None*)：创建新的保存点，返回保存点ID (sid) 。
savepoint_commit(*sid*, *using=None*)：释放保存点 sid 。如回滚等将不在保证之前的保存点的数据而是整个事务。
savepoint_rollback(*sid*, *using=None*):回滚事务 sid 。

下面是官方的一个例子：example-to-savepoint

from django.db import transaction

# open a transaction
@transaction.atomic
def viewfunc(request):

    a.save()
    # transaction now contains a.save()

    sid = transaction.savepoint()

    b.save()
    # transaction now contains a.save() and b.save()

    if want_to_keep_b:
        transaction.savepoint_commit(sid)
        # open transaction still contains a.save() and b.save()
    else:
        transaction.savepoint_rollback(sid)
        # open transaction now contains only a.save()

执行原生SQL

Reference

raw-sql

raw() :执行原生语句 django.db.models.query.RawQuerySet

django.db.connection()：；连接多个库 from django.db import connection

自定义字段类

Reference

custom-filed

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

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

本文发布于Cylon的收藏册，转载请著名原文链接~

链接：https://www.oomkill.com/2021/10/django-orm/

版权：本作品采用「署名-非商业性使用-相同方式共享 4.0 国际」许可协议进行许可。

django中仅测试ORM

连接数据库

创建（表）对象

字段类型

Reference

字段参数

增

save()

create()

删

delete()

查

查询必会的方法

django 查看原生SQL的方法

条件查询

基于双下划线的查询

多表操作

外键的基本操作

正反向概念

多表查询

基于下划线的查询

聚合查询 (aggregate)

分组查询（annotate）

F&Q查询

F查询

Q查询

事务

事务的异常处理

保存点

执行原生SQL

Reference

自定义字段类

Reference

相关阅读

django中仅测试ORM¶

连接数据库¶

创建（表）对象¶

字段类型¶

Reference¶

字段参数¶

增¶

save()¶

create()¶

删¶

delete()¶

查¶

查询必会的方法¶

django 查看原生SQL的方法¶

条件查询¶

基于双下划线的查询¶

多表操作¶

外键的基本操作¶

正反向概念¶

多表查询¶

基于下划线的查询¶

聚合查询 (aggregate)¶

分组查询（annotate）¶

F&Q查询¶

F查询¶

Q查询¶

事务¶

事务的异常处理¶

保存点¶

执行原生SQL¶

Reference¶

自定义字段类¶

Reference¶

相关阅读

django中仅测试ORM

连接数据库

创建（表）对象

字段类型

Reference

字段参数

增

save()

create()

删

delete()

查

查询必会的方法

django 查看原生SQL的方法

条件查询

基于双下划线的查询

多表操作

外键的基本操作

正反向概念

多表查询

基于下划线的查询

聚合查询 (aggregate)

分组查询（annotate）

F&Q查询

F查询

Q查询

事务

事务的异常处理

保存点

执行原生SQL

Reference

自定义字段类

Reference