Change 23c to 23ai in all occurrences in the doc, code, samples, and

tests.

Author: anthony-tuininga

doc/src/api_manual/connect_params.rst

@@ -230,7 +230,7 @@ ConnectParams Attributes
     "transaction", then pooled DRCP or PRCP connections are implicitly
     released back to the DRCP or PRCP pool when either one of the methods
     :meth:`Connection.commit()` or :meth:`Connection.rollback()` are called.
-    This attribute requires the use of DRCP or PRCP with Oracle Database 23c
+    This attribute requires the use of DRCP or PRCP with Oracle Database 23ai
     (or later). See :ref:`implicitconnpool` for more information.
 
     This attribute is supported in the python-oracledb Thin and Thick modes.

doc/src/api_manual/fetch_info.rst

@@ -27,8 +27,8 @@ FetchInfo Attributes
     <https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/
     annotations_clause.html#GUID-1AC16117-BBB6-4435-8794-2B99F8F68052>`__
     associated with the fetched column. If there are no annotations, the value
-    ``None`` is returned. Annotations require Oracle Database 23c. If using
-    python-oracledb Thick mode, Oracle Client 23c is also required.
+    ``None`` is returned. Annotations require Oracle Database 23ai. If using
+    python-oracledb Thick mode, Oracle Client 23ai is also required.
 
     .. versionadded:: 2.0.0
 
@@ -43,8 +43,8 @@ FetchInfo Attributes
     <https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/
     create-domain.html#GUID-17D3A9C6-D993-4E94-BF6B-CACA56581F41>`__
     associated with the fetched column. If there is no SQL domain, the value
-    ``None`` is returned. SQL domains require Oracle Database 23c. If using
-    python-oracledb Thick mode, Oracle Client 23c is also required.
+    ``None`` is returned. SQL domains require Oracle Database 23ai. If using
+    python-oracledb Thick mode, Oracle Client 23ai is also required.
 
     .. versionadded:: 2.0.0
 
@@ -54,8 +54,8 @@ FetchInfo Attributes
     <https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/
     create-domain.html#GUID-17D3A9C6-D993-4E94-BF6B-CACA56581F41>`__
     associated with the fetched column. If there is no SQL domain, the value
-    ``None`` is returned. SQL domains require Oracle Database 23c. If using
-    python-oracledb Thick mode, Oracle Client 23c is also required.
+    ``None`` is returned. SQL domains require Oracle Database 23ai. If using
+    python-oracledb Thick mode, Oracle Client 23ai is also required.
 
     .. versionadded:: 2.0.0
 

doc/src/api_manual/module.rst

@@ -326,7 +326,7 @@ Oracledb Methods
     implicitly released back to the DRCP or PRCP pool when either one of the
     methods :meth:`Connection.commit()` or :meth:`Connection.rollback()` are
     called.  This parameter requires the use of DRCP or PRCP with Oracle
-    Database 23c (or later).  See :ref:`implicitconnpool` for more
+    Database 23ai (or later).  See :ref:`implicitconnpool` for more
     information.  This value is used in both the python-oracledb Thin and
     Thick modes.
 
@@ -582,7 +582,7 @@ Oracledb Methods
     implicitly released back to the DRCP or PRCP pool when either one of the
     methods :meth:`AsyncConnection.commit()` or
     :meth:`AsyncConnection.rollback()` are called.  This parameter requires
-    the use of DRCP or PRCP with Oracle Database 23c (or later).  See
+    the use of DRCP or PRCP with Oracle Database 23ai (or later).  See
     :ref:`implicitconnpool` for more information.  This value is used in both
     the python-oracledb Thin and Thick modes.
 
@@ -863,7 +863,7 @@ Oracledb Methods
     implicitly released back to the DRCP or PRCP pool when either one of the
     methods :meth:`Connection.commit()` or :meth:`Connection.rollback()` are
     called.  This parameter requires the use of DRCP or PRCP with Oracle
