oracle数组绑定必须用setarray()而非addbatch()，因后者仅为客户端模拟，仅setarray()能触发服务端array dml；需配合数据库自定义type、ojdbc8+/12c+环境及非null元素，多字段场景insert all更优，clob批量须绕开setarray()。

Oracle数组绑定必须用setArray()，不是addBatch()

Java里想靠Oracle原生数组绑定提速，addBatch() + executeBatch()只是客户端模拟批量，根本没触发Oracle的Array DML能力。真正起效的是PreparedStatement.setArray()——它让驱动把整组参数转成Oracle服务器端可识别的ARRAY类型，一次传入、一次解析、一次执行。

常见错误现象：

• 调了addBatch() 1000次，Wireshark抓包发现还是发了1000个独立SQL包
• 日志里看不到ARRAY bind或server-side batch字样
• 单批500行耗时2s，改成setArray()后降到0.3s

使用前提：

• Oracle JDBC驱动必须是ojdbc8.jar或ojdbc11.jar（老版ojdbc6.jar不支持）
• 数据库版本需为12c及以上（19c/21c已全面优化）
• 目标字段类型要与Oracle数组类型匹配，比如Java String[] → Oracle VARCHAR2数组

setArray()要求显式注册Oracle自定义数组类型

Oracle不认Java原生数组，必须先在数据库里建TYPE，再在Java里用connection.createArrayOf()或oracle.jdbc.OracleConnection.createOracleArray()包装。跳过这步直接setArray(1, stringArray)会抛SQLException: Invalid column type。

典型流程：

• 数据库侧：CREATE OR REPLACE TYPE str_array AS TABLE OF VARCHAR2(4000);
• Java侧：Array arr = conn.createArrayOf("STR_ARRAY", new String[]{"a","b","c"}); ps.setArray(1, arr);
• SQL写法：INSERT INTO t(col) SELECT COLUMN_VALUE FROM TABLE(?);

注意点：

Crypto Sniper Oracle

机构级量化市场预言机，提供订单簿失衡（OBI）、VWAP分析、自动化报告及Telegram预警。

下载

• TYPE名大小写敏感，"STR_ARRAY"和"str_array"是两个类型
• 数组元素不能含NULL（Oracle数组不支持空值），需提前过滤或替换为""
• 单次setArray()最大支持约10万元素，超限会触发ORA-04030

批量插入字段多时，INSERT ALL比数组绑定更省CPU

当单条记录字段超过10个，用setArray()绑定多个字段数组（如id_arr、name_arr、dept_arr）反而不如拼INSERT ALL语句。因为Oracle对多数组绑定的解析开销高于单条SQL内多INTO子句，尤其在PGA内存紧张时。

实测对比（1000行，15字段）：

• setArray() + 3个数组：平均耗时 1.8s
• INSERT ALL + executeBatch()（batchSize=200）：平均耗时 1.1s

写法要点：

• INSERT ALL INTO t(a,b,c) VALUES(?,?,?) INTO t(a,b,c) VALUES(?,?,?) SELECT * FROM DUAL
• 单条INSERT ALL最多支持约1000个INTO子句，超了必须拆批
• 所有VALUES里的占位符顺序必须严格一致，错一位就ORA-00913

含CLOB字段的批量写入必须绕开setArray()

Oracle数组类型不支持CLOB或BLOB，createArrayOf("CLOB_ARRAY", clobArray)会直接失败。强行用setArray()绑定CLOB字段，驱动会静默降级为单条处理，性能反不如普通addBatch()。

可行方案：

• 改用PreparedStatement.setClob()逐条构造，但必须配setAutoCommit(false)和合理batchSize（建议≤500）
• 数据源为文件时，直接切SQL*Loader或External Table，跳过JDBC层
• 服务端处理：用DBMS_LOB API在存储过程中加载，Java只传文件路径

最容易被忽略的一点：CLOB批量写入时，setClob()创建的临时LOB句柄必须在事务提交前保持有效；若连接池回收连接太快，会导致ORA-01002（fetch out of sequence）。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南