Dapper怎么处理Oracle的REF CURSOR Dapper调用Oracle返回游标的SP

14次阅读

Dapper 通过 oracle.ManagedDataaccess 驱动支持 REF CURSOR,需用 OracleParameter 显式声明 OracleDbType.RefCursor 输出参数,并调用 Query 或 QueryMultiple 处理结果。

Dapper怎么处理Oracle的REF CURSOR Dapper调用Oracle返回游标的SP

Dapper 本身不原生支持 Oracle 的 REF CURSOR,但可以通过适配 Oracle 官方驱动(Oracle.ManagedDataAccess)配合手动处理参数来调用返回游标的存储过程。

确保使用 Oracle.ManagedDataAccess 驱动

Dapper 依赖底层 ADO.net 提供的参数类型支持。Oracle 的 REF CURSOR 在 .NET 中对应的是 OracleDbType.RefCursor,只有 Oracle 官方的 Oracle.ManagedDataAccess(OMDP)才完整支持该类型。不要用旧的 System.Data.OracleClient(已废弃)或第三方驱动。

  • 安装 NuGet 包:Oracle.ManagedDataAccess
  • 连接字符串需启用游标支持(默认开启,无需额外配置)
  • 确认项目目标框架兼容(.NET Core 3.1+ / .NET 5+ 推荐用 OMDP 3.x+)

在存储过程中正确定义 REF CURSOR 输出参数

Oracle 存储过程需显式声明 OUT SYS_REFCURSOR 参数,并在过程中用 OPEN ... for 打开它。例如:

CREATE OR REPLACE PROCEDURE GET_USERS(p_result OUT SYS_REFCURSOR) AS BEGIN   OPEN p_result FOR SELECT id, name, email FROM users WHERE status = 'A'; END;

注意:Dapper 不解析 PL/sql 块,只调用已编译好的存储过程,所以必须提前在数据库中创建好带 OUT SYS_REFCURSOR 的 SP。

用 Dapper 调用并映射 REF CURSOR 结果

关键在于:用 OracleParameter 显式指定 OracleDbType.RefCursorParameterDirection.Output,再将该参数传给 Dapper 的 Query 方法。Dapper 会自动识别并读取游标结果集。

  • 不能用匿名对象传参(如 new { p_result = ... }),必须用 DynamicParameters 或原生 OracleParameter[]
  • Query 必须指定泛型类型(如 User),字段名需与查询列名(或别名)大小写一致(Oracle 默认大写,建议 SQL 中用双引号或别名统一)
  • 示例代码:

using (var conn = new OracleConnection(connStr)) {   var p = new OracleParameter("p_result", OracleDbType.RefCursor) { Direction = ParameterDirection.Output };   var users = conn.Query(       "GET_USERS",        param: new[] { p },        commandType: CommandType.StoredProcedure   ).ToList(); }

处理多个 REF CURSOR 或复杂场景

一个存储过程可返回多个游标(多个 OUT SYS_REFCURSOR 参数),此时需用 QueryMultiple + 多次 Read()

  • 为每个游标定义独立的 OracleParameter,方向均为 Output
  • 调用 conn.QueryMultiple(...),然后按顺序调用 multi.Read()multi.Read()
  • 注意:Oracle 驱动要求所有 RefCursor 参数必须放在参数列表末尾,且顺序与 SP 定义一致

若需动态 SQL 或 PL/SQL 块(非预存 SP),可用 CommandType.Text + BEGIN ... END; 块,但需确保块内正确打开游标并赋值给参数变量。

基本上就这些。核心是驱动支持 + 参数类型明确 + Dapper 版本兼容。不复杂但容易忽略 Oracle 参数方向和类型匹配细节。

text=ZqhQzanResources