EF Core调用Oracle自定义函数如何映射

老丽大大_6836

老丽大大_6836

2026-10-26

291人浏览

原创

EF Core 无法直接调用 Oracle 自定义集合函数,须用原生 SQL + SqlQuery 配合 TABLE() 包装调用,T 为无键 DTO;参数需用 OracleParameter 绑定,字段名须与 Oracle 返回列名完全一致(大小写敏感),且数据库自定义类型须与 DTO 严格匹配。

ef core调用oracle自定义函数如何映射

EF Core 本身不支持直接调用 Oracle 自定义函数(尤其是返回自定义集合类型如 UT_BLOCKED_STATISTICS_LIST)并自动映射为实体列表。必须绕过 EF Core 的 LINQ 查询管道,用原生 SQL + SqlQuery<t></t> 配合 TABLE() 函数包装调用,且 T 必须是无键 DTO。

Oracle 自定义函数需用 TABLE() 包装才能被当作表查询

Oracle 的自定义函数若返回集合类型(如 UT_BLOCKED_STATISTICS_LIST),不能像存储过程那样用 PL/SQL 块调用;必须用 SQL 层的 SELECT * FROM TABLE(函数名(...)) 语法,让 Oracle 将其“展开”为结果集。

  • TABLE() 是 Oracle 特有语法,EF Core 不识别它作为函数调用,只能当普通 SQL 字符串传入
  • 函数参数必须用命名占位符(如 :begintime),不能用位置参数或字符串拼接(防注入)
  • 日期参数要显式转成 DATE 类型,例如 TO_DATE(:begintime, 'yyyy-mm-dd hh24:mi:ss')
  • 最终 SQL 示例:"SELECT * FROM TABLE(get_BLOCKED_STATISTICS(TO_DATE(:begintime, 'yyyy-mm-dd hh24:mi:ss'), TO_DATE(:endtime, 'yyyy-mm-dd hh24:mi:ss')))"

SqlQuery<t></t> 要求 T 是无主键、无导航属性的纯 DTO

EF Core 7+ 的 SqlQuery<t></t> 不走实体跟踪,也不校验主键——但如果你的 T 类里有 [Key] 或继承了带主键的基类,运行时可能报错或结果为空。

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载
  • DTO 类字段名必须和函数返回的列名**完全一致(大小写敏感)**,因为 Oracle 默认大写,而 .NET 属性默认 PascalCase;建议统一用大写字段名或加 [Column("TWO_DPT_CDE")]
  • 在 OnModelCreating 中必须配置:modelBuilder.Entity<blockedstatistics>().HasNoKey();</blockedstatistics>
  • 不要在该类上加 [Table] 或任何关系配置,否则 EF 可能尝试做额外元数据解析

参数传递必须用 OracleParameter,不能用内插字符串

Oracle 驱动(Oracle.ManagedDataAccess.Core)对参数绑定较严格:字符串插值会直接拼进 SQL,导致日期格式错误、引号逃逸失败、SQL 注入风险。

  • 所有参数必须是 OracleParameter 实例,类型(OracleDbType)要匹配函数定义(如 Varchar2、Date、Int32)
  • 日期参数推荐用 DateTime 类型传入,驱动会自动处理时区和精度;避免传字符串再靠 TO_DATE 转换(易出错)
  • 示例代码片段:
var beginParam = new OracleParameter("begintime", OracleDbType.Date) { Value = DateTime.Now.AddDays(-7) };
var endParam = new OracleParameter("endtime", OracleDbType.Date) { Value = DateTime.Now };
var results = context.Database.SqlQuery<blockedstatistics>(
    "SELECT * FROM TABLE(get_BLOCKED_STATISTICS(:begintime, :endtime))",
    beginParam, endParam
).ToList();</blockedstatistics>

多结果集或嵌套对象无法自动展开

如果自定义函数返回的是嵌套结构(比如一个字段是 JSON 字符串或另一个自定义对象),EF Core 的 SqlQuery<t></t> 只做扁平映射——它不会递归解析 JSON,也不会把字段映射成子对象。

  • 遇到 VARCHAR2 存 JSON 的情况,只能先映射为 string,再用 System.Text.Json 手动反序列化
  • 若函数返回多个不同结构的集合(比如同时返回统计摘要 + 明细列表),EF Core 一次 SqlQuery 只能取一个结果集;需拆成多次调用或改用 DbCommand 手动读取多个 OracleRefCursor
  • 注意:TABLE() 只适用于返回集合类型的函数,不适用于返回单个标量(如 NUMBER 或 VARCHAR2)的函数;后者应改用 ExecuteSqlRaw + 输出参数

最易被忽略的一点:Oracle 自定义类型(OBJECT / TABLE OF OBJECT)必须在数据库中已存在,且 .NET 端 DTO 的字段顺序、名称、类型必须与数据库类型定义逐字匹配——差一个空格或大小写都可能导致 ORA-00902: invalid datatype 或静默空结果。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

4543

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

951

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1189

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

6501

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3283

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

6480

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

8881

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1210

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1052

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程