-    Database 23c (or later).  See :ref:`implicitconnpool` for more
+    Database 23ai (or later).  See :ref:`implicitconnpool` for more
     information.  This value is used in both  the python-oracledb Thin and
     Thick modes.
 
@@ -1238,7 +1238,7 @@ Oracledb Methods
     implicitly released back to the DRCP or PRCP pool when either one of the
     methods :meth:`Connection.commit()` or :meth:`Connection.rollback()` are
     called.  This parameter requires the use of DRCP or PRCP with Oracle
-    Database 23c (or later).  See :ref:`implicitconnpool` for more
+    Database 23ai (or later).  See :ref:`implicitconnpool` for more
     information.  This value is used in both the python-oracledb Thin and
     Thick modes.
 
@@ -1553,7 +1553,7 @@ Oracledb Methods
     implicitly released back to the DRCP or PRCP pool when either one of the
     methods :meth:`AsyncConnection.commit()` or
     :meth:`AsyncConnection.rollback()` are called.  This parameter requires
-    the use of DRCP or PRCP with Oracle Database 23c (or later).  See
+    the use of DRCP or PRCP with Oracle Database 23ai (or later).  See
     :ref:`implicitconnpool` for more information.  This value is used in both
     the python-oracledb Thin and Thick modes.
 
@@ -1994,7 +1994,7 @@ Oracledb Methods
     implicitly released back to the DRCP or PRCP pool when either one of the
     methods :meth:`Connection.commit()` or :meth:`Connection.rollback()` are
     called.  This parameter requires the use of DRCP or PRCP with Oracle
-    Database 23c (or later).  See :ref:`implicitconnpool` for more
+    Database 23ai (or later).  See :ref:`implicitconnpool` for more
     information.  This value is used in both the python-oracledb Thin and
     Thick modes.
 

doc/src/index.rst

@@ -10,7 +10,7 @@ additions and a couple of exclusions. Synchronous and
 :ref:`concurrent <asyncio>` coding styles are supported.
 
 This module is currently tested with Python 3.7, 3.8, 3.9, 3.10, 3.11 and 3.12
-against Oracle Database 23c, 21c, 19c, 18c, 12c, and 11gR2.
+against Oracle Database 23ai, 21c, 19c, 18c, 12c, and 11gR2.
 
 **python-oracledb** is distributed under an open-source
 :ref:`license <license>`. Changes in python-oracledb releases can be found in

doc/src/release_notes.rst

@@ -26,7 +26,7 @@ Thin Mode Changes
 #)  Fixed bug that would cause an internal error to be raised when attempting
     to close a connection that has been forcibly closed by the database.
 #)  Internal change: further efforts to tighten code looking for the end of a
-    database request made to Oracle Database 23c.
+    database request made to Oracle Database 23ai.
 
 Thick Mode Changes
 ++++++++++++++++++
@@ -102,7 +102,7 @@ oracledb 2.1.0 (March 2024)
 Thin Mode Changes
 +++++++++++++++++
 
-#)  Oracle Database 23c feature support:
+#)  Oracle Database 23ai feature support:
 
     - Added support for
       :ref:`implicit connection pooling with DRCP and PRCP <implicitconnpool>`,
@@ -266,7 +266,7 @@ Thin Mode Changes
 #)  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>`__).
-#)  Added support for an Oracle Database 23c JSON feature allowing field names
+#)  Added support for an Oracle Database 23ai JSON feature allowing field names
     with more than 255 UTF-8 encoded bytes.
 #)  Added support for the ``FAILOVER`` clause in full connect descriptors.
 #)  Fixed bug in detecting the current time zone
@@ -277,7 +277,7 @@ Thin Mode Changes
     multiple line comments with multiple asterisks before the closing slash.
 #)  A more meaningful error is raised when the wrong type of data is passed to
     :meth:`LOB.write()`.
-#)  Internal change to support an Oracle Database 23c JSON feature improving
+#)  Internal change to support an Oracle Database 23ai JSON feature improving
     JSON storage usage.
 #)  Internal change to ensure that all connections in a pool have been closed
     gracefully before the pool is closed.
@@ -317,8 +317,8 @@ Common Changes
     oracle-database/23/sqlrf/annotations_clause.html#
     GUID-1AC16117-BBB6-4435-8794-2B99F8F68052>`__
     associated with columns that are being fetched. SQL domains and annotations
-    require Oracle Database 23c. If using python-oracledb Thick mode, Oracle
-    Client 23c is also required.
+    require Oracle Database 23ai. If using python-oracledb Thick mode, Oracle
+    Client 23ai is also required.
 #)  Added parameter ``data`` to :meth:`Connection.createlob()` to allow data to
     be written at LOB creation time.
 #)  Added type :data:`~oracledb.DB_TYPE_XMLTYPE` to represent data of type
@@ -338,7 +338,7 @@ Common Changes
 #)  Errors that have entries in the
     :ref:`troubleshooting documentation <troubleshooting>` now have links to
     that documentation shown in the message text.
-#)  Fixed bug with binding boolean values with Oracle Database 23c
+#)  Fixed bug with binding boolean values with Oracle Database 23ai
     (`issue 263 <https://github.com/oracle/python-oracledb/issues/263>`__).
 #)  Fixed bug with getting unknown attributes from :ref:`Oracle Object
     <dbobject>` instances.
@@ -408,7 +408,7 @@ oracledb 1.4.0 (August 2023)
 Thin Mode Changes
 +++++++++++++++++
 
-#)  Added support for an Oracle Database 23c feature that can improve the
+#)  Added support for an Oracle Database 23ai feature that can improve the
     performance of connection creation by reducing the number of round trips
     required to create the second and subsequent connections to the same
     database.
@@ -422,13 +422,13 @@ Thin Mode Changes
     created. The default connection class will be of the form ``DPY:`` followed
     by a 16-byte unique identifier converted to base64 encoding.
 #)  Changed internal connection feature negotiation for more accurate Oracle
-    Database 23c support.
+    Database 23ai support.
 #)  Added support for sending a generated connection identifier to the
     database used for tracing. An application specific prefix is prepended to
     this value if specified via a new ``connection_id_prefix`` parameter when
     creating standalone connections or connection pools.
 #)  Added URL to the Oracle Database Error Help Portal in Oracle Database
-    error messages similar to when Thick mode uses Oracle Client 23c.
+    error messages similar to when Thick mode uses Oracle Client 23ai.
 #)  Added support for the ``ORA_SDTZ`` environment variable used to set the
     session time zone used by the database.
 #)  Fixed bug when a dynamically sized connection pool is created with an
@@ -501,7 +501,7 @@ Common Changes
     same value as the SQL expression
     ``sys_context('userenv', 'instance_name')``.
 #)  Added support for relational queries on the underlying tables of SODA
-    collections created in Oracle Database 23c if they contain JSON documents
+    collections created in Oracle Database 23ai if they contain JSON documents
     with embedded OIDs.
 #)  Automatically retry a query if the error ``ORA-00932: inconsistent data
     types`` is raised (which can occur if a table or view is recreated with a
@@ -533,7 +533,7 @@ Thin Mode Changes
 #)  Fixed bug which could cause a redirect loop with improperly configured
     listener redirects.
 #)  Fixed bug when executing PL/SQL with a large number of binds.
-#)  Fixed bug when using DRCP with Oracle Database 23c.
+#)  Fixed bug when using DRCP with Oracle Database 23ai.
 
 Thick Mode Changes
 ++++++++++++++++++
@@ -561,7 +561,7 @@ Thin Mode Changes
 
 #)  Improved performance of regular expressions used for parsing SQL
     (`issue 172 <https://github.com/oracle/python-oracledb/issues/172>`__).
