Minor tweak to previous change plus addition of test cases.

Author: anthony-tuininga

doc/src/api_manual/module.rst

@@ -2277,10 +2277,10 @@ when binding data.
     :data:`DATETIME`.
 
 
-.. data:: DB_TYPE_UNSUPPORTED
+.. data:: DB_TYPE_UNKNOWN
 
     Describes columns, attributes or array elements in a database that are
-    unknown and unsupported.
+    of an unknown type.
 
 
 .. data:: DB_TYPE_UROWID

src/oracledb/base_impl.pxd

@@ -67,7 +67,7 @@ cdef enum:
     DB_TYPE_NUM_TIMESTAMP = 2012
     DB_TYPE_NUM_TIMESTAMP_LTZ = 2014
     DB_TYPE_NUM_TIMESTAMP_TZ = 2013
-    DB_TYPE_NUM_UNSUPPORTED = 0
+    DB_TYPE_NUM_UNKNOWN = 0
     DB_TYPE_NUM_UROWID = 2030
     DB_TYPE_NUM_VARCHAR = 2001
 

src/oracledb/impl/base/types.pyx

@@ -1,5 +1,5 @@
 #------------------------------------------------------------------------------
-# Copyright (c) 2020, 2022, Oracle and/or its affiliates.
+# Copyright (c) 2020, 2023, 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
@@ -160,8 +160,7 @@ DB_TYPE_TIMESTAMP_LTZ = DbType(DB_TYPE_NUM_TIMESTAMP_LTZ,
 DB_TYPE_TIMESTAMP_TZ = DbType(DB_TYPE_NUM_TIMESTAMP_TZ, "DB_TYPE_TIMESTAMP_TZ",
                               "TIMESTAMP WITH TZ", 181,
                               buffer_size_factor=13)
-DB_TYPE_UNSUPPORTED = DbType(DB_TYPE_NUM_UNSUPPORTED, "DB_TYPE_UNSUPPORTED",
-                             "UNSUPPORTED")
+DB_TYPE_UNKNOWN = DbType(DB_TYPE_NUM_UNKNOWN, "DB_TYPE_UNKNOWN", "UNKNOWN")
 DB_TYPE_UROWID = DbType(DB_TYPE_NUM_UROWID, "DB_TYPE_UROWID", "UROWID", 208)
 DB_TYPE_VARCHAR = DbType(DB_TYPE_NUM_VARCHAR, "DB_TYPE_VARCHAR", "VARCHAR2",
                          1, 4000, csfrm=1, buffer_size_factor=4)

tests/sql/create_schema.sql

@@ -132,6 +132,16 @@ create or replace type &main_user..udt_Book as object (
 );
 /
 
+create or replace type &main_user..udt_UnknownAttributeType as object (
+    NumberValue                         number(9),
+    XMLValue                            sys.xmltype
+);
+/
+
+create or replace type &main_user..udt_UnknownElementType
+as table of sys.xmltype;
+/
+
 -- create tables
 create table &main_user..TestNumbers (
     IntCol                              number(9) not null,

tests/test_2300_object_var.py

@@ -594,5 +594,19 @@ def test_2327_large_collection(self):
                                       (2327, obj))
         self.assertEqual(result, 7146445847327)
 
+    @unittest.skipIf(test_env.get_is_thin(),
+                     "thin mode doesn't have any unknown types currently")
+    def test_2328_unknown_type_attribute(self):
+        "2328 - test object with unknown type in one of its attributes"
+        typ = self.connection.gettype("UDT_UNKNOWNATTRIBUTETYPE")
+        self.assertEqual(typ.attributes[1].type, oracledb.DB_TYPE_UNKNOWN)
+
+    @unittest.skipIf(test_env.get_is_thin(),
+                     "thin mode doesn't have any unknown types currently")
+    def test_2329_unknown_type_element(self):
+        "2329 - test object with unknown type as the element type"
+        typ = self.connection.gettype("UDT_UNKNOWNELEMENTTYPE")
+        self.assertEqual(typ.element_type, oracledb.DB_TYPE_UNKNOWN)
+
 if __name__ == "__main__":
     test_env.run_test_cases()