萬盛學電腦網

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

Oracle BLOB 存儲圖片文件完整指南:從目錄建立到存儲過程實作

概述

Oracle BLOB (Binary Large Object) 資料類型可高效存儲圖片、文檔、多媒體等二進制資料。本文透過完整步驟示範:建立資料表、創建目錄物件、編寫存儲過程、驗證存取,助您快速掌握檔案入庫核心技術。

步驟 1:建立存儲表

CREATE TABLE image_lob (
  t_id     VARCHAR2(5) NOT NULL PRIMARY KEY,
  t_image  BLOB        NOT NULL
);

步驟 2:建立目錄物件

目錄物件對應作業系統實際路徑,供 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>;

步驟 3:建立圖片插入存儲過程

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;

步驟 4:驗證測試

-- 執行存儲過程
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';

進階應用:讀取與輸出圖片

PL/SQL 讀取範例

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;

Java/JDBC 讀取關鍵碼

Blob blob = rs.getBlob("t_image");
InputStream is = blob.getBinaryStream();
// 直接輸出至 ServletOutputStream 或寫入檔案

效能優化與最佳實踐

  • 大檔案分塊處理:超過 1GB 檔案建議使用 DBMS_LOB.COPY 分批載入;
  • SecureFiles (11g+):建議使用 STORE AS SECUREFILE 啟用壓縮、重複資料刪除、加密;
  • 索引策略:BLOB 欄位本身不建索引,若需搜尋請另建檔案屬性欄位(名稱、大小、MIME 類型、上傳時間);
  • 備份考量:大量 BLOB 會顯著增加備份時間,評估是否採用 DBMS_LOB.CREATETEMPORARY 暫存或外部表方案。

常見問題排查

錯誤代碼原因解決方法
ORA-22285目錄不存在或路徑無效檢查 CREATE DIRECTORY 路徑與 OS 權限
ORA-01031缺少目錄讀寫權限GRANT READ, WRITE ON DIRECTORY ...
ORA-22992LOB 定位器已失效確保同一交易中使用 RETURNING 取得的定位器
copyright © 萬盛學電腦網 all rights reserved