HackBase/python-cx_Oracle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Improved session pooling documentation.

Browse Source
This commit is contained in:
Anthony Tuininga 2019-07-02 14:12:22 -06:00
parent 39ff9fc189
commit 955ef7ecf5
2 changed files with 15 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/src/module.rst
View File

@ -179,10 +179,19 @@ Module Interface
edition=None, timeout=0, waitTimeout=0, maxLifetimeSession=0, \ edition=None, timeout=0, waitTimeout=0, maxLifetimeSession=0, \
sessionCallback=None) sessionCallback=None)
Create and return a :ref:`session pool object <sesspool>`. This Create and return a :ref:`session pool object <sesspool>`.
allows for very fast connections to the database and is of primary use in a Connection pooling in cx_Oracle is handled by Oracle's
server where the same connection is being made multiple times in rapid `Session pooling <https://www.oracle.com/pls/topic/lookup?
succession (a web server, for example). ctx=dblatest&id=GUID-F9662FFB-EAEF-495C-96FC-49C6D1D9625C>`__
technology. This allows cx_Oracle applications to support features
like `Application Continuity <https://www.oracle.com/pls/topic/lookup?
ctx=dblatest&id=GUID-A8DD9422-2F82-42A9-9555-134296416E8F>`__.
Session pooling creates a pool of available connections to the
database, allowing applications to acquire a connection very quickly.
It is of primary use in a server where connections are requested
in rapid succession and used for a short period of time, for example in a
web server.
If the connection type is specified, all calls to If the connection type is specified, all calls to
:meth:`~SessionPool.acquire()` will create connection objects of that type, :meth:`~SessionPool.acquire()` will create connection objects of that type,

2
doc/src/session_pool.rst
View File

@ -8,6 +8,8 @@ SessionPool Object
This object is an extension to the DB API. This object is an extension to the DB API.
Connection pooling in cx_Oracle is handled by SessionPool objects.
.. method:: SessionPool.acquire(user=None, password=None, cclass=None, \ .. method:: SessionPool.acquire(user=None, password=None, cclass=None, \
purity=cx_Oracle.ATTR_PURITY_DEFAULT, tag=None, matchanytag=False, \ purity=cx_Oracle.ATTR_PURITY_DEFAULT, tag=None, matchanytag=False, \