Django Multi-tenant 项目教程
项目介绍
Django Multi-tenant 是一个支持分布式多租户数据库(如 Postgres+Citus)的 Python/Django 库。它通过将租户上下文添加到查询中,使得数据库(例如 Citus)能够高效地将查询路由到正确的数据库节点,从而实现轻松的水平扩展。
项目快速启动
安装
首先,使用 pip 安装 django-multitenant:
pip install django_multitenant
配置
在 Django 项目的 settings.py
中添加以下配置:
INSTALLED_APPS = [
...
'django_multitenant',
...
]
模型修改
在模型中使用 TenantModel
和 TenantForeignKey
:
from django.db import models
from django_multitenant.models import TenantModel
from django_multitenant.fields import TenantForeignKey
class Product(TenantModel):
tenant_id = 'store_id'
name = models.CharField(max_length=255)
store = TenantForeignKey(to='Store', on_delete=models.CASCADE)
class Store(models.Model):
name = models.CharField(max_length=255)
中间件配置
在 settings.py
中添加中间件以自动处理租户上下文:
MIDDLEWARE = [
...
'django_multitenant.middleware.TenantMiddleware',
...
]
应用案例和最佳实践
多租户架构
多租户架构允许在一个数据库中为每个租户创建单独的 schema 或数据库。以下是一个典型的多租户应用案例:
-
创建租户模型:
class Tenant(models.Model): name = models.CharField(max_length=255)
-
使用租户模型:
class Product(TenantModel): tenant_id = 'tenant.id' name = models.CharField(max_length=255) tenant = TenantForeignKey(to='Tenant', on_delete=models.CASCADE)
最佳实践
- 使用中间件:确保每个请求都正确设置租户上下文。
- 模型继承:使用
TenantModel
和TenantForeignKey
简化模型定义。 - 数据分发:在 Citus 中分发数据,确保查询性能。
典型生态项目
Django Rest Framework
Django Multi-tenant 可以与 Django Rest Framework (DRF) 结合使用,提供多租户支持的 API:
-
安装 DRF:
pip install djangorestframework
-
配置 DRF:
INSTALLED_APPS = [ ... 'rest_framework', ... ]
-
创建序列化器:
from rest_framework import serializers from .models import Product class ProductSerializer(serializers.ModelSerializer): class Meta: model = Product fields = '__all__'
-
创建视图:
from rest_framework import viewsets from .models import Product from .serializers import ProductSerializer class ProductViewSet(viewsets.ModelViewSet): queryset = Product.objects.all() serializer_class = ProductSerializer
通过以上步骤,您可以快速启动并使用 Django Multi-tenant 项目,结合 DRF 提供多租户支持的 API。