如何在C#中批量写入Oracle数据库

雨杰酱_1882

雨杰酱_1882

2026-08-06

671人浏览

原创

oraclebulkcopy是oracle官方驱动(≥19.10)提供的高速批量插入方案,基于direct path api绕过sql解析与日志生成;要求目标表已存在、禁用触发器与约束、显式列映射、合理设置batchsize(10000–50000),并严格处理null和date精度问题。

如何在c#中批量写入oracle数据库

用 OracleBulkCopy 实现高速批量插入

Oracle 官方驱动(Oracle.ManagedDataAccess)从 19.10 版本起正式支持 OracleBulkCopy,这是目前 C# 中写入 Oracle 最快的方式,原理类似 SQL Server 的 SqlBulkCopy,绕过常规 INSERT 语句解析与日志生成,直接走 Oracle 的 Direct Path API。

注意:它要求目标表必须已存在,不支持自动建表;且不能触发 INSERT 触发器,也不能执行 BEFORE/AFTER ROW 触发逻辑。

  • 必须使用 OracleConnection(非 OracleDataSource 或连接字符串别名)
  • 源数据建议用 DataTable 或 IDataReader,避免用 IEnumerable<t></t> 直接传入——后者会触发反射+逐行转换,严重拖慢速度
  • OracleBulkCopy.BatchSize 建议设为 10000–50000,太小增加网络往返,太大易 OOM 或事务回滚代价高
  • 目标列名必须与源数据列名或 ColumnMappings 完全匹配,大小写敏感(Oracle 默认大写,DataTable 列名若为小写需显式映射)

处理 NULL 和 DATE 类型的常见翻车点

Oracle 对 DATE 和 NULL 的批量写入非常敏感:如果 DataTable 中某列为 DateTime?(可空),但实际值是 null,而目标表该字段定义为 NOT NULL,OracleBulkCopy.WriteToServer 会直接抛出 Oracle.ManagedDataAccess.Client.OracleException: ORA-01400: cannot insert NULL into (...),而不是跳过或报具体哪一行。

更隐蔽的是 DateTime 精度问题:Oracle DATE 类型只存年月日时分秒(无毫秒),但 .NET 的 DateTime 默认带毫秒。如果源数据含毫秒值(如 DateTime.Now),OracleBulkCopy 会尝试写入,但 Oracle 可能截断或报 ORA-01830: date format picture ends before converting entire input string(尤其在 NLS_DATE_FORMAT 不匹配时)。

  • 写入前统一清理:对可空列,确保 DataTable.Columns[colName].AllowDBNull = true
  • 对 DATE 列,提前用 dt.AddTicks(-dt.Ticks % TimeSpan.TicksPerSecond) 截掉毫秒,或改用 OracleDbType.TimeStamp 并配 OracleBulkCopy.ColumnMappings
  • 不要依赖连接字符串里的 DateTime=1 参数——它只影响普通命令,对 bulk copy 无效

替代方案:当 OracleBulkCopy 不可用时用 FORALL + 参数化批量

如果用的是旧版驱动(FORALL 方式。本质是拼一个带集合参数的大 SQL,由 Oracle 服务端一次性执行。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

关键不是“怎么写 SQL”,而是怎么把 C# 数据高效转成 Oracle 能认的集合类型。最稳路径是用 OracleParameter 传入 Array,配合 OracleDbType.Int32 / OracleDbType.Varchar2 等数组类型。

  • 单次最多传约 1000 行(受 Oracle arraysize 和内存限制),再多就拆批
  • SQL 模板必须用命名参数(如 :ids),不能用位置占位符(?)——Oracle 数组绑定只认命名
  • 示例语句:FORALL i IN 1 .. :ids.COUNT INSERT INTO t (id, name) VALUES (:ids(i), :names(i))
  • 对应 C#:new OracleParameter("ids", OracleDbType.Int32, idsArray, ParameterDirection.Input) { ArrayBindSize = new int[idsArray.Length] } ——ArrayBindSize 必须设,否则 varchar 类型可能截断

连接和事务控制的实际取舍

批量写入不是“连上就开干”。Oracle 的事务行为和锁机制会让错误配置导致长时间阻塞或归档日志暴增。

默认情况下 OracleBulkCopy 不开启事务,每批是独立提交;而手写 FORALL 必须显式套在 OracleTransaction 里。但大事务(比如 100 万行包一个事务)极易失败回滚耗时极长,且可能触发 UNDO 表空间不足(ORA-30036)。

  • 推荐分批 commit:每 5000–10000 行 transaction.Commit() 一次,同时调用 connection.BeginTransaction(IsolationLevel.ReadCommitted)
  • 禁用自动提交:connection.AutoCommit = false,否则 OracleBulkCopy 会无视你手动开的事务
  • 如果表上有索引,考虑先 ALTER INDEX ... UNUSABLE,写完再 REBUILD——比边写边维护索引快 3–5 倍

真正卡住人的往往不是语法,而是 Oracle 实例侧的资源配额(比如 LOG_BUFFER 大小、UNDO_RETENTION 设置)和网络延迟抖动。压测时务必用真实数据量+生产级 DB 配置跑,本地 Oracle XE 很难复现并发锁表现。

相关文章

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

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

下载

相关标签:

oracle oracle数据库 c#

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

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

872

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

2331

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

805

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

2575

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

252

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

329

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

591

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

289

20

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

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

2023.10.12

3763

8

热门下载

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

精品课程

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