-#)  Fixed bug with Oracle Database 23c when SQL is executed after first being
+#)  Fixed bug with Oracle Database 23ai when SQL is executed after first being
     parsed.
 #)  Fixed bug when :data:`ConnectionPool.timeout` is not `None` when creating a
     connection pool

doc/src/user_guide/appendix_a.rst

@@ -158,7 +158,7 @@ see :ref:`driverdiff` and :ref:`compatibility`.
       - Yes
       - Yes
       - Yes
-    * - Oracle Database 23c Implicit Connection Pooling with DRCP and PRCP (see :ref:`implicitconnpool`)
+    * - Oracle Database 23ai Implicit Connection Pooling with DRCP and PRCP (see :ref:`implicitconnpool`)
       - Yes
       - Yes
       - No
@@ -376,7 +376,7 @@ values.
       - :data:`~oracledb.DB_TYPE_DATE`
       - No relevant notes
       - datetime.date, datetime.datetime
-    * - BOOLEAN (PL/SQL and Oracle Database 23c SQL)
+    * - BOOLEAN (PL/SQL and Oracle Database 23ai SQL)
       - :data:`~oracledb.DB_TYPE_BOOLEAN`
       - No relevant notes
       - Any type convertible to bool

doc/src/user_guide/connection_handling.rst

@@ -1514,7 +1514,7 @@ hits and misses to show the pool efficiency.
 Implicit Connection Pooling with DRCP and PRCP
 ----------------------------------------------
 
-Starting from Oracle Database 23c, Python applications that use
+Starting from Oracle Database 23ai, Python applications that use
 :ref:`DRCP <drcp>` and Oracle Connection Manager in Traffic Director Mode's
 (CMAN-TDM) pooling capability `Proxy Resident Connection Pooling (PRCP)
 <https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=GUID-E0032017-03B1-
@@ -1529,7 +1529,7 @@ With implicit connection pooling, applications do not need to explicitly close
 or release a connection to return the connection back to the DRCP or PRCP pool.
 Applications that do not use client-side connection pooling can take advantage
 of the implicit connection pooling feature with either Thin or Thick mode.
-Thick mode requires Oracle 23c Client libraries for implicit connection
+Thick mode requires Oracle 23ai Client libraries for implicit connection
 pooling support.  Thin mode works with implicit connection pooling from
 python-oracledb 2.1 onwards.
 

doc/src/user_guide/installation.rst

@@ -240,7 +240,7 @@ Oracle Client libraries installed.  Oracle Client versions 21, 19, 18, 12 and
   or "Basic Light" package for your operating system architecture.
 
 - Alternatively, use the client libraries already available in a locally
-  installed database such as the free `Oracle Database 23c Free
+  installed database such as the free `Oracle Database 23ai Free
   <https://www.oracle.com/database/free/>`__ release.
 
 To use python-oracledb in Thick mode you must call

samples/vector.py

@@ -25,7 +25,7 @@
 # -----------------------------------------------------------------------------
 # vector.py
 #
-# Demonstrates how to use the Oracle Database 23c VECTOR data type.
+# Demonstrates how to use the Oracle Database 23ai VECTOR data type.
 # -----------------------------------------------------------------------------
 
 import array

samples/vector_numpy.py

@@ -25,7 +25,7 @@
 # -----------------------------------------------------------------------------
 # vector_numpy.py
 #
-# Demonstrates how to use the Oracle Database 23c VECTOR data type with NumPy
+# Demonstrates how to use the Oracle Database 23ai VECTOR data type with NumPy
 # types.
 # -----------------------------------------------------------------------------
 

samples/vector_string.py

@@ -25,8 +25,8 @@
 # -----------------------------------------------------------------------------
 # vector_string.py
 #
-# Demonstrates how to use the Oracle Database 23c VECTOR data type
-# when using python-oracledb thick mode with pre-23c Oracle Client libraries.
+# Demonstrates how to use the Oracle Database 23ai VECTOR data type
+# when using python-oracledb thick mode with pre-23ai Oracle Client libraries.
 # See vector.py for a more efficient example for other deployments.
 # -----------------------------------------------------------------------------
 

