Django——连接多个数据库的实现方式

---

 

　　最近刚刚忙完手头的工作，所以决定把这一个项目里面的坑陆续梳理出来，一方面以后自己回顾的时候有个参考算是备忘，另一方面希望能帮到遇到跟我一样问题的兄弟。

*首先声明，我所用的版本是python3.5和Django2.0.4，公司使用的是Django，没有用restframework。
一、应用场景

　　首先一个Django项目里通常会有多个app，现在很多公司在这多个app中都是共用的一个数据库。在这种场景中是不存在所谓连多个数据库的。那以我的个人经历来说，公司近两个月让我陆陆续续做了一些小的系统（都是用于公司内部数据分拣的），因为每个都很急用，所以就做完一个上线一个，数据库和项目都部在不同服务器上了。直到有一天我们老总把我叫过去：“小肖啊，你抽时间把你做的几个系统合一下，咱们把它合成一个系统。就是登陆以后，出一个系统选择页面，选哪个就进那个系统。”

　　之后我一番奋战，把代码什么的合并到一起了。但是，发现数据不在一个库里，王炸！那么就有两种选择：

　　1.把所有的模型都通过默认的数据库放在一起，那么这样做就需要把之前处理的数据抽出来，并且对模型进行修改，把一些重复的表名进行一些区分；

　　2.是依然让数据存在之前的库里，把这些数据库迁移出来，抽取出Django自建的表，然后通过不同的数据库进行不同操作，这样也做到了不同系统间的数据的隔离。

　　所以最后我选用了第二种方案来做这个事情。

二、代码实现

　　代码中主要是三个部分，settings、models以及自己写的一个类。首先看看我们写的那个类：

 1 from django.conf import settings
 2 
 3 DATABASE_MAPPING = settings.DATABASE_APPS_MAPPING
 4 
 5 class DatabaseAppsRouter(object):
 6     """
 7     A router to control all database operations on models for different
 8     databases.
 9 
10     In case an app is not set in settings.DATABASE_APPS_MAPPING, the router
11     will fallback to the `default` database.
12 
13     Settings example:
14 
15     DATABASE_APPS_MAPPING = {'app1': 'db1', 'app2': 'db2'}
16     """
17 
18     def db_for_read(self, model, **hints):
19         """"Point all read operations to the specific database."""
20         """将所有读操作指向特定的数据库。"""
21         if model._meta.app_label in DATABASE_MAPPING:
22             return DATABASE_MAPPING[model._meta.app_label]
23         return None
24 
25     def db_for_write(self, model, **hints):
26         """Point all write operations to the specific database."""
27         """将所有写操作指向特定的数据库。"""
28         if model._meta.app_label in DATABASE_MAPPING:
29             return DATABASE_MAPPING[model._meta.app_label]
30         return None
31 
32     def allow_relation(self, obj1, obj2, **hints):
33         """Allow any relation between apps that use the same database."""
34         """允许使用相同数据库的应用程序之间的任何关系"""
35         db_obj1 = DATABASE_MAPPING.get(obj1._meta.app_label)
36         db_obj2 = DATABASE_MAPPING.get(obj2._meta.app_label)
37         if db_obj1 and db_obj2:
38             if db_obj1 == db_obj2:
39                 return True
40             else:
41                 return False
42         else:
43             return None
44 
45     def allow_syncdb(self, db, model):
46         """Make sure that apps only appear in the related database."""
47         """确保这些应用程序只出现在相关的数据库中。"""
48         if db in DATABASE_MAPPING.values():
49             return DATABASE_MAPPING.get(model._meta.app_label) == db
50         elif model._meta.app_label in DATABASE_MAPPING:
51             return False
52         return None
53 
54     def allow_migrate(self, db, app_label, model=None, **hints):
55         """Make sure the auth app only appears in the 'auth_db' database."""
56         """确保身份验证应用程序只出现在“authdb”数据库中。"""
57         if db in DATABASE_MAPPING.values():
58             return DATABASE_MAPPING.get(app_label) == db
59         elif app_label in DATABASE_MAPPING:
60             return False
61         return None

　　这个类主要是规范了数据库的一些读写操作。要注意，这个文件是放在和settings.py同级的目录下的。代码逻辑比较好理解，我就不解释了。用的时候直接复制粘贴一把梭，然后自己再做一些逻辑处理上的修改就可以了。

