Improve error message when data structure overflow is detected (#536).

Author: anthony-tuininga

doc/src/release_notes.rst

@@ -58,6 +58,9 @@ Common Changes
       frames supporting the Arrow PyCapsule interface as requested
       (`issue 535 <https://github.com/oracle/python-oracledb/issues/535>`__).
     - Data frames with multiple chunks are now supported.
+    - Error ``DPY-8002: Apach Arrow C Data structure overflow detected. A
+      larger structure is needed.`` is now raised when an overflow is detected
+      (`issue 536 <https://github.com/oracle/python-oracledb/issues/536>`__).
     - Fixed bug when fetching NCHAR and NVARCHAR2 column data.
     - Fixed bug when attempting to convert an integer that cannot be
       represented as a native C ``int`` value to an Arrow data frame.

src/oracledb/arrow_impl.pyx

@@ -32,7 +32,7 @@
 
 cimport cpython
 
-from libc.errno cimport EINVAL
+from libc.errno cimport EINVAL, EOVERFLOW
 from libc.stdint cimport uintptr_t
 from libc.string cimport memcpy, memset, strlen, strchr
 from cpython cimport array

src/oracledb/errors.py

@@ -404,6 +404,7 @@ def _raise_not_supported(feature: str) -> None:
 # error numbers that result in DataError
 ERR_VALUE_TOO_LARGE = 8000
 ERR_NULLS_NOT_ALLOWED = 8001
+ERR_ARROW_DATA_STRUCTURE_OVERFLOW = 8002
 
 # Oracle error number cross reference
 ERR_ORACLE_ERROR_XREF = {
@@ -570,6 +571,10 @@ def _raise_not_supported(feature: str) -> None:
     ERR_ARROW_C_API_ERROR: (
         "Apache Arrow C Data Interface operation failed with error code {code}"
     ),
+    ERR_ARROW_DATA_STRUCTURE_OVERFLOW: (
+        "Apache Arrow C Data structure overflow detected. A larger structure "
+        "is needed."
+    ),
     ERR_ARROW_SPARSE_VECTOR_NOT_ALLOWED: (
         "Apache Arrow format does not support sparse vectors with flexible "
         "dimensions"

src/oracledb/impl/arrow/utils.pyx

@@ -159,6 +159,8 @@ cdef int _check_nanoarrow(int code) except -1:
     it is not NANOARROW_OK.
     """
     if code != NANOARROW_OK:
+        if code == EOVERFLOW:
+            errors._raise_err(errors.ERR_ARROW_DATA_STRUCTURE_OVERFLOW)
         errors._raise_err(errors.ERR_ARROW_C_API_ERROR, code=code)