使用 Spring 框架調用 DB2 存儲過程完整指南

Spring 與 DB2 存儲過程集成概覽

Spring Framework 提供豐富的 JDBC 抽象與存儲過程調用支持，配合 DB2 強大的 SQL PL/PL/SQL 引擎，可將複雜業務邏輯下沉數據庫層，實現高性能、事務一致、安全可控的企業級應用。

依賴與配置

<dependency>
  <groupId>com.ibm.db2</groupId>
  <artifactId>jcc</artifactId>
  <version>11.5.x</version>
</dependency>
<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-jdbc</artifactId>
</dependency>

DataSource 配置 (HikariCP 推薦)：

spring.datasource.url=jdbc:db2://host:50000/DBNAME:retrieveMessagesFromServerOnGetMessage=true;
spring.datasource.username=app_user
spring.datasource.password=****
spring.datasource.hikari.maximum-pool-size=20

調用方式對比

1. SimpleJdbcCall (推薦，元數據驅動)

@Autowired DataSource dataSource;

public Map<String, Object> processOrder(Long orderId) {
    SimpleJdbcCall call = new SimpleJdbcCall(dataSource)
        .withProcedureName("PROCESS_ORDER")
        .withSchemaName("APP_SCHEMA")
        .declareParameters(
            new SqlParameter("IN_ORDER_ID", Types.BIGINT),
            new SqlOutParameter("OUT_STATUS", Types.VARCHAR),
            new SqlOutParameter("OUT_MSG", Types.VARCHAR)
        );
    return call.execute(Map.of("IN_ORDER_ID", orderId));
}

2. StoredProcedure 類繼承 (複雜邏輯、緩存 CallMetaData)

public class ProcessOrderProc extends StoredProcedure {
    public ProcessOrderProc(DataSource ds) {
        super(ds, "APP_SCHEMA.PROCESS_ORDER");
        setFunction(false);
        declareParameter(new SqlParameter("IN_ORDER_ID", Types.BIGINT));
        declareParameter(new SqlOutParameter("OUT_STATUS", Types.VARCHAR));
        declareParameter(new SqlOutParameter("OUT_MSG", Types.VARCHAR));
        compile();
    }
    public Map<String, Object> execute(Long orderId) {
        return super.execute(Map.of("IN_ORDER_ID", orderId));
    }
}

3. JdbcTemplate.call (底層控制)

jdbcTemplate.call(conn -> {
    CallableStatement cs = conn.prepareCall("{CALL APP_SCHEMA.PROCESS_ORDER(?, ?, ?)}");
    cs.setLong(1, orderId);
    cs.registerOutParameter(2, Types.VARCHAR);
    cs.registerOutParameter(3, Types.VARCHAR);
    return cs;
}, (CallableStatement cs) -> Map.of(
    "status", cs.getString(2),
    "msg", cs.getString(3)
));

進階主題

• 結果集處理：DB2 存儲過程返回游標 (RESULT SETS)，Spring 需配置 returnResultSetAsSqlReturnResultSet 或使用 SqlReturnResultSet 映射到 RowMapper。
• 數組/結構類型：DB2 支持陣列類型 (如 INTEGER ARRAY)，Spring 需實現 SqlTypeValue 自定義類型映射。
• 事務邊界：@Transactional 方法中調用存儲過程，存儲過程內部提交/回滾將影響外層事務，建議存儲過程不自行提交，由 Spring 管理。
• 批量調用：使用 JdbcTemplate.batchUpdate 配合 CallableStatementCreator 實現批量 CALL，減少網絡往返。

最佳實踐與坑點

1. 驅動版本匹配 DB2 服務器版本，啟用 extendedDiagnosticLevel=241 獲取詳細錯誤碼。
2. 存儲過程參數命名統一規範 (IN_/OUT_/INOUT_)，Spring 元數據讀取依賴系統目錄 (SYSCAT.ROUTINEPARMS)。
3. 避免在存儲過程中執行長時間運行的查詢導致連接池阻塞，必要時異步處理或拆分。
4. 單元測試使用 Testcontainers 啟動 DB2 實例，驗證參數映射、結果集、異常轉換。
5. 監控調用耗時、錯誤率，納入 APM (Micrometer + Prometheus/Grafana)。

總結

Spring 靈活的存儲過程調用 API 配合 DB2 強大的服務器端邏輯能力，是構建高性能、可維護企業應用的經典組合。關鍵在於選擇適合團隊技能的調用風格，建立統一規範，並做好監控與測試。