Support added to thin mode for reading/writing OSON (JSON data type in

Oracle Database 21c+) and related documentation changes.

Author: anthony-tuininga

doc/src/api_manual/cursor.rst

@@ -348,14 +348,14 @@ Cursor Methods
 .. method:: Cursor.setinputsizes(\*args, \*\*keywordArgs)
 
     This can be used before a call to :meth:`~Cursor.execute()`,
-    :meth:`~Cursor.callfunc()` or :meth:`~Cursor.callproc()` to predefine
-    memory areas for the operation's parameters. Each parameter should be a
-    type object corresponding to the input that will be used or it should be an
-    integer specifying the maximum length of a string parameter. Use keyword
-    parameters when binding by name and positional parameters when binding by
-    position. The singleton None can be used as a parameter when using
-    positional parameters to indicate that no space should be reserved for that
-    position.
+    :meth:`~Cursor.executemany()`, :meth:`~Cursor.callfunc()` or
+    :meth:`~Cursor.callproc()` to predefine memory areas for the operation's
+    parameters. Each parameter should be a type object corresponding to the
+    input that will be used or it should be an integer specifying the maximum
+    length of a string parameter. Use keyword parameters when binding by name
+    and positional parameters when binding by position. The singleton None can
+    be used as a parameter when using positional parameters to indicate that no
+    space should be reserved for that position.
 
     .. note::
 

doc/src/api_manual/defaults.rst

@@ -39,15 +39,16 @@ Defaults Attributes
 
 .. attribute:: defaults.fetch_decimals
 
-    Identifies whether numbers should be fetched as ``decimal.Decimal`` values.
+    Identifies whether numbers should be fetched as `decimal.Decimal
+    <https://docs.python.org/3/library/decimal.html#decimal-objects>`__ values.
     This can help avoid issues with converting numbers from Oracle Database's
     decimal format to Python's binary format.
 
     An output type handler such as previously required in cx_Oracle (see
     `return_numbers_as_decimals.py <https://github.com/oracle/python-cx_Oracle/
     blob/main/samples/return_numbers_as_decimals.py>`__) can alternatively be
     used to adjust the returned type.  If a type handler exists and returns a
-    variable (that is, `cursor.var(...)`), then that return variable is used.
+    variable (that is, ``cursor.var(...)``), then that return variable is used.
     If the type handler returns None, then the value of
     ``oracledb.defaults.fetch_decimals`` is used to determine whether to return
     ``decimal.Decimal`` values.
@@ -68,6 +69,9 @@ Defaults Attributes
     that return variable is used. If the type handler returns None, then the value of
     ``oracledb.defaults.fetch_lobs`` is used.
 
+    The value of ``oracledb.defaults.fetch_lobs`` does not affect LOBs returned
+    as OUT binds.
+
     This attribute has an initial value of True.
 
 .. attribute:: defaults.prefetchrows

doc/src/api_manual/module.rst

@@ -2179,16 +2179,6 @@ when binding data.
     Describes columns in a database that are of type JSON (with Oracle Database
     21 or later).
 
-    .. note::
-
-        DB_TYPE_JSON database type is only supported in the python-oracledb
-        Thick mode. See :ref:`enablingthick`.
-
-        In python-oracledb Thin mode, the JSON database type can be fetched
-        with an output type handler as described in :ref:`Fetching JSON
-        <fetchJSON>`.
-
-
 .. data:: DB_TYPE_LONG
 
     Describes columns, attributes or array elements in a database that are of

doc/src/user_guide/appendix_a.rst

@@ -347,7 +347,7 @@ see :ref:`driverdiff` and :ref:`compatibility`.
       - Yes
       - Yes
     * - Oracle 21c JSON data type (see :data:`~oracledb.DB_TYPE_JSON`)
-      - No - can fetch with an output type handler, see :ref:`Fetching JSON Differences <fetchJSON>`
+      - Yes
       - Yes
       - Yes
     * - ROWID, UROWID data types
@@ -494,7 +494,7 @@ values.
       - cannot be set
     * - JSON
       - DB_TYPE_JSON
-      - Yes. In python-oracledb Thin mode use an output type handler to fetch this Oracle Database 21c data type. See :ref:`jsondatatype`.
+      - Yes
       - ANY (converted)
     * - REF CURSOR (PL/SQL OR nested cursor)
       - DB_TYPE_CURSOR

doc/src/user_guide/appendix_b.rst

@@ -317,15 +317,6 @@ not supported in the Oracle Client libraries that are used in python-oracledb
 Thick mode. Note changing the type of bind variables for the same SQL text is
 inappropriate and gives indeterminate results in both modes.
 
-.. _fetchJSON:
-
-Fetching JSON in Thin and Thick Modes
-=====================================
-
-The python-oracledb Thin mode does not natively handle the Oracle Database 21c
-JSON data type but a type handler can be used when fetching the type, see
-:ref:`jsondatatype`.
-
 Error Handling in Thin and Thick Modes
 ======================================
 

doc/src/user_guide/appendix_c.rst

@@ -516,7 +516,7 @@ following steps:
    the code.
 
 9. Modernize code as needed or desired.  See :ref:`deprecations` for the list
-   of deprecations in python-oracledb 1.0.
+   of deprecations in python-oracledb.
 
 Additional Upgrade Steps to use python-oracledb Thin Mode
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++