当前位置：首页 > news >正文

django使用多个数据库实现

news 2025/8/16 3:19:10

一、说明：

　　在开发 Django 项目的时候，很多时候都是使用一个数据库，即 settings 中只有 default 数据库，但是有一些项目确实也需要使用多个数据库，这样的项目，在数据库配置和使用的时候，就比较麻烦一点。

二、Django使用多个数据库中settings中的DATABASES的设置

　　2.1 默认只是用一个数据库时 DATABASES 的设置（以 SQLite 为例）

DATABASES = {'default': {'ENGINE': 'django.db.backends.sqlite3',         'NAME': 'db.sqlite3',}
}

　　2.2 Django 数据库支持的 ENGINE 类型

- 'django.db.backends.postgresql'
- 'django.db.backends.mysql'
- 'django.db.backends.sqlite3'
- 'django.db.backends.oracle'

　　2.3 设置了多个数据库后 settings 中的 DATABASES 的设置

DATABASES = {'default': {'ENGINE': 'django.db.backends.sqlite3','NAME': 'db.sqlite3',},'db1': {'ENGINE': 'django.db.backends.mysql','NAME': 'mysql_test_db1','USER': 'root','PASSWORD': 'Se7eN521','HOST': '127.0.0.1','PORT': '3306'},'db2': {'ENGINE': 'django.db.backends.mysql','NAME': 'mysql_test_db2','USER': 'root','PASSWORD': 'Se7eN521','HOST': '127.0.0.1','PORT': '3306'}
}

三、实现思路

多个应用对应多个数据库和一个应用对应多个数据库
1. 情况一：项目有多个应用app 且需要使用到多个数据库
2. 情况二：项目只有一个应用app, 且但需要使用到多个数据库，
这两种情况的实现思路其实都是一样的，都是为每个数据库创建一个应用，即这个应用只对接一个数据库，如果这个应用不需要写任何业务逻辑的代码，也需要创建一个空的应用，主要是用来做数据库迁移的
核心思想就是：一个model类对应一个数据库，通过数据库路由和model定义时指定的all_label来实现。

四、案例实现

　　第一步：创建需要的应用app,并且在 INSTALLED_APPS 中引用

　　　　其中db1_app这个应用主要是用来对接数据库db1的

　　　　其中db2_app这个应用主要是用来对接数据库db2的

　　　　其中test_app这个应用主要用来实现业务逻辑的

　　第二步：创建应用app 和数据库之间的映射关系

　　　　在settings.py 文件夹中设置 DATABASE_APPS_MAPPING 的字典，里面主要是配置应用app 和数据库的对应关系

DATABASE_APPS_MAPPING = {"db1_app": "db1",   # db1_app 对应 db1 数据库"db2_app": "db2"    # db2_app 对应 db2 数据库
}

　　第三步：创建数据库路由

　　　　在项目的主文件夹即 settings.py 的同目录下创建一个 database_router.py 文件，该文件的作用就是给不同应用app 配置不同的数据库。

# _*_ coding:utf-8 _*_
# @Time : 2023/4/20 5:37 下午from django.conf import settingsDATABASE_MAPPING = settings.DATABASE_APPS_MAPPING
print('DATABASE_MAPPING = {}'.format(DATABASE_MAPPING))class DatabaseAppsRouter(object):# 设置 应用app 读取时数据库的设置def db_for_read(self, model, **hints)if model._meta.app_label in DATABASE_MAPPING:return DATABASE_MAPPING[model._meta.app_label]return Nonedef db_for_write(self, model, **hints):if model._meta.app_label in DATABASE_MAPPING:return DATABASE_MAPPING[model._meta.app_label]return Nonedef allow_relation(self, obj1, obj2, **hints):db_obj1 = DATABASE_MAPPING.get(obj1._meta.app_label)db_obj2 = DATABASE_MAPPING.get(obj2._meta.app_label)if db_obj1 and db_obj2:if db_obj1 == db_obj2:return Trueelse:return Falsereturn Nonedef allow_migrate(self, db, app_label, model_name=None, **hints):"""Make sure that apps only appear in the related database.根据app_label的值只在相应的数据库中创建一个表，如果删除该def或不指定过滤条件，则一个Model会在每个数据库里都创建一个表。"""if db in DATABASE_MAPPING.values():return DATABASE_MAPPING.get(app_label) == dbelif app_label in DATABASE_MAPPING:return Falsereturn None

　　第四步：在setting.py中配置 DATABASE_ROUTERS 指定自由路由文件：

#test_django为项目名，database_router为路由文件名，DatabaseAppsRouter为路由中创建的类名
DATABASE_ROUTERS = ['django_db_demo.database_router.DatabaseAppsRouter']

　　第五步：创建model类

　　　　说明：model 可以根据需要卸载任何一个应用app的model.py文件中，也可以分散写在多个应用的model.py中，这个根据自己的需要即可，但是如何推荐一定要在model类的Meta中指定app_label。不然会全部将表创建到default数据库中

from django.db import modelsclass SqliteModel(models.Model):"""帐号和用户关联"""sqlite_name = models.CharField(max_length=20)class Meta:# 当前这个 SqliteModel 定义的数据库的表将会创建在test_app 对应的default 数据库中app_label = "test_app"      # 当有多个数据库链接的时候，要通过app_label 来区分这个model对应那个数据库class Db1Model(models.Model):"""帐号和用户关联"""db1_name = models.CharField(max_length=20)class Meta:# 当前这个Db1Model 定义的数据库的表将会创建在 db1_app 对应的 db1 数据库中app_label = "db1_app"        # 当有多个数据库链接的时候，要通过app_label 来区分这个model对应那个数据库class Db2Model(models.Model):"""帐号和用户关联"""db2_name = models.CharField(max_length=20)class Meta:# 当前这个Db2Model 定义的数据库的表将会创建在 db2_app 对应的 db1 数据库中app_label = "db2_app"       # 当有多个数据库链接的时候，要通过app_label 来区分这个model对应那个数据库

　　第六步：数据迁移

python3 manage.py makemigrations  
python3 manage.py migrate --database=default   # 当有多个数据库，需要迁移多次
python3 manage.py migrate --database=db1
python3 manage.py migrate --database=db2