Oracle BLOB (Binary Large Object) 資料類型可高效存儲圖片、文檔、多媒體等二進制資料。本文透過完整步驟示範:建立資料表、創建目錄物件、編寫存儲過程、驗證存取,助您快速掌握檔案入庫核心技術。
CREATE TABLE image_lob (
t_id VARCHAR2(5) NOT NULL PRIMARY KEY,
t_image BLOB NOT NULL
);
目錄物件對應作業系統實際路徑,供 BFILENAME 使用:
CREATE OR REPLACE DIRECTORY images AS 'C:\Oracle\Images';
-- Linux/Unix 範例:CREATE OR REPLACE DIRECTORY images AS '/u01/app/oracle/images';
權限授予: GRANT READ, WRITE ON DIRECTORY images TO <user>;
CREATE OR REPLACE PROCEDURE img_insert (
p_tid IN VARCHAR2,
p_filename IN VARCHAR2
) AS
v_bfile BFILE;
v_blob BLOB;
BEGIN
-- 1. 插入空 BLOB 並取得 LOB 定位器
INSERT INTO image_lob (t_id, t_image)
VALUES (p_tid, EMPTY_BLOB())
RETURNING t_image INTO v_blob;
-- 2. 關聯 BFILE 並開啟
v_bfile := BFILENAME('IMAGES', p_filename);
DBMS_LOB.FILEOPEN(v_bfile, DBMS_LOB.FILE_READONLY);
-- 3. 將檔案內容載入 BLOB
DBMS_LOB.LOADFROMFILE(
dest_lob => v_blob,
src_lob => v_bfile,
amount => DBMS_LOB.GETLENGTH(v_bfile)
);
-- 4. 關閉 BFILE 並提交
DBMS_LOB.FILECLOSE(v_bfile);
COMMIT;
EXCEPTION
WHEN OTHERS THEN
IF DBMS_LOB.ISOPEN(v_bfile) = 1 THEN
DBMS_LOB.FILECLOSE(v_bfile);
END IF;
RAISE;
END img_insert;
-- 執行存儲過程
EXEC img_insert('001', 'product_photo.jpg');
-- 驗證資料長度
SELECT t_id, DBMS_LOB.GETLENGTH(t_image) AS file_size
FROM image_lob
WHERE t_id = '001';
DECLARE
v_blob BLOB;
v_buffer RAW(32767);
v_amt BINARY_INTEGER := 32767;
v_offset INTEGER := 1;
BEGIN
SELECT t_image INTO v_blob FROM image_lob WHERE t_id = '001';
LOOP
DBMS_LOB.READ(v_blob, v_amt, v_offset, v_buffer);
-- 此處可透過 UTL_FILE 寫入檔案或透過 HTP 輸出至 Web
v_offset := v_offset + v_amt;
END LOOP;
EXCEPTION
WHEN NO_DATA_FOUND THEN
DBMS_OUTPUT.PUT_LINE('讀取完畢');
END;
Blob blob = rs.getBlob("t_image");
InputStream is = blob.getBinaryStream();
// 直接輸出至 ServletOutputStream 或寫入檔案
DBMS_LOB.COPY 分批載入;STORE AS SECUREFILE 啟用壓縮、重複資料刪除、加密;DBMS_LOB.CREATETEMPORARY 暫存或外部表方案。| 錯誤代碼 | 原因 | 解決方法 |
|---|---|---|
| ORA-22285 | 目錄不存在或路徑無效 | 檢查 CREATE DIRECTORY 路徑與 OS 權限 |
| ORA-01031 | 缺少目錄讀寫權限 | GRANT READ, WRITE ON DIRECTORY ... |
| ORA-22992 | LOB 定位器已失效 | 確保同一交易中使用 RETURNING 取得的定位器 |