Oracle JDBC流式查询必须显式关闭自动提交,否则fetchSize失效且可能报ORA-01002;需用PreparedStatement、TYPE_FORWARD_ONLY和CONCUR_READ_ONLY,并注意驱动与Oracle版本兼容性。
Oracle JDBC驱动流式查询必须显式关闭自动提交
oracle的流式拉取(streaming fetch)依赖于游标保持打开状态,而默认的connection在自动提交(auto-commit)模式下,每执行一条语句都会隐式提交并可能提前关闭游标。不关掉它,fetchsize设再大也拿不到流式效果,甚至直接报ora-01002: fetch out of sequence。
实操建议:
- 调用
connection.setAutoCommit(false),且后续无需手动commit()(流式读取不涉及写操作) - 若业务逻辑中该连接还用于其他DML操作,请确保流式查询独占一个专用
Connection - 使用完务必调用
connection.close()——Oracle服务端游标资源不会自动释放,不关连接会导致游标泄漏
fetchSize设多少才真正触发服务器端分批拉取
Oracle JDBC驱动对fetchSize的处理是“建议型”的:它只在满足特定条件时才会启用服务器端游标分页(即真正流式),否则仍是一次性把结果集全拉到客户端内存。
关键条件有三个,缺一不可:
- 使用
PreparedStatement(不能是Statement) -
ResultSet类型为ResultSet.TYPE_FORWARD_ONLY(默认值,但显式指定更稳妥) -
ResultSet并发模式为ResultSet.CONCUR_READ_ONLY(同样默认,但建议显式声明)
示例设置:
立即学习“Java免费学习笔记(深入)”;
PreparedStatement ps = connection.prepareStatement(
"SELECT id, name, content FROM large_table WHERE status = ?",
ResultSet.TYPE_FORWARD_ONLY,
ResultSet.CONCUR_READ_ONLY
);
ps.setFetchSize(1000); // 这个值才可能生效
ResultSet rs = ps.executeQuery();
ResultSet.next()才是真正的“拉取动作”,不是executeQuery()
很多人误以为调用executeQuery()时数据就已开始分批传输,其实不然。Oracle JDBC直到第一次调用rs.next()才会向数据库发起首次fetch请求;后续每次next()都可能触发一次网络往返(取决于fetchSize和剩余行数)。
这意味着:
- 如果循环中对每行做耗时处理(如IO、HTTP调用),
next()的延迟会暴露出来,需留意整体吞吐瓶颈位置 - 不能在
rs.next()前就关闭Connection或PreparedStatement,否则抛SQLException: Closed Connection - 调用
rs.close()会立即发送close cursor指令给Oracle,未读完的行将被丢弃(无异常)
注意Oracle版本与ojdbc驱动的兼容性陷阱
Oracle 12c R1(12.1.0.x)起引入了隐式结果集(implicit statement cache)和新的fetch协议优化,但老版本ojdbc驱动(如ojdbc6)无法识别,仍走传统路径,导致fetchSize失效或行为异常。
推荐组合:
- Oracle 12cR2+ 或 19c/21c → 使用
ojdbc8.jar(对应JDK 8+) - Oracle 11gR2 → 必须用
ojdbc6.jar,且确认数据库参数cursor_sharing不能设为FORCE(否则预编译被改写,破坏fetchSize语义) - 无论哪个版本,避免混用不同大版本的ojdbc jar(例如用ojdbc8连11g库虽能连上,但流式fetch可能静默退化)
最容易被忽略的一点:Oracle服务端参数array_size(SQL*Plus里的/SET ARRAYSIZE)不影响JDBC驱动行为,JDBC完全由setFetchSize()和驱动内部协议控制,别被DBA经验误导。



















