diff --git a/doc/src/module.rst b/doc/src/module.rst index 58aa579..13af4ed 100644 --- a/doc/src/module.rst +++ b/doc/src/module.rst @@ -179,10 +179,19 @@ Module Interface edition=None, timeout=0, waitTimeout=0, maxLifetimeSession=0, \ sessionCallback=None) - Create and return a :ref:`session pool object `. This - allows for very fast connections to the database and is of primary use in a - server where the same connection is being made multiple times in rapid - succession (a web server, for example). + Create and return a :ref:`session pool object `. + Connection pooling in cx_Oracle is handled by Oracle's + `Session pooling `__ + technology. This allows cx_Oracle applications to support features + like `Application Continuity `__. + + 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 :meth:`~SessionPool.acquire()` will create connection objects of that type, diff --git a/doc/src/session_pool.rst b/doc/src/session_pool.rst index 1fb6ddc..387aa8b 100644 --- a/doc/src/session_pool.rst +++ b/doc/src/session_pool.rst @@ -8,6 +8,8 @@ SessionPool Object 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, \ purity=cx_Oracle.ATTR_PURITY_DEFAULT, tag=None, matchanytag=False, \