src/oracledb/errors.py

@@ -74,7 +74,8 @@ def _make_adjustments(self):
 
                 # add Oracle Database Error Help Portal URL for database error
                 # messages, but only in thin mode since this is done
-                # automatically in thick mode with Oracle Client 23c and higher
+                # automatically in thick mode with Oracle Client 23ai and
+                # higher
                 if (
                     self.code != 0
                     and (self.code < 20000 or self.code >= 21000)

src/oracledb/impl/thin/protocol.pyx

@@ -298,7 +298,7 @@ cdef class Protocol(BaseProtocol):
         auth_message = conn_impl._create_message(AuthMessage)
         auth_message._set_params(params, description)
 
-        # starting in 23c, fast authentication is possible; see if the server
+        # starting in 23ai, fast authentication is possible; see if the server
         # supports it
         if self._caps.supports_fast_auth:
             fast_auth_message = conn_impl._create_message(FastAuthMessage)
@@ -647,7 +647,7 @@ cdef class BaseAsyncProtocol(BaseProtocol):
         auth_message = conn_impl._create_message(AuthMessage)
         auth_message._set_params(params, description)
 
-        # starting in 23c, fast authentication is possible; see if the server
+        # starting in 23ai, fast authentication is possible; see if the server
         # supports it
         if self._caps.supports_fast_auth:
             fast_auth_message = conn_impl._create_message(FastAuthMessage)

tests/sql/create_schema_23.sql

@@ -27,7 +27,7 @@
  *
  * Performs the actual work of creating and populating the schemas with the
  * database objects used by the python-oracledb test suite that require Oracle
- * Database 23c or higher. It is executed by the Python script
+ * Database 23ai or higher. It is executed by the Python script
  * create_schema.py.
  *---------------------------------------------------------------------------*/
 

tests/test_3100_boolean_var.py

@@ -113,7 +113,7 @@ def test_3108(self):
         test_env.get_server_version() >= (23, 1), "unsupported server"
     )
     def test_3109(self):
-        "3109 - test binding and fetching boolean with 23c"
+        "3109 - test binding and fetching boolean with 23ai"
         for value in (True, False):
             with self.subTest(value=value):
                 self.cursor.execute("select not :1 from dual", [value])

tests/test_3400_soda_collection.py

@@ -41,7 +41,7 @@
 class TestCase(test_env.BaseTestCase):
     def __normalize_docs(self, docs):
         """
-        Remove the embedded OID added in Oracle Database 23c, if found, in
+        Remove the embedded OID added in Oracle Database 23ai, if found, in
         order to ease comparison.
         """
         for doc in docs:
@@ -440,7 +440,7 @@ def test_3417(self):
 
     @unittest.skipIf(
         test_env.get_client_version() > (23, 0),
-        "save() is not implemented in Oracle Database 23c",
+        "save() is not implemented in Oracle Database 23ai",
     )
     def test_3418(self):
         "3418 - test save"
@@ -464,7 +464,7 @@ def test_3418(self):
 
     @unittest.skipIf(
         test_env.get_client_version() > (23, 0),
-        "save() is not implemented in Oracle Database 23c",
+        "save() is not implemented in Oracle Database 23ai",
     )
     def test_3419(self):
         "3419 - test saveAndGet with hint"
@@ -495,7 +495,7 @@ def test_3419(self):
 
     @unittest.skipIf(
         test_env.get_client_version() > (23, 0),
-        "save() is not implemented in Oracle Database 23c",
+        "save() is not implemented in Oracle Database 23ai",
     )
     def test_3420(self):
         "3420 - test saveAndGet"

tests/test_6700_json_23.py

@@ -23,7 +23,7 @@
 # -----------------------------------------------------------------------------
 
 """
-6700 - Module for testing the JSON data type extension in Oracle Database 23c.
+6700 - Module for testing the JSON data type extension in Oracle Database 23ai.
 """
 
 import json