@@ -51,14 +51,27 @@ ConnectParams Methods
51
51
externalauth=None, mode=None, disable_oob=None, stmtcachesize=None, \
52
52
edition=None, tag=None, matchanytag=None, config_dir=None, \
53
53
appcontext=[], shardingkey=[], supershardingkey=[], debug_jdwp=None, \
54
- connection_id_prefix=None, ssl_context=None, sdu=None, handle=None)
54
+ connection_id_prefix=None, ssl_context=None, sdu=None, \
55
+ pool_boundary=None, use_tcp_fast_open=False, handle=None)
55
56
56
57
Sets the default values for one or more of the parameters of an empty
57
58
ConnectParams object. A default will be overriden when a connection string
58
59
with that attribute is parsed. After a ConnectParams object has been
59
60
populated by parsing a connection string, ``ConnectParams.set() `` will not
60
61
override any values.
61
62
63
+ .. versionchanged :: 2.1.0
64
+
65
+ The ``pool_boundary `` and ``use_tcp_fast_open `` parameters were added.
66
+
67
+ .. versionchanged :: 2.0.0
68
+
69
+ The ``ssl_context `` and ``sdu `` parameters were added.
70
+
71
+ .. versionchanged :: 1.4.0
72
+
73
+ The ``connection_id_prefix `` parameter was added.
74
+
62
75
63
76
.. _connparamsattr :
64
77
@@ -199,6 +212,24 @@ ConnectParams Attributes
199
212
200
213
This attribute is supported in the python-oracledb Thin and Thick modes.
201
214
215
+ .. attribute :: ConnectParams.pool_boundary
216
+
217
+ This read-only attribute is one of the strings "statement" or
218
+ "transaction" which indicates when pooled DRCP or PRCP connections can be
219
+ returned to the pool. If the value is "statement", then pooled DRCP or
220
+ PRCP connections are implicitly released back to the DRCP or PRCP pool
221
+ when the connection is stateless (that is, there are no active cursors,
222
+ active transactions, temporary tables, or temporary LOBs). If the value is
223
+ "transaction", then pooled DRCP or PRCP connections are implicitly
224
+ released back to the DRCP or PRCP pool when either one of the methods
225
+ :meth: `Connection.commit() ` or :meth: `Connection.rollback() ` are called.
226
+ This attribute requires the use of DRCP or PRCP with Oracle Database 23c
227
+ (or later). See :ref: `implicitconnpool ` for more information.
228
+
229
+ This attribute is supported in the python-oracledb Thin and Thick modes.
230
+
231
+ .. versionadded :: 2.1.0
232
+
202
233
.. attribute :: ConnectParams.port
203
234
204
235
This read-only attribute is an integer that returns the port number on
@@ -359,6 +390,20 @@ ConnectParams Attributes
359
390
360
391
This attribute is supported in the python-oracledb Thin and Thick modes.
361
392
393
+ .. attribute :: ConnectParams.use_tcp_fast_open
394
+
395
+ This read-only attribute is a boolean which indicates whether to use an
396
+ an `Oracle Autonomous Database Serverless (ADB-S)
397
+ <https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/
398
+ adbsb/adbsb-overview.html#GUID-A7435462-9D74-44B4-8240-4A6F06E92348> `__
399
+ specific feature that can reduce the latency in round-trips to the database
400
+ after a connection has been established. This feature is only available
401
+ with certain versions of ADB-S. The default value is False.
402
+
403
+ This attribute is used in both python-oracledb Thin and Thick modes.
404
+
405
+ .. versionadded :: 2.1.0
406
+
362
407
.. attribute :: ConnectParams.user
363
408
364
409
This read-only attribute is a string that specifies the name of the user to
0 commit comments