fetchSize和游标

### MyBatis 中 `fetchSize` 设置与数据库游标的交互及其对连接构建的影响 #### 数据库游标的概念 数据库游标是一种临时的数据库对象，允许逐行访问查询结果集。对于大规模数据读取场景，使用游标可以有效降低内存占用并提高性能[^3]。然而，不同类型的数据库对游标的支持程度存在差异。例如，MySQL 默认仅支持客户端游标，这意味着所有的查询结果会被一次性加载到内存中；而 Oracle 和 DB2 支持服务器端游标，这使得可以通过分批提取的方式逐步获取数据。 #### `fetchSize` 的作用机制 在 MyBatis 中，`fetchSize` 参数通过 JDBC 驱动传递给底层 SQL 查询，用于控制每次从数据库服务器拉取的结果数量。具体来说： - 当 `fetchSize` 被设置为正值时，表示希望驱动程序按批次返回固定数目的记录。 - 若将其设为负值（如 `-2147483648` 即 `Integer.MIN_VALUE`），则表明启用全量抓取模式，即将所有匹配项一次性载入客户端缓存区[^1]。 值得注意的是，并非所有数据库都兼容这种自定义批量大小的功能——正如提到过的那样，MySQL 并不完全遵循这一约定，它总是采用逐条检索的形式即使指定了较高的 fetch size 数字也不会改变其行为特性[^1]。 #### 关于连接构建次数的具体讨论 MyBatis 自身并不会由于调整 `fetchSize` 导致新的数据库链接被不断创建出来。事实上，每一次真正的物理层面上新建立起来的 socket connection 主要取决于以下几个方面因素共同决定: 1. **事务边界**: 每个独立事务期间所维持的那个唯一持久化 channel 将贯穿始终直至结束才会归还至 pool 待命状态； 2. **Connection Pooling Mechanism**: 大多数时候我们依赖某种形式的 pooling solution 来重复利用已存在的 resources rather than constantly tearing down and spinning up fresh ones each time around. 因此单纯调节 `fetchSize`, 不论数值高低与否, 几乎不可能单独引发额外 unnecessary connections being spun off unless there exists some kind of misconfiguration elsewhere within your application setup or third-party plugins interfering with normal operations.[^2] --- 以下是基于 MySQL 环境下的一个简单示例展示如何结合 Cursor 类型配合特定 fetch size 完成高效大数据集合处理任务： ```xml <select id="selectExpireCouponMember" resultType="java.lang.Long" fetchSize="500"> SELECT DISTINCT member_id FROM t_dj_coupon WHERE end_time > #{startTime} AND end_time < #{endTime} </select> ``` ```java public interface CouponMapper { @Select("SELECT DISTINCT member_id FROM t_dj_coupon WHERE end_time BETWEEN #{startTime} AND #{endTime}") @Options(fetchSize = 500) Cursor<Long> selectExpiredMembers(@Param("startTime") String startTime,@Param("endTime")String endTime); } // Usage Example try (SqlSession session = sqlSessionFactory.openSession(); Cursor<Long> cursor = mapper.selectExpiredMembers(startDate,endDate)) { while (!cursor.isAfterLast()) { // Iterate until no more rows available. Long memberId = cursor.next(); process(memberId); // Custom business logic here... } }catch(Exception e){ log.error(e.getMessage(),e); } finally{ if(cursor!=null && !cursor.isClosed()){ cursor.close(); } } ``` 此代码片段清楚地展现了当面对海量数据需求时，合理运用 Cursor 结合恰当配置后的 fetch size 怎样帮助开发者既保障系统稳定性又能满足实际业务诉求的同时尽量减少不必要的资源浪费现象发生几率降到最低限度。 ---