Added property for "sdu" on connections.

Author: anthony-tuininga

doc/src/api_manual/connection.rst

@@ -804,6 +804,20 @@ Connection Attributes
 
         This attribute is an extension to the DB API definition.
 
+.. attribute:: Connection.sdu
+
+    This read-only attribute specifies the size of the Session Data Unit (SDU)
+    that is being used by the connection. The value will be the lesser of the
+    requested python-oracledb size and the maximum size allowed by the database
+    network configuration. It is available only in the python-oracledb Thin
+    mode.
+
+    .. versionadded:: 2.0.0
+
+    .. note::
+
+        This attribute is an extension to the DB API definition.
+
 .. attribute:: Connection.service_name
 
     This read-only attribute specifies the Oracle Database service name

doc/src/release_notes.rst

@@ -17,7 +17,8 @@ Thin Mode Changes
     (`issue 6 <https://github.com/oracle/python-oracledb/issues/6>`__).
 #)  Added parameter :attr:`ConnectParams.sdu` for configuring the Session Data
     Unit (SDU) size for sizing internal buffers used for tuning communication
-    with the database.
+    with the database. The connection property :attr:`Connection.sdu` was also
+    added.
 #)  Added parameter :data:`ConnectParams.ssl_context` to modify the SSL context
     used when connecting via TLS
     (`issue 259 <https://github.com/oracle/python-oracledb/issues/259>`__).

src/oracledb/connection.py

@@ -366,6 +366,15 @@ def outputtypehandler(self, value: Callable) -> None:
         self._verify_connected()
         self._impl.outputtypehandler = value
 
+    @property
+    def sdu(self) -> int:
+        """
+        Specifies the size of the Session Data Unit (SDU) that is being used by
+        the connection.
+        """
+        self._verify_connected()
+        return self._impl.get_sdu()
+
     @property
     def service_name(self) -> str:
         """

src/oracledb/impl/base/connection.pyx

@@ -249,6 +249,10 @@ cdef class BaseConnImpl:
     def get_max_open_cursors(self):
         pass
 
+    @utils.CheckImpls("getting the session data unit (SDU)")
+    def get_sdu(self):
+        pass
+
     @utils.CheckImpls("getting the service name")
     def get_service_name(self):
         pass

src/oracledb/impl/thin/connection.pyx

@@ -266,6 +266,9 @@ cdef class BaseThinConnImpl(BaseConnImpl):
     def get_max_open_cursors(self):
         return self._max_open_cursors
 
+    def get_sdu(self):
+        return self._protocol._caps.sdu
+
     def get_service_name(self):
         return self._service_name
 

utils/templates/connection.py

@@ -364,6 +364,15 @@ def outputtypehandler(self, value: Callable) -> None:
         self._verify_connected()
         self._impl.outputtypehandler = value
 
+    @property
+    def sdu(self) -> int:
+        """
+        Specifies the size of the Session Data Unit (SDU) that is being used by
+        the connection.
+        """
+        self._verify_connected()
+        return self._impl.get_sdu()
+
     @property
     def service_name(self) -> str:
         """