oracleparameter传table type必须设oracledbtype.object、udttypename(全大写带schema)、值为oracleudtcollection实例;需实现ioraclecustomtype接口,且数据库udt已存在并授权。
oracleparameter 传入 table type 前必须设置 oracledbtype 为 object 并指定 udttypename
oracle 的表类型(如 create type my_table_type as table of varchar2(100))在 .net 中不能直接用 string[] 或 list<string></string> 绑定。odp.net 要求显式声明该参数为对象类型,并通过 udttypename 指向数据库中已注册的 udt 名称(注意:不是 sql 类型名,而是大写、带 schema 的完整名,如 "schema_name"."my_table_type")。
常见错误是把 OracleDbType 设成 Varchar2 或 Array——这两个值对自定义表类型无效,会抛出 ORA-03115: unsupported network datatype or representation。
-
OracleParameter的OracleDbType必须设为OracleDbType.Object -
UdtTypeName必须与数据库中CREATE TYPE语句的 schema + type name 完全一致(区分大小写,且通常全大写) - 绑定的值不能是原生数组,必须是实现了
IOracleCustomType的类的实例(或其集合)
实现 IOracleCustomType 时,FromCustomObject 和 ToCustomObject 必须成对处理字段映射
如果你的 Oracle 表类型元素是简单类型(如 VARCHAR2),那对应的 .NET 类不需要字段;但 ODP.NET 仍强制要求你提供一个空壳类并实现接口。这个类本质是“占位符”,不存业务数据,只用于类型识别和序列化桥接。
典型错误是只实现 FromCustomObject 却忽略 ToCustomObject,或字段名拼写与 Oracle 对象属性不一致(哪怕大小写差一点,也会在运行时报 ORA-00904: invalid identifier)。
- 类需标记
[OracleCustomTypeMapping("SCHEMA_NAME.MY_TABLE_TYPE")],字符串必须与UdtTypeName一致 -
FromCustomObject:从 .NET 对象往 OracleOracleUdt写字段(即使无字段,也要调用udt.SetValue(null, "DUMMY", null)占位) -
ToCustomObject:从 OracleOracleUdt读字段回 .NET 对象(同理,若无字段则只 return new 实例) - 若表类型元素是对象类型(非标量),则需额外实现对应元素类型的
IOracleCustomType
传入集合时,用 OracleUdtCollection 包装,别直接传 List<t></t>
即使你已写好单个元素的 IOracleCustomType 映射类,也不能把 List<myelementtype></myelementtype> 直接赋给 OracleParameter.Value。ODP.NET 要求表类型参数的值必须是 OracleUdtCollection 实例,它内部按 Oracle 规则序列化元素。
容易踩的坑是手动 new OracleUdtCollection 但没指定 OracleUdtCollectionType,导致运行时报 System.InvalidOperationException: Collection type not set。
- 先 new
OracleUdtCollection,构造时传入元素类型对应的Type(即你实现IOracleCustomType的那个类) - 调用
Add()添加已初始化的元素实例(每个都必须是你的映射类实例,不能是 string/int 等原始类型) - 将该 collection 实例赋给
OracleParameter.Value - 确保连接打开后才执行命令(
OracleUdtCollection序列化依赖活动连接)
调试时优先检查 OracleConnection.GetTypeInfo() 是否能查到你的 UDT
很多“类型找不到”问题其实源于数据库端未正确注册或权限不足。在代码中加一句 conn.GetTypeInfo().Where(t => t.TypeName.Contains("MY_TABLE_TYPE"))(需引用 System.Data.Common),可快速确认 ODP.NET 是否感知到该类型。
如果返回空,说明要么:CREATE TYPE 没提交、没授权给应用用户、或者 UdtTypeName 大小写/Schema 写错。这时候看日志比单步调试参数更高效。
- 用 DBA 账户执行
SELECT * FROM ALL_TYPES WHERE TYPE_NAME = 'MY_TABLE_TYPE'确认存在且STATUS = 'VALID' - 确认应用用户有
EXECUTE权限:GRANT EXECUTE ON SCHEMA_NAME.MY_TABLE_TYPE TO app_user -
UdtTypeName中的 schema 名必须是创建 type 时使用的 schema,不能是当前登录用户(除非是同名)
Oracle 的表类型映射不是“配个类型就能跑”,它卡在三个地方:数据库端的 UDT 可见性、.NET 端的 IOracleCustomType 实现完整性、以及运行时 OracleUdtCollection 的构造时机。漏掉任一环,都会在执行时崩,而且错误信息往往不指向真实原因。











