Oracle中DBMS_LOB包使用小結

標籤：

本文主要介紹oracle資料庫中dbms_lob包的使用以及使用dbms_lob包來維護lob資料庫類型的基本方法。隨著社會的發展，在現代資訊系統的開發中，需要儲存的已不僅僅是簡單的文字資訊，同時還包括一些圖片和音像資料或者是超長的文本。比如開發一套旅遊資訊系統，每一個景點都有豐富的圖片、音像資料和大量的文字介紹。這就要求後台資料庫要有儲存這些資料的能力。ORACLE公司在其Oracle8i中通過提供LOB欄位實現了該功能。

在ORACLE資料庫中，LOB大物件類型是用來儲存大量的二進位和文本資料的一種資料類型（一個LOB欄位可儲存可多達4GB的資料）。目前，它又分為兩種類型：內部LOB和外部LOB。內部LOB將資料以位元組流的形式儲存在資料庫的內部。因而，內部LOB的許多操作都可以參與事務，也可以像處理普通資料一樣對其進行備份和恢複操作。Oracle8i支援三種類型的內部LOB：BLOB（位元據）、CLOB（單位元組字元資料）、NCLOB（多位元組國家字元資料）。其中CLOB和NCLOB類型適用於儲存超長的文本資料，BLOB欄位適用於儲存大量的位元據，像、視頻、音頻等。目前，Oracle8i只支援一種外部LOB類型，即BFILE類型。在資料庫內，該類型僅儲存資料在作業系統中的位置資訊，而資料的實體以外部檔案的形式存在於作業系統的檔案系統中。因而，該類型所表示的資料是唯讀，不參與事務。該類型可協助使用者管理大量的由外部程式訪問的檔案。

為了方便下文的敘述，我們假定使用如下語句在資料庫中建立了一張表。

123456

CREATE TABLE view_sites_info(site_id NUMBER(3),audio BLOB DEFAULT empty_blob(),DOCUMENT CLOB DEFAULT empty_clob(),video_file BFILE DEFAULT NULL,CONSTRAINT PK_TAB_view_sites_info PRIMARY KEY (site_id));

ORACL提供了多種使用和維護LOB的方式，如使用PL/SQL DBMS_LOB包、調用OCI（Oracle Call Interface）、使用Proc*C/C++、使用JDBC等。其中最為方便有效是使用PL/SQL調用DBMS_LOB包，本文就將介紹該方法。在Oracle中，儲存在LOB中資料稱為LOB的值，如使用Select對某一LOB欄位進行選擇，則返回的不是LOB的值，而是該LOB欄位的定位器（可以理解為指向LOB值的指標）。如執行如下的SQL語句：

12345678

DECLARE  audio_info BLOB;BEGIN  SELECT audio    INTO audio_info    FROM view_sites_info   WHERE site_id = 100;END;

儲存在AUDIO_INFO變數中的就是LOB定位器，而不是LOB的值。而要對某一LOB的值進行訪問和維護操作，必需通過其定位器來進行。DBMS_LOB包中提供的所有函數和過程都以LOB定位器作為參數。

DBMS_LOB包中主要提供了以下幾個過程供使用者對內部LOB欄位進行維護：

APPEND：將源LOB中的內容加到目的LOB中。

CLOSE：關閉已經開啟的LOB。

CREATETEMPORARY：在使用者的暫存資料表空間中，建立臨時LOB。

FILECLOSE：關閉開啟的BFILE定位器所指向的OS檔案。

FILECLOSEALL：關閉當前會話已經開啟的所有BFILE檔案。

FILEEXISTS：確定file_loc對應的OS檔案是否存在，1：存在。0：不存在。

FILEGETNAME：擷取BFILE定位器所對應的目錄別名和檔案名稱。

FILEISOPEN：確定BFILE對應的OS檔案是否開啟。

FREETEMPORARY：釋放在預設暫存資料表空間中的臨時LOB。

FILEOPEN：開啟檔案。

GETCHUNKSIZE：當建立包含CLOB/BLOB列的表時，通過指定CHUNK參數可以指定操縱LOB需要分配的位元組數（資料庫尺寸的整數倍）預設為資料區塊的尺寸。

COPY：從源LOB中複製資料到目的LOB。

ERASE：刪除LOB中全部或部分內容。

TRIM：將LOB值減少到指定的長度。

WRITE：向LOB中寫入資料。

INSTR：返回特定樣式資料從LOB某位移位置開始出現N次的具體位置。

