Oracle Multimedia DICOM 匯出操作步驟詳解：從資料庫到檔案系統

前言：DICOM 資料的雙向流動

醫學影像系統中，DICOM 檔案不僅需要匯入資料庫（歸檔、查詢、分析），更頻繁需要匯出至檔案系統——提供給 PACS 工作站讀片、燒錄病歷光碟、傳送至外部會診醫院、餵入 AI 推理引擎等。Oracle Multimedia 提供 ORDDicom.export() 方法，支援將資料庫中的 BLOB 完整、高效地寫入目標目錄。本文詳細記錄操作步驟、權限設定、驗證方法與進階場景。

操作步驟總覽

1. 作業系統建立匯出目錄並設定權限
2. 資料庫建立 Directory 物件並授權 WRITE
3. 建立 PL/SQL 匯出預存程序
4. 執行匯出
5. 驗證輸出檔案完整性

步驟 1：作業系統層準備

# 以 oracle 用戶執行
mkdir -p /u01/dicom_export
chown oracle:oinstall /u01/dicom_export
chmod 775 /u01/dicom_export

確保資料庫進程擁有的 OS 用戶（通常為 oracle）對目錄有寫入權限。

步驟 2：資料庫建立 Directory 並授權

CONNECT sys AS SYSDBA
CREATE OR REPLACE DIRECTORY EXPORTDIR AS '/u01/dicom_export';
GRANT READ, WRITE ON DIRECTORY EXPORTDIR TO app_user;  -- 執行匯出的應用用戶
-- 查詢確認
SELECT directory_name, directory_path FROM dba_directories WHERE directory_name = 'EXPORTDIR';

步驟 3：建立匯出預存程序

CONNECT app_user
CREATE OR REPLACE PROCEDURE dicom_export (
  p_source_id IN NUMBER,
  p_filename  IN VARCHAR2
) AS
  v_dcm ORDSYS.ORDDicom;
BEGIN
  -- 1. 查詢來源 DICOM 物件
  SELECT dicom INTO v_dcm FROM medical_image_table WHERE id = p_source_id;

  -- 2. 呼叫 export 方法
  -- 參數：'FILE'=目標類型, 'EXPORTDIR'=Directory 物件名, p_filename=輸出檔名
  v_dcm.export('FILE', 'EXPORTDIR', p_filename);
END;
/
SHOW ERRORS;

步驟 4：執行匯出

BEGIN
  dicom_export(1, 'dicom_orig.dcm');
END;
/
COMMIT;

步驟 5：驗證輸出檔案

5.1 作業系統層基本檢查

ls -lh /u01/dicom_export/dicom_orig.dcm
# 確認檔案大小 > 0、時間戳為最新

5.2 DICOM 結構驗證

# 使用 dcmdump (DCMTK) 或 gdcm
dcmdump /u01/dicom_export/dicom_orig.dcm | head -20
# 輸出應包含 DICOM 標籤，如 (0008,0016) SOP Class UID 等

5.3 資料庫層位元組數比對

SELECT id,
       DBMS_LOB.GETLENGTH(dicom.source.localData) AS db_bytes,
       (SELECT file_size FROM v$directory_files 
        WHERE directory_name='EXPORTDIR' AND file_name='dicom_orig.dcm') AS fs_bytes
FROM medical_image_table WHERE id = 1;

兩欄位數值應完全一致，確認無截斷、無損壞。

進階匯出場景

場景 A：批次匯出整個 Study

BEGIN
  FOR rec IN (SELECT id, sop_instance_uid 
              FROM medical_image_table 
              WHERE study_instance_uid = '1.2.3.4.5.6.7')
  LOOP
    dicom_export(rec.id, 'STUDY_' || rec.sop_instance_uid || '.dcm');
  END LOOP;
END;
/
COMMIT;

場景 B：匯出去識別化版本

CREATE OR REPLACE PROCEDURE dicom_export_anon (
  p_source_id IN NUMBER,
  p_filename  IN VARCHAR2
) AS
  v_dcm ORDSYS.ORDDicom;
BEGIN
  SELECT anonDicom INTO v_dcm FROM medical_image_table WHERE id = p_source_id;
  v_dcm.export('FILE', 'EXPORTDIR', p_filename);
END;
/
-- 呼叫
BEGIN dicom_export_anon(1, 'dicom_anon.dcm'); END;
/
COMMIT;

場景 C：匯出縮圖

CREATE OR REPLACE PROCEDURE thumb_export (
  p_source_id IN NUMBER,
  p_filename  IN VARCHAR2
) AS
  v_img ORDSYS.ORDImage;
BEGIN
  SELECT imageThumb INTO v_img FROM medical_image_table WHERE id = p_source_id;
  v_img.export('FILE', 'EXPORTDIR', p_filename);
END;
/
COMMIT;

效能與安全最佳實踐

常見錯誤排查

結語

Oracle Multimedia 的 export 以單一行呼叫、位元級完整、支援多目標類型的特性，讓資料庫成為 DICOM 檔案的權威來源與安全分發中心。配合 Directory 物件的權限模型，DBA 可精確控管誰能匯出什麼資料到哪裡，滿足醫療資訊法規對存取控制與稽核追蹤的嚴格要求。