dnrops
/
python-oracledb
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Added support for configuring the SDU used for sizing internal buffers.

This commit is contained in:
Anthony Tuininga 2023-12-12 11:45:52 -07:00
parent 51cc3ba744
commit dbe610616d
20 changed files with 205 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/src/api_manual/connect_param.rst
View File

@ -51,7 +51,7 @@ ConnectParams Methods
externalauth=None, mode=None, disable_oob=None, stmtcachesize=None, \
edition=None, tag=None, matchanytag=None, config_dir=None, \
appcontext=[], shardingkey=[], supershardingkey=[], debug_jdwp=None, \
connection_id_prefix=None, ssl_context=None, handle=None)
connection_id_prefix=None, ssl_context=None, sdu=None, handle=None)
Sets the default values for one or more of the parameters of an empty
ConnectParams object. A default will be overriden when a connection string
@ -248,6 +248,22 @@ ConnectParams Attributes
This attribute is supported in the python-oracledb Thin and Thick modes.
.. attribute:: ConnectParams.sdu
This read-only attribute is an integer that returns the requested size of
the Session Data Unit (SDU), in bytes. The value tunes internal buffers
used for communication to the database. Bigger values can increase
throughput for large queries or bulk data loads, but at the cost of higher
memory use. The SDU size that will actually be used is negotiated down to
the lower of this value and the database network SDU configuration value.
See the `SQL*Net documentation
<https://www.oracle.com/pls/topic/lookup?ctx=dblatest&
id=GUID-86D61D6F-AD26-421A-BABA-77949C8A2B04>`__ for more details.
This attribute is supported in the python-oracledb Thin and Thick modes.
.. versionadded:: 2.0.0
.. attribute:: ConnectParams.server_type
This read-only attribute is a string that returns the type of server

66
doc/src/api_manual/module.rst
View File

