讲师中心 微信公众号
AI工具推荐 视频效率加速

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

老丽大大_6836

老丽大大_6836

发布时间:2026-10-26 12:43:22

|

291人浏览过

|

来源于php中文网

原创

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();

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

如果自定义函数返回的是嵌套结构(比如一个字段是 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 或静默空结果。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

4523

2023.10.12

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

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

931

2023.10.27

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

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

1189

2024.02.23

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

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

6481

2024.03.06

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

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

3263

2024.03.06

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

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

6440

2024.04.07

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

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

8821

2024.04.29

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

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

1190

2024.04.29

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn