All Oracle errors that result in the connection no longer being usable

will be raised as "DPY-4011: the database or network closed the
connection", with the underlying reason being included in the error
message.

Author: anthony-tuininga

doc/src/release_notes.rst

@@ -89,6 +89,9 @@ Common Changes
 #)  Fixed bug where some :ref:`DbObject <dbobjecttype>` attributes for database
     objects defined using ANSI names (including FLOAT and REAL) may have shown
     as integers.
+#)  All Oracle errors that result in the connection no longer being usable will
+    be raised as ``DPY-4011: the database or network closed the connection``
+    with the underlying reason being included in the error message.
 #)  Error ``DPY-2056: registered handler for protocol "{protocol}" failed for
     arg "{arg}"`` is now raised when an exception occurs when calling the
     registered handler for a protocol.

src/oracledb/errors.py

@@ -1,5 +1,5 @@
 # -----------------------------------------------------------------------------
-# Copyright (c) 2020, 2024, Oracle and/or its affiliates.
+# Copyright (c) 2020, 2025, Oracle and/or its affiliates.
 #
 # This software is dual-licensed to you under the Universal Permissive License
 # (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License
@@ -373,11 +373,33 @@ def _raise_not_supported(feature: str) -> None:
 
 # Oracle error number cross reference
 ERR_ORACLE_ERROR_XREF = {
+    22: ERR_CONNECTION_CLOSED,
     28: ERR_CONNECTION_CLOSED,
+    31: ERR_CONNECTION_CLOSED,
+    45: ERR_CONNECTION_CLOSED,
+    378: ERR_CONNECTION_CLOSED,
     600: ERR_CONNECTION_CLOSED,
+    602: ERR_CONNECTION_CLOSED,
+    603: ERR_CONNECTION_CLOSED,
+    609: ERR_CONNECTION_CLOSED,
     1005: ERR_NO_CREDENTIALS,
+    1012: ERR_CONNECTION_CLOSED,
+    1041: ERR_CONNECTION_CLOSED,
+    1043: ERR_CONNECTION_CLOSED,
+    1089: ERR_CONNECTION_CLOSED,
+    1092: ERR_CONNECTION_CLOSED,
     1740: ERR_MISSING_ENDING_DOUBLE_QUOTE,
     1756: ERR_MISSING_ENDING_SINGLE_QUOTE,
+    2396: ERR_CONNECTION_CLOSED,
+    3113: ERR_CONNECTION_CLOSED,
+    3114: ERR_CONNECTION_CLOSED,
+    3122: ERR_CONNECTION_CLOSED,
+    3135: ERR_CONNECTION_CLOSED,
+    12153: ERR_CONNECTION_CLOSED,
+    12537: ERR_CONNECTION_CLOSED,
+    12547: ERR_CONNECTION_CLOSED,
+    12570: ERR_CONNECTION_CLOSED,
+    12583: ERR_CONNECTION_CLOSED,
     22165: (
         ERR_INVALID_COLL_INDEX_SET,
         r"index \[(?P<index>\d+)\] must be in the range of "
@@ -391,7 +413,10 @@ def _raise_not_supported(feature: str) -> None:
     24496: ERR_POOL_NO_CONNECTION_AVAILABLE,
     24338: ERR_INVALID_REF_CURSOR,
     24344: WRN_COMPILATION_ERROR,
+    27146: ERR_CONNECTION_CLOSED,
+    28511: ERR_CONNECTION_CLOSED,
     38902: ERR_TOO_MANY_BATCH_ERRORS,
+    56600: ERR_CONNECTION_CLOSED,
 }
 
 # ODPI-C error number cross reference