[2.1.x] Fixed #29757 -- Documented Oracle DSN and Easy Connect options.

Backport of 583b9fc410 from master
This commit is contained in:
jtiai 2018-09-16 14:48:25 +03:00 committed by Tim Graham
parent 430966c2fc
commit 93f4080813
1 changed files with 18 additions and 0 deletions

View File

@ -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
----------------