diff options
author | jtiai <jani.tiainen@tintti.net> | 2018-09-16 14:48:25 +0300 |
---|---|---|
committer | Tim Graham <timograham@gmail.com> | 2018-09-17 10:48:21 -0400 |
commit | 93f4080813763b14a23f3b8c8994de6043208586 (patch) | |
tree | 7c3747bd462ea233ad6a04a1ed59ee13ee557d88 | |
parent | 430966c2fc23eeca038b0268c995a894c4b8b154 (diff) | |
download | django-93f4080813763b14a23f3b8c8994de6043208586.tar.gz |
[2.1.x] Fixed #29757 -- Documented Oracle DSN and Easy Connect options.
Backport of 583b9fc4101e5930c39f49d664d41a1596ba78f4 from master
-rw-r--r-- | docs/ref/databases.txt | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt index 42bd419b87..258bd5860a 100644 --- a/docs/ref/databases.txt +++ b/docs/ref/databases.txt @@ -812,6 +812,24 @@ You should either supply both :setting:`HOST` and :setting:`PORT`, or leave both as empty strings. Django will use a different connect descriptor depending on that choice. +Full DSN and Easy Connect +~~~~~~~~~~~~~~~~~~~~~~~~~ + +A Full DSN or Easy Connect string can be used in :setting:`NAME` if both +:setting:`HOST` and :setting:`PORT` are empty. This format is required when +using RAC or pluggable databases without ``tnsnames.ora``, for example. + +Example of an Easy Connect string:: + + 'NAME': 'localhost:1521/orclpdb1', + +Example of a full DSN string:: + + 'NAME': ( + '(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))' + '(CONNECT_DATA=(SERVICE_NAME=orclpdb1)))' + ), + Threaded option ---------------- |