环境说明
- Python 3.8.10
- Django 3.2.6
- Centos 8.1
优质插件
django-reversion 数据版本管理
功能介绍:
- 数据版本管理,支持查看历史和还原数据.
- 上手简单,配置非常便利. ★★★★☆
- 对于复杂字段不支持,复杂字段只会显示最新的数据无法还原 (exp: manytomany)
使用步骤
步骤1: 安装包
1 2
| pip install django-reversion django-reversion==4.0.0
|
Add reversion
to INSTALLED_APPS
Run manage.py migrate
步骤2: 注册版本管理模型
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
| from django.contrib import admin from reversion.admin import VersionAdmin from django.db import models
class YourModel(models.Model): pro_id = models.CharField()
@admin.register(YourModel) class YourModelAdmin(VersionAdmin): pass
from reversion.views import RevisionMixin from rest_framework.viewsets import ModelViewSet
class APIView(RevisionMixin, ModelViewSet): def list(self, request, *args, **kwargs): pass
def create(self, request, *args, **kwargs): pass
def update(self, request, *args, **kwargs): pass
def destroy(self, request, *args, **kwargs): pass
|
步骤3: 初始化数据
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| python manager.py makemigrations reversion python manager.py migrate reversion --fake python manager.py migrate reversion
python manage.py createinitialrevisions
Creating revisions for 项目管理 - Created 48 / 48
|
其他使用 - 查询具体对象或者model中删除的历史记录
1 2 3 4 5 6 7 8 9
| from django.shortcuts import get_object_or_404 from reversion.models import Version
instance = get_object_or_404(model, id=version_obj_id) queryset = Version.objects.get_for_object(instance)
queryset = Version.objects.get_deleted(model)
|
其他使用 - 恢复历史记录
1 2 3 4 5
| from reversion.models import Version
reversion = Version.objects.filter(id=version_id) reversion[0].revision.revert()
|
TODO
- 如何 指定历史版本说明文字
- 如何 查看更明细的字段修改,比如 明确哪个字段变更, 以及字段从AA->BB
- Api-RevisionMixin 没有版本说明文字,如何添加修改?
参考资源:
参考资源
插件清单