萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> Oracle 教學

ODAC 實戰技巧 (二):BLOB/CLOB 大對象讀寫全攻略——EMPTY_LOB、RETURNING 與存儲過程封裝

LOB 存儲機制與 LONG 的本質區別

特性BLOB / CLOB (LOB)LONG / LONG RAW
存儲方式表中存 **LOB 定位器**,實際數據在獨立 LOB 段實際數據直接存表中
讀取返回返回 **定位器**,需額外讀取數據直接返回數據值
最大長度128 TB (取決於塊大小)2 GB
隨機讀寫支援 `DBMS_LOB` 片段操作僅順序讀寫

**結論**:LOB 靈活強大,但 DML 操作必須遵循「先初始化定位器,再寫入數據」的兩階段協議。

錯誤示範:直接 UPDATE LOB 列會報錯

-- 錯誤:LOB 定位器未初始化
UPDATE ClobTable
SET Name = :Name, Value = :Value
WHERE Id = :Id;
-- ORA-22275: invalid LOB locator specified

正確姿勢:EMPTY_LOB() + RETURNING 初始化定位器

UPDATE ClobTable
SET Name = :Name,
    Value = EMPTY_CLOB()          -- ① 初始化空 LOB 定位器
WHERE Id = :Id
RETURNING Value INTO :Value;      -- ② 返回初始化後的定位器給綁定變量

此時綁定變量 `:Value` 持有有效定位器,ODAC 內部隨後調用 `OCILobWrite` 寫入實際數據。

最佳封裝:存儲過程內建初始化邏輯

將 LOB 初始化封裝在存儲過程,應用層只需傳入業務參數,簡單安全:

CREATE OR REPLACE PROCEDURE ClobTableUpdate (
    p_Id    IN  NUMBER,
    p_Name  IN  VARCHAR2,
    p_Value OUT CLOB               -- OUT 參數返回初始化定位器
) IS
BEGIN
    UPDATE ClobTable
    SET Name = p_Name,
        Value = EMPTY_CLOB()
    WHERE Id = p_Id
    RETURNING Value INTO p_Value;  -- 返回定位器給調用者
END;
/
-- ODAC 調用示例
OraStoredProc.StoredProcName := 'ClobTableUpdate';
OraStoredProc.ParamByName('p_Id').AsInteger := 100;
OraStoredProc.ParamByName('p_Name').AsString := 'New Name';
OraStoredProc.ParamByName('p_Value').AsMemo := '大文本內容...'; -- 自動寫入 LOB
OraStoredProc.ExecProc;

ODAC 組件層面的 LOB 處理細節

  • TOraQuery/TSmartQuery:`FieldByName('CLOB_FIELD').AsString` / `AsWideString` 自動讀取完整內容(內部調用 `OCILobRead`)。
  • TBlobField/TClobField:設計時持久化字段組件可視化綁定。
  • 大文件流式讀寫:使用 `TOraBlob`/`TOraClob` 介面的 `Read`/`Write`/`CopyToFile`/`LoadFromFile` 方法,避免一次性載入大內存。

常見坑點避雷

  1. 事務未提交時 LOB 鎖定:同一事務內多次更新同一 LOB 會自我阻塞,保持事務短小。
  2. 字符集轉換:`CLOB` 存儲字符集為資料庫字符集,`NCLOB` 為國家字符集。跨字符集應用需注意隱式轉換導致的數據損壞。
  3. 臨時 LOB 洩漏:`DBMS_LOB.CREATETEMPORARY` 創建的臨時 LOB 必須 `FREETEMPORARY`,否則佔用臨時表空間直到會話結束。

總結

LOB 操作核心口訣:**「先 EMPTY_LOB 初始化,再 RETURNING 拿定位器,最後寫入數據」**。封裝入存儲過程是生產環境的標準化最佳實踐,ODAC 組件層已自動處理定位器綁定與流式讀寫,開發者專注業務邏輯即可。

copyright © 萬盛學電腦網 all rights reserved