DB2存储过程读取含Blob的平面文件遇UTL_FILE报错求助

错误原因 #

UTL_FILE.GET_LINE 是专门用于读取文本行的函数，会将读取内容当作文本解析。而Blob是二进制数据，其中可能包含非文本字符、不可见控制符或超出文本编码范围的字节，用GET_LINE读取时会触发UTL_FILE.VALUE_ERROR——函数无法将二进制内容解析为合法文本。

解决方案 #

改用UTL_FILE的二进制读取方式，步骤如下：

• 以二进制模式打开文件：调用UTL_FILE.FOPEN时，第三个参数指定为'rb'（只读二进制模式），避免文本模式的编码转换。
• 用UTL_FILE.READ读取二进制数据：该函数支持按指定字节数读取原始二进制内容，适配Blob的存储特性。
• 循环读取并拼接Blob数据：每次读取固定字节（最大32767字节，DB2 UTL_FILE单次读取上限），直到文件结束，将读取的RAW数据追加到Blob变量中。
• 捕获文件结束异常：通过NO_DATA_FOUND异常判断文件读取完成。

示例存储过程代码 #

CREATE OR REPLACE PROCEDURE LOAD_BLOB_TO_TABLE(
    IN P_DIR VARCHAR(255),       -- UTL_FILE已配置的目录名
    IN P_FILENAME VARCHAR(255),  -- 要读取的平面文件名
    IN P_TARGET_TABLE VARCHAR(255), -- 目标表名
    IN P_ID_COL VARCHAR(100),    -- 目标表主键列名
    IN P_ID_VAL INTEGER,         -- 主键值
    IN P_BLOB_COL VARCHAR(100)   -- 目标Blob列名
)
LANGUAGE SQL
MODIFIES SQL DATA
BEGIN
    DECLARE V_FILE_HANDLE UTL_FILE.FILE_TYPE;
    DECLARE V_RAW_CHUNK RAW(32767);
    DECLARE V_FINAL_BLOB BLOB(10485760); -- 10M，可按需调整大小
    DECLARE V_IS_EOF BOOLEAN DEFAULT FALSE;

    -- 打开二进制文件
    SET V_FILE_HANDLE = UTL_FILE.FOPEN(P_DIR, P_FILENAME, 'rb');

    -- 循环读取二进制块
    LOOP
        BEGIN
            -- 单次读取最大允许的字节数
            CALL UTL_FILE.READ(V_FILE_HANDLE, V_RAW_CHUNK, 32767);
            -- 将读取的二进制块追加到Blob变量
            SET V_FINAL_BLOB = V_FINAL_BLOB || V_RAW_CHUNK;
        EXCEPTION
            WHEN NO_DATA_FOUND THEN
                -- 文件读取完毕
                SET V_IS_EOF = TRUE;
        END;
        EXIT WHEN V_IS_EOF;
    END LOOP;

    -- 关闭文件句柄
    CALL UTL_FILE.FCLOSE(V_FILE_HANDLE);

    -- 将Blob数据写入目标表（此处以INSERT为例，可替换为UPDATE）
    EXECUTE IMMEDIATE 'INSERT INTO ' || P_TARGET_TABLE || ' (' || P_ID_COL || ', ' || P_BLOB_COL || ') VALUES (?, ?)'
        USING P_ID_VAL, V_FINAL_BLOB;

EXCEPTION
    WHEN OTHERS THEN
        -- 异常安全处理：确保文件被关闭
        IF UTL_FILE.IS_OPEN(V_FILE_HANDLE) THEN
            CALL UTL_FILE.FCLOSE(V_FILE_HANDLE);
        END IF;
        -- 抛出包含错误信息的自定义异常
        SIGNAL SQLSTATE '70001' SET MESSAGE_TEXT = '加载Blob失败: ' || SQLERRM;
END@

注意事项 #

• 确保导出Blob时使用了二进制模式写入，否则导出的文件本身已损坏，无法还原为原始Blob。
• 根据实际Blob大小调整V_FINAL_BLOB的声明（例如BLOB(1G)用于超大Blob）。
• 确认UTL_FILE配置的目录有读取权限，存储过程的执行用户拥有该目录的访问权限。
• 单次读取的字节数不能超过DB2 UTL_FILE的上限（默认32767字节），否则会触发其他错误。

内容的提问来源于stack exchange，提问作者Cammy