IDOPEN：確定LOB是否開啟，開啟：1，未開啟：0。

ISTEMPORARY：確定定位器是否為臨時LOB。

LOADFROMFILE：將BFILE的部分或全部內容複寫到目標LOB變數。

LOADBLOBFROMFILE：將BFILE資料裝載到BLOB中，並且在裝載後取得最新的位移位置。

OPEN：開啟LOB，open_mode（唯讀：dbms_lob.lob_readonly，寫：dbms_lob.lob_readwrite）。

COMPARE：比較兩個同種資料類型的LOB的部分或全部值是否相同。

GETLENGTH：擷取LOB的長度。

READ：從LOB中讀出資料。

SUBSTR：與字元處理函數SUBSTR使用方法一樣。

WRITEAPPEND：將緩衝區資料寫到LOB尾部。

下面我們以最為常用的讀和寫為例詳細介紹這些過程的用法。首先介紹一下寫過程。該過程的文法為：

12345678

PROCEDURE WRITE(lob_loc IN OUT BLOB,                amount  IN BINARY_INTEGER,                offset  IN INTEGER,                buffer  IN RAW);PROCEDURE WRITE(lob_loc IN OUT CLOB CHARACTER SET any_cs,                amount  IN BINARY_INTEGER,                offset  IN INTEGER,                buffer  IN VARCHAR2 CHARACTER SET lob_loc%charset);

各參數的含義為：

lob_loc：要寫入的LOB定位器。

amount：寫入LOB中的位元組數。

offset：指定開始操作的位移量。

buffer：指定寫操作的緩衝區。

下面的代碼就是運用該過程向LOB欄位寫入資料的樣本：

1234567891011121314151617181920

DECLARE  lobloc CLOB;  buffer VARCHAR2(2000);  amount NUMBER := 20;  offset NUMBER := 1;BEGIN  --初始化要寫入的資料     buffer := ‘This is a writing example‘;  amount := length(buffer);  SELECT document    INTO lobloc --   擷取定位器並鎖定行       FROM view_sites_info   WHERE site_id = 100     FOR UPDATE;  dbms_lob.write(lobloc,                 amount,                 1,                 buffer);  COMMIT;END;

需要特別指出的是：

（1）在調用寫過程前一定要使用SELECT語句檢索到定位器且用FOR UPDATE子句鎖定行，否則不能更新LOB。

（2）寫過程從offset指定的位置開始，向LOB中寫入長度為amount的資料，原LOB中在這個範圍內的任何資料都將被覆蓋。

（3）緩衝區的最大容量為32767位元組，因此在寫入大量資料時需多次調用該過程。

下面再來介紹一下讀過程，該過程的文法為： 

12345678

PROCEDURE READ(lob_loc IN BLOB,               amount  IN OUT BINARY_INTEGER,               offset  IN INTEGER,               buffer  OUT RAW);PROCEDURE READ(lob_loc IN CLOB CHARACTER SET any_cs,               amount  IN OUT BINARY_INTEGER,               offset  IN INTEGER,               buffer  OUT VARCHAR2 CHARACTER SET lob_loc%charset);

各參數的含義為：

lob_loc：要讀取的LOB定位器。

amount：要讀取的位元組數。

offset：開始讀取操作的位移量。

buffer：儲存讀操作結果的緩衝區。 

下面的代碼示範了如何使用該過程讀取LOB欄位中的資料：

1234567891011121314151617

DECLARE  lobloc CLOB;  buffer VARCHAR2(2000);  amount NUMBER := 2;  offset NUMBER := 6;BEGIN  SELECT document    INTO lobloc --擷取定位器       FROM lob_store   WHERE lob_id = 100;  dbms_lob.read(lobloc,                amount,                offset,                buffer); --讀取資料到緩衝區     dbms_output.put_line(buffer); --顯示緩衝區中的資料     COMMIT;END;

append預存程序用於將一個大對象添加到另一個大對象中，此時是將源大對象的內容全部添加過去。append預存程序的文法如下：

1234	PROCEDURE append(dest_lob IN OUT NOCOPY BLOB,                 src_lob  IN BLOB);PROCEDURE append(dest_lob IN OUT NOCOPY CLOB CHARACTER SET any_cs,                 src_lob  IN CLOB CHARACTER SET dest_lob%charset);

其中，各個參數的含義如下：

dest_lob是被源lob添加到的目標lob的定位器。

src_lob是源lob的定位器。

any_cs用來指定字元集。

Oracle中DBMS_LOB包使用小結