ORA-01461: can bind a LONG value only for insert into a LONG column
Hibernate 執行批次插入/更新時拋出,伴隨 QueryTimeoutException: Could not execute JDBC batch update。
| 場景 | 資料庫欄位 | Hibernate 映射 | 問題 |
|---|---|---|---|
| 大文本 | CLOB / NCLOB | @Type(type="text") 或 String 無註解 | JDBC 驅動嘗試以 LONG 綁定傳送,Oracle 12c+ 已棄用 LONG |
| 大二進位 | BLOB | byte[] 無 @Lob | 同樣觸發 LONG 綁定路徑 |
Oracle JDBC 驅動對超過 4000 字元的 String/bytes,預設走 setString/setBytes 綁定為 LONG 型別,但目標欄位為 CLOB/BLOB,導致型別不匹配。
@Lob
@Type(type = "org.hibernate.type.TextType") // Hibernate 5+
@Column(name = "CONTENT", columnDefinition = "CLOB")
private String content;
// 或 JPA 2.1 標準寫法
@Lob
@Column(name = "CONTENT")
@Nationalized // 對應 NCLOB
private String content;
@Lob
@Column(name = "IMG_DATA")
private byte[] imgData;
在 persistence.xml 或 Spring DataSource 設定加入:
<property name="hibernate.jdbc.lob.non_contextual_creation" value="true"/>
解決 createClob() 等非上下文建立問題。
session.save/update 並 flush()。hibernate.jdbc.batch_size 適中(如 20-50),避免大物件撐爆批次緩衝區。@DynamicInsert/@DynamicUpdate 僅更新變更欄位,減少大欄位傳輸。-- 1. 新增 CLOB 欄位
ALTER TABLE tab ADD new_content CLOB;
-- 2. 資料遷移
UPDATE tab SET new_content = TO_LOB(old_long_col);
-- 3. 切換應用映射至 new_content
-- 4. 低峰期刪除舊 LONG 欄位
ALTER TABLE tab DROP COLUMN old_long_col;
正確使用 @Lob + @Type(TextType) 映射 CLOB/BLOB,配合 hibernate.jdbc.lob.non_contextual_creation=true,可徹底消除 ORA-01461,並獲得更好的大物件讀寫效能。