From 583b9fc4101e5930c39f49d664d41a1596ba78f4 Mon Sep 17 00:00:00 2001 From: jtiai Date: Sun, 16 Sep 2018 14:48:25 +0300 Subject: [PATCH] Fixed #29757 -- Documented Oracle DSN and Easy Connect options. --- docs/ref/databases.txt | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt index e4bd5b87e7..77e6236a72 100644 --- a/docs/ref/databases.txt +++ b/docs/ref/databases.txt @@ -819,6 +819,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 ----------------