@ -48,7 +48,7 @@ Oracledb Methods
edition=None, tag=None, matchanytag=False, \
config_dir=oracledb.defaults.config_dir, appcontext=[], \
shardingkey=[], supershardingkey=[], debug_jdwp=None, \
connection_id_prefix=None, ssl_context=None, handle=0)
connection_id_prefix=None, ssl_context=None, sdu=8192, handle=0)
Constructor for creating a connection to the database. Returns a
:ref:`Connection Object <connobj>`. All parameters are optional and can be
@ -303,6 +303,17 @@ Oracledb Methods
the default SSLContext object cannot be used. This value is only used in
the python-oracledb Thin mode.
The ``sdu`` parameter is expected to be an integer that returns the
requested size of the Session Data Unit (SDU), in bytes. The value tunes
internal buffers used for communication to the database. Bigger values can
increase throughput for large queries or bulk data loads, but at the cost
of higher memory use. The SDU size that will actually be used is
negotiated down to the lower of this value and the database network SDU
configuration value. See the `SQL*Net documentation <https://www.oracle.
com/pls/topic/lookup?ctx=dblatest&id=GUID-86D61D6F-AD26-421A-BABA-
77949C8A2B04>`__ for more details. This value is used in both the
python-oracledb Thin and Thick modes. The default value is 8192 bytes.
If the ``handle`` parameter is specified, it must be of type OCISvcCtx\*
and is only of use when embedding Python in an application (like
PowerBuilder) which has already made the connection. The connection thus
@ -312,7 +323,7 @@ Oracledb Methods
.. versionchanged:: 2.0.0
The ``ssl_context`` parameter was added.
The ``ssl_context`` and ``sdu`` parameters were added.
.. function:: ConnectParams(user=None, proxy_user=None, password=None, \
newpassword=None, wallet_password=None, access_token=None, host=None, \
@ -326,7 +337,7 @@ Oracledb Methods
edition=None, tag=None, matchanytag=False, \
config_dir=oracledb.defaults.config_dir, appcontext=[], \
shardingkey=[], supershardingkey=[], debug_jdwp=None, \
connection_id_prefix=None, ssl_context=None, handle=0)
connection_id_prefix=None, ssl_context=None, sdu=8192, handle=0)
Contains all the parameters that can be used to establish a connection to
the database.
@ -546,6 +557,17 @@ Oracledb Methods
the default SSLContext object cannot be used. This value is only used in
the python-oracledb Thin mode.
The ``sdu`` parameter is expected to be an integer that returns the
requested size of the Session Data Unit (SDU), in bytes. The value tunes
internal buffers used for communication to the database. Bigger values can
increase throughput for large queries or bulk data loads, but at the cost
of higher memory use. The SDU size that will actually be used is
negotiated down to the lower of this value and the database network SDU
configuration value. See the `SQL*Net documentation <https://www.oracle.
com/pls/topic/lookup?ctx=dblatest&id=GUID-86D61D6F-AD26-421A-BABA-
77949C8A2B04>`__ for more details. This value is used in both the
python-oracledb Thin and Thick modes. The default value is 8192 bytes.
The ``handle`` parameter is expected to be an integer which represents a
pointer to a valid service context handle. This value is only used in the
python-oracledb Thick mode. It should be used with extreme caution. The
@ -553,7 +575,7 @@ Oracledb Methods
.. versionchanged:: 2.0.0
The ``ssl_context`` parameter was added.
The ``ssl_context`` and ``sdu`` parameters were added.
.. function:: create_pool(dsn=None, pool_class=oracledb.ConnectionPool, \
params=None, min=1, max=2, increment=1, \
@ -573,7 +595,7 @@ Oracledb Methods
edition=None, tag=None, matchanytag=False, \
config_dir=oracledb.defaults.config_dir, appcontext=[], \
shardingkey=[], supershardingkey=[], debug_jdwp=None, \
connection_id_prefix=None, ssl_context=None, handle=0)
connection_id_prefix=None, ssl_context=None, sdu=8192, handle=0)
Creates a connection pool with the supplied parameters and returns the
:ref:`ConnectionPool object <connpool>` for the pool. See :ref:`Connection
@ -875,6 +897,17 @@ Oracledb Methods
the default SSLContext object cannot be used. This value is only used in
the python-oracledb Thin mode.
The ``sdu`` parameter is expected to be an integer that returns the
requested size of the Session Data Unit (SDU), in bytes. The value tunes
internal buffers used for communication to the database. Bigger values can
increase throughput for large queries or bulk data loads, but at the cost
of higher memory use. The SDU size that will actually be used is
negotiated down to the lower of this value and the database network SDU
configuration value. See the `SQL*Net documentation <https://www.oracle.
com/pls/topic/lookup?ctx=dblatest&id=GUID-86D61D6F-AD26-421A-BABA-
77949C8A2B04>`__ for more details. This value is used in both the
python-oracledb Thin and Thick modes. The default value is 8192 bytes.
If the ``handle`` parameter is specified, it must be of type OCISvcCtx\*
and is only of use when embedding Python in an application (like
PowerBuilder) which has already made the connection. The connection thus
@ -882,10 +915,6 @@ Oracledb Methods
destroyed. This value is only used in the python-oracledb Thick mode. It
should be used with extreme caution. The default value is 0.
.. versionchanged:: 2.0.0
The ``ssl_context`` parameter was added.
In the python-oracledb Thick mode, connection pooling is handled by
Oracle's `Session pooling <https://www.oracle.com/pls/topic/lookup?
ctx=dblatest&id=GUID-F9662FFB-EAEF-495C-96FC-49C6D1D9625C>`__ technology.
@ -893,6 +922,10 @@ Oracledb Methods
`Application Continuity <https://www.oracle.com/pls/topic/lookup?
ctx=dblatest&id=GUID-A8DD9422-2F82-42A9-9555-134296416E8F>`__.
.. versionchanged:: 2.0.0
The ``ssl_context`` and ``sdu`` parameters were added.
.. function:: Cursor(connection)
@ -1014,7 +1047,7 @@ Oracledb Methods
edition=None, tag=None, matchanytag=False, \
config_dir=oracledb.defaults.config_dir, appcontext=[], \
shardingkey=[], supershardingkey=[], debug_jdwp=None, \
connection_id_prefix=None, ssl_context=None, handle=0)
connection_id_prefix=None, ssl_context=None, sdu=8192, handle=0)
Creates and returns a :ref:`PoolParams Object <poolparam>`. The object
can be passed to :meth:`oracledb.create_pool()`.
@ -1286,6 +1319,17 @@ Oracledb Methods
the default SSLContext object cannot be used. This value is only used in
the python-oracledb Thin mode.
The ``sdu`` parameter is expected to be an integer that returns the
requested size of the Session Data Unit (SDU), in bytes. The value tunes
internal buffers used for communication to the database. Bigger values can
increase throughput for large queries or bulk data loads, but at the cost
of higher memory use. The SDU size that will actually be used is
negotiated down to the lower of this value and the database network SDU
configuration value. See the `SQL*Net documentation <https://www.oracle.
com/pls/topic/lookup?ctx=dblatest&id=GUID-86D61D6F-AD26-421A-BABA-
77949C8A2B04>`__ for more details. This value is used in both the
python-oracledb Thin and Thick modes. The default value is 8192 bytes.
The ``handle`` parameter is expected to be an integer which represents a
pointer to a valid service context handle. This value is only used in the
python-oracledb Thick mode. It should be used with extreme caution. The
@ -1293,7 +1337,7 @@ Oracledb Methods
.. versionchanged:: 2.0.0
The ``ssl_context`` parameter was added.
The ``ssl_context`` and ``sdu`` parameters were added.
.. function:: Time(hour, minute, second)

2
doc/src/api_manual/pool_params.rst
View File

@ -46,7 +46,7 @@ PoolParams Methods
externalauth=None, mode=None, disable_oob=None, stmtcachesize=None, \
edition=None, tag=None, matchanytag=None, config_dir=None, \
appcontext=[], shardingkey=[], supershardingkey=[], debug_jdwp=None, \
connection_id_prefix=None, ssl_context=None, handle=None)
connection_id_prefix=None, ssl_context=None, sdu=None, handle=None)
Sets one or more of the parameters.

3
doc/src/release_notes.rst
View File

@ -17,6 +17,9 @@ Thin Mode Changes
names with more than 255 UTF-8 encoded bytes.
#) Added support for an Oracle Database 23c JSON feature improving JSON
storage usage.
#) Added parameter :attr:`ConnectParams.sdu` for configuring the Session Data
Unit (SDU) size for sizing internal buffers used for tuning communication
with the database.
#) Fixed bug in detecting the current time zone
(`issue 257 <https://github.com/oracle/python-oracledb/issues/257>`__).
#) Added connection establishment parameter :data:`ConnectParams.ssl_context`

