数据库的读写操作中,事务在保证数据的安全性和一致性方面起着关键的作用,而回滚正是这里面的核心操作。Django的ORM在事务方面也提供了不少的API。有事务出错的整体回滚操作,也有基于保存点的部分回滚。本文将讨论Django中的这两种机制的运行原理。
Django利用django.db.transaction模块中的API对数据库进行事务的管理
Django provides a straightforward API in the django.db.transaction module to manage the autocommit state of each database connection.
主要函数:
1. get_autocommit(using=None)
判断事务是否自动提交
2. set_autocommit(autocommit, using=None)
设置自动提交事务
这些函数使接受一个 using 参数表示所要操作的数据库。如果未提供,则 Django 使用 "default" 数据库。
3. on_commit(do something)
事务提交后马上执行任务,例如celery任务
例如:
with transation.atomic:
#do something and commit the transaction
transaction.on_commit(lambda: some_celery_task.delay('arg1'))
怎么使用?在哪里使用?
事务是一系列的数据库操作,在数据的安全性和减少网络请求方面都有很大的优势。关于数据库事务的文章有很多,我这里就不展开讨论了。
那么ORM中有哪些相关的API呢?
trasation模块中最重要的是一个Atomic类,Atomic是一个上下文管理器。可以使用@transaction.atomic 或者with transaction.atomic 的方式来调用。
为了设置保存点,即断点进行事务的执行和回滚,可以嵌套使用with transaction.atomic,例如官网的例子(伪代码):
with transaction.atomic(): # Outer atomic, start a new transaction
transaction.on_commit(foo) #事务提交后马上执行foo函数
try:
with transaction.atomic(): # Inner atomic block, create a savepoint
transaction.on_commit(bar) #事务提交后马上执行foo函数
raise SomeError() # Raising an exception - abort the savepoint
except SomeError:
pass
第一个with transaction.atomic()创建事务,第二个with transaction.atomic()创建保存点。
虽然错误raiseSomeError是从‘内部’的保存点发出来的,但只会影响到‘外部’的保存点,即只会回滚前面的数据库操作。
下面还会讨论另一种创建保存点的方法。
在使用transaction.atomic前需要注意的问题:
1. 数据库的自动提交默认为开启,如果要将它关闭,必须很小心。一旦使用了transaction,即关闭了自动提交。
2. 如果数据库之前的使用的是自动提交,那么在切换为非自动提交之前,必须确保当前没有活动的事务,通常可以手动执行commit() 或者 rollback() 函数来把未提交的事务提交或者回滚。
一、整体回滚
所有的数据库更新操作都会在一个事务中执行,如果事务中任何一个环节出现错误,都会回滚整个事务。
案例(伪代码1):
from django.db import transaction
# open a transaction
@transaction.atomic #装饰器格式
def func_views(request):
do_something()
a = A() #实例化数据库模型
try:
a.save()
except DatabaseError:
pass
此方案整个view都会在事务之中,所有对数据库的操作都是原子性的。
案例(伪代码2):
from django.db import transaction
def func_views(request):
try:
with transaction.atomic(): #上下文格式,可以在python代码的任何位置使用
a = A()
a.save()
#raise DatabaseError #测试用,检测是否能捕捉错误
except DatabaseError: # 自动回滚,不需要任何操作
pass
此方案比较灵活,事务可以在代码中的任意地方开启,对于事务开启前的数据库操作是必定会执行的,事务开启后的数据库操作一旦出现错误就会回滚。
需要注意的是:
1. python代码中对Models的修改和对数据库的修改的区别,数据库层面的修改不会影响Models实例变量。
如果在代码中修改一个变量,例如:
try:
with transaction.atomic():
a = A()
a.attribute = True #A表的某一个属性(即数据库的某一列)
a.save()
raise DatabaseError
except DatabaseError:
pass
print(a.attribute)
#输出结果:True
即使数据库回滚了,但是a实例的变量a.attribute还是会保存在Models实例中,如果需要修改,就需要在except DatabaseError后面进行。
2. transaction不需要在代码中手动commit和rollback的。因为只有当一个transaction正常退出的时候,才会对数据库层面进行操作。除非我们手动调用transaction.commit和transaction.rollback
实际案例(此实例用伪代码2的格式):
models.py
数据表
class Author(models.Model):
name = models.CharField(max_length=30,null=False)
age = models.IntegerField()
email = models.URLField(null=True)
class Count(models.Model):
name = models.CharField(max_length=30)
article_amount = models.IntegerField()
views.py
from django.shortcuts import render
from django.http import HttpResponse
from index.models import Author,Count
from django.db import transaction,IntegrityError
def add_author_views(request):
author_name = u'renyingying'
author = Author(name=author_name, age=24, email='renyingying@qqq.com')
# author.save()
count = Count(name=author_name, article_amount=1)
count.save()
try:
with transaction.atomic():
author.save()
raise DatabaseError #报出错误,检测事务是否能捕捉错误
except DatabaseError: # 自动回滚,不需要任何操作
pass
事务外的数据库操作正常执行,而事务内的数据库操作则会回滚。
author表
count表
将raise DatabaseError这一行代码注释掉,author才会有数据
二、保存点Savepoint(断点回滚)
保存点是事务中的标记,从原理实现上来说是一个类似存储结构的类。可以回滚部分事务,而不是完整事务,同时会保存部分事务。python后端程序可以使用保存点。
一旦打开事务atomic(),就会构建一系列等待提交或回滚的数据库操作。通常,如果发出回滚命令,则会回滚整个事务。保存点则提供了执行细粒度回滚的功能,而不是将执行的完全回滚transaction.rollback()。
工作原理:savepoint通过对返回sid后面的将要执行的数据库操作进行计数,并保存在内置的列表中,当对数据库数据库进行操作时遇到错误而中断,根据sid寻找之前的保存点并回滚数据,并将这个操作从列表中删除。
相关API:
1. savepoint(using = None)
创建一个新的保存点。这表示处于正常状态的事务的一个点。返回保存点ID(sid)。在一个事务中可以创建多个保存点。
2. savepoint_commit(sid,using = None)
发布保存点sid,从创建保存点开始执行的数据库操作将成为可能回滚事务的一部分
3. savepoint_rollback(sid,using = None)
将事务回滚到保存点sid
4. clean_savepoints(using = None)
重置用于生成唯一保存点ID的计数器
值得注意的是:
这些函数中的每一个都接受一个using参数,该参数是数据库的名称。如果using未提供参数,则使用"default"默认数据库。
案例:
models.py上文的案例一样
views.py
from django.db import transaction
# open a transaction
@transaction.atomic
def add_author_views(request):
# 自动提交方式
# Author.objects.create(name=u'wangbaoqiang',age=33,email='wangbaoqiang@qqq.com')
author_name = u'linghuchong'
author = Author(name=author_name,age=26,email='linghuchong@qqq.com')
author.save()
# transaction now contains author.save()
sid = transaction.savepoint()
try:
count = Count(name=author_name, article_amount=1)
count.save()
# transaction now contains author.save() and count.save()
transaction.savepoint_commit(sid)
# open transaction still contains author.save() and count.save()
except IntegrityError:
transaction.savepoint_rollback(sid)
# open transaction now contains only count.save()
# 保存author操作回滚后,事务只剩下一个操作
transaction.clean_savepoints() #清除保存点
注意:希望当遇到错误得到回滚的事务一定要放在try里面(如果放在try外面,虽然不会报错,但是是不会执行的)。如上面的例子,如果在给Count表执行插入数据发生错误,就会‘断点’回滚到Count表插入数据前,Author表插入的数据不变。
结果显示:
Author表
Count表
参考文章:
https://blog.csdn.net/m0_37422289/article/details/82221489