Django多数据库配置与数据迁移实战指南

Noah

发布时间：2026-10-14| 6人浏览过

原创

本文详解Django项目中配置多个数据库的方法，包括通过DATABASE_ROUTERS实现App与数据库的绑定，以及使用using()指定读写库。同时涵盖Django 1.6至1.7+版本的数据库同步命令，以及针对多库环境的dumpdata导出与loaddata导入操作，确保数据在不同数据库间准确迁移。

Django多数据库配置概述

本文介绍在Django项目中配置和使用多个数据库的具体方法，重点讲解多数据库环境下的数据读写策略，以及在此场景下进行数据导入与导出的实际操作步骤。

这里提供一种简洁实用的配置方案，若需深入了解底层原理，请参考Django官方文档。

App与数据库绑定配置

1. 为每个App单独指定数据库

Django的settings.py文件中包含数据库配置项，默认存在一个名为default的数据库。我们可以在此基础上添加其他数据库配置，例如：


# Database
# https://docs.djangoproject.com/en/1.8/ref/settings/#databases
DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.sqlite3',
    'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
  },
  'db1': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME': 'dbname1',
    'USER': 'your_db_user_name',
    'PASSWORD': 'yourpassword',
    "HOST": "localhost",
  },
  'db2': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME': 'dbname2',
    'USER': 'your_db_user_name',
    'PASSWORD': 'yourpassword',
    "HOST": "localhost",
  },
}
 
# use multi-database in django
# add by WeizhongTu
DATABASE_ROUTERS = ['project_name.database_router.DatabaseAppsRouter']
DATABASE_APPS_MAPPING = {
  # example:
  #'app_name':'database_name',
  'app1': 'db1',
  'app2': 'db2',
}

在project_name文件夹下创建database_router.py文件，内容如下：


# -*- coding: utf-8 -*-
from django.conf import settings
 
DATABASE_MAPPING = settings.DATABASE_APPS_MAPPING
 
 
class DatabaseAppsRouter(object):
  """
  A router to control all database operations on models for different
  databases.
 
  In case an app is not set in settings.DATABASE_APPS_MAPPING, the router
  will fallback to the `default` database.
 
  Settings example:
 
  DATABASE_APPS_MAPPING = {'app1': 'db1', 'app2': 'db2'}
  """
 
  def db_for_read(self, model, **hints):
    """"Point all read operations to the specific database."""
    if model._meta.app_label in DATABASE_MAPPING:
      return DATABASE_MAPPING[model._meta.app_label]
    return None
 
  def db_for_write(self, model, **hints):
    """Point all write operations to the specific database."""
    if model._meta.app_label in DATABASE_MAPPING:
      return DATABASE_MAPPING[model._meta.app_label]
    return None
 
  def allow_relation(self, obj1, obj2, **hints):
    """Allow any relation between apps that use the same database."""
    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 True
      else:
        return False
    return None
 
  # for Django 1.4 - Django 1.6
  def allow_syncdb(self, db, model):
    """Make sure that apps only appear in the related database."""
 
    if db in DATABASE_MAPPING.values():
      return DATABASE_MAPPING.get(model._meta.app_label) == db
    elif model._meta.app_label in DATABASE_MAPPING:
      return False
    return None
 
  # Django 1.7 - Django 1.11
  def allow_migrate(self, db, app_label, model_name=None, **hints):
    print db, app_label, model_name, hints
    if db in DATABASE_MAPPING.values():
      return DATABASE_MAPPING.get(app_label) == db
    elif app_label in DATABASE_MAPPING:
      return False
    return None

通过上述配置，即可实现指定App使用特定数据库的功能。你也可以配置多个SQLite3数据库，从而为每个App分配独立的数据库。对于未设置或未在映射中指定的App，系统将自动使用默认数据库。

数据库读写操作指定

2. 在操作中指定使用的数据库

在执行查询语句时，通过调用using(dbname)方法来明确指定要操作的数据库实例。

# 查询示例 YourModel.objects.using('db1').all() 或者 YourModel.objects.using('db2').all() # 保存或删除操作 user_obj.save(using='new_users') user_obj.delete(using='legacy_users')

多数据库数据迁移与导入导出

3. 多数据库环境下的数据导入与导出

在多数据库环境中执行数据迁移命令时，与单数据库的区别在于需要显式指定目标数据库。

如果目标不是default（默认数据库），必须在命令后添加--database参数，指定settings.py中对应的数据库名称，例如：--database=db1 或 --database=db2。

数据库同步（创建表结构）

# Django 1.6及以下版本 python manage.py syncdb #同步默认的数据库，和原来的没有区别 # 同步数据库 db1 (注意：不是数据库名是db1,是settings.py中的那个db1，不过你可以使这两个名称相同，容易使用) python manage.py syncdb --database=db1 # Django 1.7 及以上版本 python manage.py migrate --database=db1

数据导出操作

python manage.py dumpdata app1 --database=db1 > app1_fixture.json python manage.py dumpdata app2 --database=db2 > app2_fixture.json python manage.py dumpdata auth > auth_fixture.json

数据库导入操作