p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

[1.5.X] Added an example of "default" database dictionary left blank; refs #19775. 

Thanks wsmith323 for the patch.

Backport of cf890c110e from master
This commit is contained in:
Tim Graham 2013-02-23 16:01:43 -05:00
parent 1702be89c8
commit 72db38facc
1 changed files with 24 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
docs/topics/db/multi-db.txt
View File

@ -20,11 +20,7 @@ documentation.
Databases can have any alias you choose. However, the alias Databases can have any alias you choose. However, the alias
``default`` has special significance. Django uses the database with ``default`` has special significance. Django uses the database with
the alias of ``default`` when no other database has been selected. If the alias of ``default`` when no other database has been selected.
the concept of a ``default`` database doesn't make sense in the context
of your project, you need to be careful to always specify the database
that you want to use. Django requires that a ``default`` database entry
be defined, but the parameters can be left blank if it will not be used.
The following is an example ``settings.py`` snippet defining two The following is an example ``settings.py`` snippet defining two
databases -- a default PostgreSQL database and a MySQL database called databases -- a default PostgreSQL database and a MySQL database called
@ -47,6 +43,29 @@ databases -- a default PostgreSQL database and a MySQL database called
} }
} }
If the concept of a ``default`` database doesn't make sense in the context
of your project, you need to be careful to always specify the database
that you want to use. Django requires that a ``default`` database entry
be defined, but the parameters dictionary can be left blank if it will not be
used. The following is an example ``settings.py`` snippet defining two
non-default databases, with the ``default`` entry intentionally left empty::
DATABASES = {
'default': {},
'users': {
'NAME': 'user_data',
'ENGINE': 'django.db.backends.mysql',
'USER': 'mysql_user',
'PASSWORD': 'superS3cret'
},
'customers': {
'NAME': 'customer_data',
'ENGINE': 'django.db.backends.mysql',
'USER': 'mysql_cust',
'PASSWORD': 'veryPriv@ate'
}
}
If you attempt to access a database that you haven't defined in your If you attempt to access a database that you haven't defined in your
:setting:`DATABASES` setting, Django will raise a :setting:`DATABASES` setting, Django will raise a
``django.db.utils.ConnectionDoesNotExist`` exception. ``django.db.utils.ConnectionDoesNotExist`` exception.