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

Fixed #13316 -- Added clarifying note about cross-database relations. 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@13178 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Russell Keith-Magee 2010-05-09 07:44:06 +00:00
parent ced4dd2aad
commit 9320c866ff
1 changed files with 34 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -193,13 +193,11 @@ An example
intentionally ignores some complex issues in order to intentionally ignores some complex issues in order to
demonstrate how routers are used. demonstrate how routers are used.
This example won't work on Postgres, Oracle, or MySQL with InnoDB This example won't work if any of the models in ``myapp`` contain
tables if any of the models in ``myapp`` contain foreign keys to relationships to models outside of the ``other`` database.
models outside of the ``other`` database. ForeignKeys to a remote :ref:`Cross-database relationships <no_cross_database_relations>`
database introduce referential integrity problems that Django can't introduce referential integrity problems that Django can't
currently handle. However, if you're using SQLite or MySQL with MyISAM currently handle.
tables, there is no referential integrity checking, so you will be
able to define cross-database foreign keys.
The master/slave configuration described is also flawed -- it The master/slave configuration described is also flawed -- it
doesn't provide any solution for handling replication lag (i.e., doesn't provide any solution for handling replication lag (i.e.,
@ -547,3 +545,32 @@ alias::
from django.db import connections from django.db import connections
cursor = connections['my_db_alias'].cursor() cursor = connections['my_db_alias'].cursor()
Limitations of multiple databases
=================================
.. _no_cross_database_relations:
Cross-database relations
------------------------
Django doesn't currently provide any support for foreign key or
many-to-many relationships spanning multiple databases. If you
have used a router to partition models to different databases,
any foreign key and many-to-many relationships defined by those
models must be internal to a single database.
This is because of referential integrity. In order to maintain a
relationship between two objects, Django needs to know that the
primary key of the related object is valid. If the primary key is
stored on a separate database, it's not possible to easily evaluate
the validity of a primary key.
If you're using Postgres, Oracle, or MySQL with InnoDB, this is
enforced at the database integrity level -- database level key
constraints prevent the creation of relations that can't be validated.
However, if you're using SQLite or MySQL with MyISAM tables, there is
no enforced referential integrity; as a result, you may be able to
'fake' cross database foreign keys. However, this configuration is not
officially supported by Django.