Oracle写CLOB必须三步:先INSERT EMPTY_CLOB()占位,再SELECT...FOR UPDATE锁定,最后DBMS_LOB.WRITEAPPEND追加;超32767字节需分片循环写,临时LOB须CREATETEMPORARY(...,TRUE)并FREETEMPORARY释放。

Oracle存储过程里写CLOB必须先占位再FOR UPDATE锁定
直接 INSERT INTO t(clob_col) VALUES ('超长文本') 超过4000字节就会报 ORA-01704: string literal too long;用绑定变量传入长字符串但没初始化LOB句柄,运行时会报 ORA-22922: nonexistent LOB value。根本原因是CLOB列存的是locator(指针),不是数据本身,必须先分配可写句柄。
安全写法分三步:
- 用
INSERT INTO t(id, clob_col) VALUES (1, EMPTY_CLOB())占位,不能传字符串字面量 - 立刻执行
SELECT clob_col INTO :clob_var FROM t WHERE id = 1 FOR UPDATE—— 缺FOR UPDATE必报ORA-22920 - 调
DBMS_LOB.WRITEAPPEND(:clob_var, LENGTH(v_str), v_str)追加;若v_str> 32767 字节,需切片循环写(如按4000字符/次)
BLOB写入时offset和amount单位必须按字节算
和CLOB不同,DBMS_LOB.READ 和 DBMS_LOB.WRITEAPPEND 对BLOB的 offset 和 amount 全部按**字节**计数。如果把UTF-8编码的中文当字符处理(比如 amount := LENGTH('你好') 得2),实际会只读2字节,导致截断在中间字节,返回乱码或 ORA-24801。
正确做法:
- 查长度用
DBMS_LOB.GETLENGTH(blob_var)或UTL_RAW.LENGTH(raw_data),不是LENGTH() - 写入前确认源数据是RAW类型;若来自VARCHAR2,先用
UTL_RAW.CAST_TO_RAW(v_str) - 每次
WRITEAPPEND的amount≤ 32767 字节;超长内容必须循环,且每次传入的buffer变量声明为RAW(32767)或VARCHAR2(32767)
临时LOB不设cache=>TRUE就读不到,不调FREETEMPORARY会内存泄漏
用 DBMS_LOB.CREATETEMPORARY(clob_var, FALSE) 创建临时LOB后,后续 DBMS_LOB.READ 可能返回空值——这是因 cache => FALSE 导致内容不缓存到PGA,读操作无法命中。
必须遵守两个硬性规则:
- 创建时第二个参数必须为
TRUE:DBMS_LOB.CREATETEMPORARY(clob_var, TRUE) - 写完必须显式释放:
DBMS_LOB.FREETEMPORARY(clob_var);漏掉这句会导致PGA持续增长,长期运行触发ORA-04030 - 临时LOB不能直接用于
INSERT ... VALUES (:clob_var)—— 它不在表中,得先用DBMS_LOB.COPY写入已存在的表字段LOB句柄
CONVERTTOBLOB不转码,只是字节复制
名字有误导性:DBMS_LOB.CONVERTTOBLOB 不做任何字符集转换。如果数据库字符集是 AL32UTF8,CLOB里“你好”存的是6字节UTF-8序列(0xE4BDA0E5A5BD),转出的BLOB就是这6字节。下游系统若期望GBK编码(“你好”是4字节 0xC4E3BAC3),直接用这个BLOB必然乱码。
真要跨编码写BLOB,得绕开这个函数:
- 先用
UTL_I18N.STRING_TO_RAW('你好', 'ZHS16GBK')得到目标编码的RAW - 再用
DBMS_LOB.WRITEAPPEND写入BLOB变量 - 或者用
UTL_RAW.CONVERT手动转换RAW字节流(需指定源/目标字符集ID)
最易被忽略的是:CLOB和BLOB的偏移单位差异、临时LOB的生命周期管理、以及CONVERTTOBLOB的纯字节语义——这三个点踩中任意一个,都会导致数据损坏或内存问题,且错误现象不直观。

