　　在settings中是配置三个地方，代码如下：

 1 # Database
 2 # https://docs.djangoproject.com/en/2.0/ref/settings/#databases
 3 
 4 DATABASES = {
 5     'default':{
 6         'NAME': 'venn',
 7         'ENGINE': 'sql_server.pyodbc',
 8         'HOST': '127.0.0.1',
 9         'PORT': '1433',
10         'USER': 'venndata',
11         'PASSWORD': 'venndata',
12         'OPTIONS':{
13             'driver':'SQL Server Native Client 10.0',
14         }
15     },
16     'venn': {
17         'NAME': 'venn',
18         'ENGINE': 'sql_server.pyodbc',
19         'HOST': '127.0.0.1',
20         'PORT': '1433',
21         'USER': 'venndata',
22         'PASSWORD': 'venndata',
23         'OPTIONS':{
24             'driver':'SQL Server Native Client 10.0',
25         }
26     },
27     'vip_cluster': {
28         'NAME': 'vip_cluster',
29         'ENGINE': 'sql_server.pyodbc',
30         'HOST': '127.0.0.1',
31         'PORT': '1433',
32         'USER': 'venndata',
33         'PASSWORD': 'venndata',
34         'OPTIONS':{
35             'driver':'SQL Server Native Client 10.0',
36         }
37     },
38     'catecheck': {
39         'NAME': 'catecheck',
40         'ENGINE': 'sql_server.pyodbc',
41         'HOST': '127.0.0.1',
42         'PORT': '1433',
43         'USER': 'venndata',
44         'PASSWORD': 'venndata',
45         'OPTIONS':{
46             'driver':'SQL Server Native Client 10.0',
47         }
48     },
49     'skucheck': {
50         'NAME': 'skucheck',
51         'ENGINE': 'sql_server.pyodbc',
52         'HOST': '127.0.0.1',
53         'PORT': '1433',
54         'USER': 'venndata',
55         'PASSWORD': 'venndata',
56         'OPTIONS':{
57             'driver':'SQL Server Native Client 10.0',
58         }
59     },
60     'barcode': {
61         'NAME': 'barcode',
62         'ENGINE': 'sql_server.pyodbc',
63         'HOST': '127.0.0.1',
64         'PORT': '1433',
65         'USER': 'venndata',
66         'PASSWORD': 'venndata',
67         'OPTIONS':{
68             'driver':'SQL Server Native Client 10.0',
69         }
70     }
71 }
72 
73 
74 DATABASE_ROUTERS = ['vennsystem.database_router.DatabaseAppsRouter']
75 
76 
77 DATABASE_APPS_MAPPING = {
78     # example:
79     # 'app_name':'database_name',
80     'venncheck': 'skucheck',
81     'barcode': 'barcode',
82     'catecheck': 'catecheck',
83     'clust': 'vip_cluster',
84     'the_entrance': 'venn',
85     'admin': 'venn',
86     'auth': 'venn',
87     'contenttypes': 'venn',
88     'sessions': 'venn',
89 }

　　DATABASES大家都知道，是配置数据库连接的（这里要注意的是我用的是sql server数据库，里面OPTIONS是非常重要的参数，一定要把这个加进去，不然跑不起来）。default是默认的数据库，在这里可以为{}，但是一旦为空不可以执行'python manage.py migrate'（会在下个部分说怎么处理）

　　之后是DATABASE_ROUTERS这个指向的是我们自己写的那个类（['项目名.文件名.类名']）。最后是路由分配，把app的名字和数据库对应起来。 

　　在模型中的部分特别简单，只要加两行代码就可以解决：

1 class Href(models.Model):
2     name = models.CharField(max_length=100)
3     path = models.CharField(max_length=100)
4 
5     class Meta:
6         app_label = 'the_entrance'

　　就是这样的东西，加上app_label以后就会指明所属的app。

三、执行

　　执行的顺序就是大家熟悉的了：

　　1.python manage.py makemigrations

　　之后的稍有不同：

　　2.python manage.py migrate --database=skucheck

　　   python manage.py migrate --database=barcode

　　   ......

　　   python manage.py migrate（只有默认数据库不为空时才可以这么实用，若为空则是用上面的方法）

　　   其实在这里没有特别的执行顺序，但是我个人建议大家是最后执行migrate（即默认数据库）。另外要注意一点，admin、auth、contenttypes和sessions是一定要在一个app里被makemigrations放到一个XXXX_initial.py文件中的，不然你怎么migrate都不会有这些Django自建的表的！

---

 

****最后的最后一定要注意：已经不在一个库里了，没法跨库建立约束关系，放弃外键，老实的一步步查！****