5
doc/src/user_guide/appendix_b.rst
View File

@ -164,11 +164,6 @@ attributes.
The ``ENABLE=BROKEN`` connect descriptor option is not supported in
python-oracledb Thin mode. Use ``expire_time`` instead.
The ``Session Data Unit (SDU)`` connect descriptor option that is used to tune
network transfers is not supported in python-oracledb Thin mode. The value is
hard-coded as 8 KB. In python-oracledb Thick mode, the SDU connect descriptor
option and equivalent ``sqlnet.ora`` setting are used.
If a name is given as a connect string, then the python-oracledb Thin mode will
consider it as a Net Service Name and not as the minimal Easy Connect string of
a hostname. The given connect string will be looked up in a ``tnsnames.ora``

13
doc/src/user_guide/tuning.rst
View File

@ -46,11 +46,20 @@ Some general tuning tips are:
* Tune your network. For example, when inserting or retrieving a large number
of rows (or for large data), or when using a slow network, then tune the
Oracle Network Session Data Unit (SDU) and socket buffer sizes, see `Oracle
Net Services: Best Practices for Database Performance and High Availability
Oracle Network Session Data Unit (SDU) and socket buffer sizes, see
`Configuring Session Data Unit
<https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=GUID-86D61D6F-AD26-421A-BABA-77949C8A2B04>`__
and `Oracle Net Services: Best Practices for Database Performance and High
Availability
<https://static.rainfocus.com/oracle/oow19/sess/1553616880266001WLIh/PF/
OOW19_Net_CON4641_1569022126580001esUl.pdf>`__.
In python-oracledb Thick mode the SDU size is configured in the
:ref:`optnetfiles`. In python-oracledb Thin mode, the SDU size can be passed
as a connection or pool creation parameter. In both modes it may optionally
be set in the connection :ref:`Easy Connect string <easyconnect>` or
:ref:`connect descriptor <netservice>`.
* Do not commit or rollback unnecessarily. Use :attr:`Connection.autocommit`
on the last of a sequence of DML statements.

1
src/oracledb/base_impl.pxd
View File

@ -134,6 +134,7 @@ cdef class Description(ConnectParamsNode):
public uint32_t expire_time
public uint32_t retry_count
public uint32_t retry_delay
public uint32_t sdu
public double tcp_connect_timeout
public str service_name
public str server_type

32
src/oracledb/connect_params.py
View File

@ -93,6 +93,7 @@ class ConnectParams:
debug_jdwp: str = None,
connection_id_prefix: str = None,
ssl_context: Any = None,
sdu: int = 8192,
handle: int = 0,
threaded: bool = True,
encoding: str = None,
@ -250,6 +251,13 @@ class ConnectParams:
parameter should only be specified if the default SSLContext object
cannot be used (default: None)
- sdu: the requested size of the Session Data Unit (SDU), in bytes. The
value tunes internal buffers used for communication to the database.
Bigger values can increase throughput for large queries or bulk data
loads, but at the cost of higher memory use. The SDU size that will
actually be used is negotiated down to the lower of this value and
the database network SDU configuration value (default: 8192)
- handle: an integer representing a pointer to a valid service context
handle. This value is only used in thick mode. It should be used with
extreme caution (default: 0)
@ -293,7 +301,8 @@ class ConnectParams:
+ f"supershardingkey={self.supershardingkey!r}, "
+ f"debug_jdwp={self.debug_jdwp!r}, "
+ f"connection_id_prefix={self.connection_id_prefix!r}, "
+ f"ssl_context={self.ssl_context!r}"
+ f"ssl_context={self.ssl_context!r}, "
+ f"sdu={self.sdu!r}"
+ ")"
)
@ -506,6 +515,19 @@ class ConnectParams:
"""
return self._impl.retry_delay
@property
@_description_attr
def sdu(self) -> Union[list, int]:
"""
The requested size of the Session Data Unit (SDU), in bytes. The value
tunes internal buffers used for communication to the database. Bigger
values can increase throughput for large queries or bulk data loads,
but at the cost of higher memory use. The SDU size that will actually
be used is negotiated down to the lower of this value and the database
network SDU configuration value.
"""
return self._impl.sdu
@property
@_description_attr
def server_type(self) -> Union[list, str]:
@ -699,6 +721,7 @@ class ConnectParams:
debug_jdwp: str = None,
connection_id_prefix: str = None,
ssl_context: Any = None,
sdu: int = None,
handle: int = None,
threaded: bool = None,
encoding: str = None,
@ -847,6 +870,13 @@ class ConnectParams:
parameter should only be specified if the default SSLContext object
cannot be used
- sdu: the requested size of the Session Data Unit (SDU), in bytes. The
value tunes internal buffers used for communication to the database.
Bigger values can increase throughput for large queries or bulk data
loads, but at the cost of higher memory use. The SDU size that will
actually be used is negotiated down to the lower of this value and
the database network SDU configuration value
- handle: an integer representing a pointer to a valid service context
handle. This value is only used in thick mode. It should be used with
extreme caution

8
src/oracledb/connection.py
View File

@ -1178,6 +1178,7 @@ def connect(
debug_jdwp: str = None,
connection_id_prefix: str = None,
ssl_context: Any = None,
sdu: int = 8192,
handle: int = 0,
threaded: bool = True,
encoding: str = None,
@ -1356,6 +1357,13 @@ def connect(
should only be specified if the default SSLContext object cannot be used
(default: None)
- sdu: the requested size of the Session Data Unit (SDU), in bytes. The
value tunes internal buffers used for communication to the database.
Bigger values can increase throughput for large queries or bulk data
loads, but at the cost of higher memory use. The SDU size that will
actually be used is negotiated down to the lower of this value and the
database network SDU configuration value (default: 8192)
- handle: an integer representing a pointer to a valid service context
handle. This value is only used in thick mode. It should be used with
extreme caution (default: 0)

7
src/oracledb/impl/base/connect_params.pyx
View File

@ -65,6 +65,7 @@ _tnsnames_files = {}
cdef str DEFAULT_PROTOCOL = "tcp"
cdef uint32_t DEFAULT_PORT = 1521
cdef double DEFAULT_TCP_CONNECT_TIMEOUT = 60
cdef uint32_t DEFAULT_SDU = 8192
cdef int _add_container(dict args, str name, object value) except -1:
@ -790,6 +791,7 @@ cdef class Description(ConnectParamsNode):
ConnectParamsNode.__init__(self, True)
self.tcp_connect_timeout = DEFAULT_TCP_CONNECT_TIMEOUT
self.ssl_server_dn_match = True
self.sdu = DEFAULT_SDU
cdef str _build_duration_str(self, double value):
"""
@ -830,6 +832,8 @@ cdef class Description(ConnectParamsNode):
if self.tcp_connect_timeout != DEFAULT_TCP_CONNECT_TIMEOUT:
temp = self._build_duration_str(self.tcp_connect_timeout)
parts.append(f"(TRANSPORT_CONNECT_TIMEOUT={temp})")
if self.sdu != DEFAULT_SDU:
parts.append(f"(SDU={self.sdu})")
# add address lists, but if the address list contains only a single
# entry and that entry does not have a host, the other parts aren't
@ -894,6 +898,7 @@ cdef class Description(ConnectParamsNode):
description.source_route = self.source_route
description.retry_count = self.retry_count
description.retry_delay = self.retry_delay
description.sdu = self.sdu
description.tcp_connect_timeout = self.tcp_connect_timeout
description.ssl_server_dn_match = self.ssl_server_dn_match
description.ssl_server_cert_dn = self.ssl_server_cert_dn
@ -925,6 +930,8 @@ cdef class Description(ConnectParamsNode):
_set_bool_param(args, "source_route", &self.source_route)
_set_uint_param(args, "retry_count", &self.retry_count)
_set_uint_param(args, "retry_delay", &self.retry_delay)
_set_uint_param(args, "sdu", &self.sdu)
self.sdu = min(max(self.sdu, 512), 2097152) # sanitize SDU
_set_duration_param(args, "tcp_connect_timeout",
&self.tcp_connect_timeout)

2
src/oracledb/impl/thin/capabilities.pyx
View File

@ -41,10 +41,12 @@ cdef class Capabilities:
uint32_t max_string_size
bint supports_oob
ssize_t oson_max_fname_size
uint32_t sdu
def __init__(self):
self._init_compile_caps()
self._init_runtime_caps()
self.sdu = 1024 # initial value to use
cdef void _adjust_for_protocol(self, uint16_t protocol_version,
uint16_t protocol_options):

2
src/oracledb/impl/thin/constants.pxi
View File

@ -786,8 +786,6 @@ cdef enum:
TNS_DURATION_OFFSET = 60
TNS_DURATION_SESSION = 10
TNS_MAX_LONG_LENGTH = 0x7fffffff
TNS_SDU = 8192
TNS_TDU = 65535
TNS_MAX_CURSORS_TO_CLOSE = 500
TNS_TXN_IN_PROGRESS = 0x00000002
TNS_MAX_CONNECT_DATA = 230

12
src/oracledb/impl/thin/messages.pyx
View File

@ -1777,8 +1777,10 @@ cdef class ConnectMessage(Message):
elif self.packet_type == TNS_PACKET_TYPE_ACCEPT:
buf.read_uint16(&protocol_version)
buf.read_uint16(&protocol_options)
buf.skip_raw_bytes(20)
buf.read_uint32(&buf._caps.sdu)
if protocol_version >= TNS_VERSION_MIN_UUID:
buf.skip_raw_bytes(33)
buf.skip_raw_bytes(9)
db_uuid = buf.read_raw_bytes(16)[:16]
self.cookie = get_connection_cookie_by_uuid(db_uuid,
self.description)
@ -1820,8 +1822,8 @@ cdef class ConnectMessage(Message):
buf.write_uint16(TNS_VERSION_DESIRED)
buf.write_uint16(TNS_VERSION_MINIMUM)
buf.write_uint16(service_options)
buf.write_uint16(TNS_SDU)
buf.write_uint16(TNS_TDU)
buf.write_uint16(self.description.sdu)
buf.write_uint16(self.description.sdu)
buf.write_uint16(TNS_PROTOCOL_CHARACTERISTICS)
buf.write_uint16(0) # line turnaround
buf.write_uint16(1) # value of 1
@ -1833,8 +1835,8 @@ cdef class ConnectMessage(Message):
buf.write_uint64(0) # obsolete
buf.write_uint64(0) # obsolete
buf.write_uint64(0) # obsolete
buf.write_uint32(TNS_SDU) # SDU (large)
buf.write_uint32(TNS_TDU) # TDU (large)
buf.write_uint32(self.description.sdu) # SDU (large)
buf.write_uint32(self.description.sdu) # TDU (large)
buf.write_uint32(connect_flags_1)
buf.write_uint32(connect_flags_2)
if self.connect_string_len > TNS_MAX_CONNECT_DATA:

23
src/oracledb/impl/thin/packet.pyx
View File

@ -176,12 +176,10 @@ cdef class ReadBuffer(Buffer):
Capabilities _caps
object _socket
def __cinit__(self, object sock, ssize_t max_packet_size,
Capabilities caps):
def __cinit__(self, object sock, Capabilities caps):
self._socket = sock
self._caps = caps
self._max_packet_size = max_packet_size
self._initialize(max_packet_size * 2)
self._size_for_sdu()
self._chunked_bytes_buf = ChunkedBytesBuffer()
cdef inline int _get_data_from_socket(self, object obj,
@ -406,6 +404,13 @@ cdef class ReadBuffer(Buffer):
_print_packet("Receiving packet:", self._socket.fileno(),
self._data_view[offset:self._size])
cdef int _size_for_sdu(self) except -1:
"""
Resizes the buffer based on the SDU size of the capabilities.
"""
self._max_packet_size = self._caps.sdu
self._initialize(self._max_packet_size * 2)
cdef object read_oson(self):
"""
Read an OSON value from the buffer and return the converted value. OSON
@ -595,10 +600,10 @@ cdef class WriteBuffer(Buffer):
uint8_t _seq_num
bint _packet_sent
def __cinit__(self, object sock, ssize_t max_size, Capabilities caps):
def __cinit__(self, object sock, Capabilities caps):
self._socket = sock
self._caps = caps
self._initialize(max_size)
self._size_for_sdu()
cdef int _send_packet(self, bint final_packet) except -1:
"""
@ -628,6 +633,12 @@ cdef class WriteBuffer(Buffer):
if not final_packet:
self.write_uint16(0) # add data flags for next packet
cdef int _size_for_sdu(self) except -1:
"""
Resizes the buffer based on the SDU size of the capabilities.
"""
self._initialize(self._caps.sdu)
cdef int _write_more_data(self, ssize_t num_bytes_available,
ssize_t num_bytes_wanted) except -1:
"""

8
src/oracledb/impl/thin/protocol.pyx
View File

@ -68,7 +68,7 @@ cdef class Protocol:
print()
self._socket.send(b"!", socket.MSG_OOB)
else:
buf = WriteBuffer(self._socket, TNS_SDU, self._caps)
buf = WriteBuffer(self._socket, self._caps)
self._send_marker(buf, TNS_MARKER_TYPE_INTERRUPT)
cdef int _close(self, ThinConnImpl conn_impl) except -1:
@ -183,6 +183,8 @@ cdef class Protocol:
connect_message = None
packet_flags = TNS_PACKET_FLAG_REDIRECT
elif connect_message.packet_type == TNS_PACKET_TYPE_ACCEPT:
self._read_buf._size_for_sdu()
self._write_buf._size_for_sdu()
return connect_message.cookie
# for TCPS connections, OOB processing is not supported; if the
@ -490,5 +492,5 @@ cdef class Protocol:
cdef int _set_socket(self, sock):
self._socket = sock
self._read_buf = ReadBuffer(sock, TNS_SDU, self._caps)
self._write_buf = WriteBuffer(sock, TNS_SDU, self._caps)
self._read_buf = ReadBuffer(sock, self._caps)
self._write_buf = WriteBuffer(sock, self._caps)

8
src/oracledb/pool.py
View File

@ -611,6 +611,7 @@ def create_pool(
debug_jdwp: str = None,
connection_id_prefix: str = None,
ssl_context: Any = None,
sdu: int = 8192,
handle: int = 0,
threaded: bool = True,
encoding: str = None,
@ -839,6 +840,13 @@ def create_pool(
should only be specified if the default SSLContext object cannot be used
(default: None)
- sdu: the requested size of the Session Data Unit (SDU), in bytes. The
value tunes internal buffers used for communication to the database.
Bigger values can increase throughput for large queries or bulk data
loads, but at the cost of higher memory use. The SDU size that will
actually be used is negotiated down to the lower of this value and the
database network SDU configuration value (default: 8192)
- handle: an integer representing a pointer to a valid service context
handle. This value is only used in thick mode. It should be used with
extreme caution (default: 0)

19
src/oracledb/pool_params.py
View File

@ -105,6 +105,7 @@ class PoolParams(ConnectParams):
debug_jdwp: str = None,
connection_id_prefix: str = None,
ssl_context: Any = None,
sdu: int = 8192,
handle: int = 0,
threaded: bool = True,
encoding: str = None,
@ -317,6 +318,13 @@ class PoolParams(ConnectParams):
parameter should only be specified if the default SSLContext object
cannot be used (default: None)
- sdu: the requested size of the Session Data Unit (SDU), in bytes. The
value tunes internal buffers used for communication to the database.
Bigger values can increase throughput for large queries or bulk data
loads, but at the cost of higher memory use. The SDU size that will
actually be used is negotiated down to the lower of this value and
the database network SDU configuration value (default: 8192)
- handle: an integer representing a pointer to a valid service context
handle. This value is only used in thick mode. It should be used with
extreme caution (default: 0)
@ -373,7 +381,8 @@ class PoolParams(ConnectParams):
+ f"supershardingkey={self.supershardingkey!r}, "
+ f"debug_jdwp={self.debug_jdwp!r}, "
+ f"connection_id_prefix={self.connection_id_prefix!r}, "
+ f"ssl_context={self.ssl_context!r}"
+ f"ssl_context={self.ssl_context!r}, "
+ f"sdu={self.sdu!r}"
+ ")"
)
@ -550,6 +559,7 @@ class PoolParams(ConnectParams):
debug_jdwp: str = None,
connection_id_prefix: str = None,
ssl_context: Any = None,
sdu: int = None,
handle: int = None,
threaded: bool = None,
encoding: str = None,
@ -749,6 +759,13 @@ class PoolParams(ConnectParams):
parameter should only be specified if the default SSLContext object
cannot be used
- sdu: the requested size of the Session Data Unit (SDU), in bytes. The
value tunes internal buffers used for communication to the database.
Bigger values can increase throughput for large queries or bulk data
loads, but at the cost of higher memory use. The SDU size that will
actually be used is negotiated down to the lower of this value and
the database network SDU configuration value
- handle: an integer representing a pointer to a valid service context
handle. This value is only used in thick mode. It should be used with
extreme caution

1
tests/test_4500_connect_params.py
View File

@ -739,6 +739,7 @@ class TestCase(test_env.BaseTestCase):
("debug_jdwp", "host=host;port=4538"),
("connection_id_prefix", "prefix4564"),
("ssl_context", None),
("sdu", 16384),
]
params = oracledb.ConnectParams(**dict(values))
parts = [f"{name}={value!r}" for name, value in values]

1
tests/test_4700_pool_params.py
View File

@ -113,6 +113,7 @@ class TestCase(test_env.BaseTestCase):
("debug_jdwp", "host=host;port=1523"),
("connection_id_prefix", "prefix4701"),
("ssl_context", None),
("sdu", 16384),
]
params = oracledb.PoolParams(**dict(values))
parts = [f"{name}={value!r}" for name, value in values]

12
utils/fields.cfg
View File

@ -411,6 +411,18 @@ description =
found in a separately supplied wallet. This parameter should only be
specified if the default SSLContext object cannot be used
[sdu]
type = int
decorator = _description_attr
default = 8192
description =
the requested size of the Session Data Unit (SDU), in bytes. The value
tunes internal buffers used for communication to the database. Bigger
values can increase throughput for large queries or bulk data loads, but at
the cost of higher memory use. The SDU size that will actually be used is
negotiated down to the lower of this value and the database network SDU
configuration value
[handle]
type = int
default = 0