萬盛學電腦網

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

Java 讀取 SQL Server TEXT/NTEXT/IMAGE 大物件欄位:getClob/getBlob 正確姿勢與 Base64 處理

避開 getString 截斷/亂碼陷阱,高效流式讀寫 LOB 數據

SQL Server `TEXT`/`NTEXT`/`IMAGE` (已棄用,對應 `VARCHAR(MAX)`/`NVARCHAR(MAX)`/`VARBINARY(MAX)`) 存儲大文本/二進制數據。Java JDBC **必須用 `getClob`/`getBlob` 流式讀取**,不能用 `getString`/`getBytes` (會載入整個物件到 JVM Heap,導致 OOM 或截斷)。

正確讀取模式:流式處理

String sql = "SELECT FileName, Content FROM Documents WHERE Id = ?";
try (Connection conn = DriverManager.getConnection(URL, USER, PASS);
     PreparedStatement ps = conn.prepareStatement(sql)) {
    ps.setInt(1, docId);
    try (ResultSet rs = ps.executeQuery()) {
        if (rs.next()) {
            String fileName = rs.getString("FileName");
            // 關鍵:獲取 Clob 物件,而非 getString
            Clob clob = rs.getClob("Content"); // NTEXT/VARCHAR(MAX)
            // 或 Blob blob = rs.getBlob("Content"); // IMAGE/VARBINARY(MAX)

            // 流式寫入檔案,避免記憶體暴漲
            try (Reader reader = clob.getCharacterStream();
                 BufferedWriter writer = Files.newBufferedWriter(Paths.get("D:/export", fileName))) {
                char[] buffer = new char[8192];
                int len;
                while ((len = reader.read(buffer)) != -1) {
                    writer.write(buffer, 0, len);
                }
            }
            // 二進制同理
            // try (InputStream in = blob.getBinaryStream();
            //      OutputStream out = Files.newOutputStream(Paths.get(...))) { ... }
        }
    }
}

舊代碼常見錯誤與修正

錯誤代碼問題修正
`rs.getString("Content")`JDBC 驅動預設截斷 (如 4000 字元)、大文本 OOM、編碼轉換錯誤`rs.getClob("Content").getCharacterStream()` 流式讀取
`rs.getBytes("Content")`同樣全載入 Heap,二進制無編碼問題但 OOM 風險同在`rs.getBlob("Content").getBinaryStream()`
Base64 編碼存入 TEXT空間膨脹 33%、查詢/索引無效、雙重編解碼開銷**直接存二進制 `VARBINARY(MAX)`**,或啟用 `FILESTREAM`/`FileTable`

寫入大物件 (流式)

String sql = "INSERT INTO Documents (FileName, Content) VALUES (?, ?)";
try (Connection conn = DriverManager.getConnection(URL, USER, PASS);
     PreparedStatement ps = conn.prepareStatement(sql)) {
    ps.setString(1, fileName);
    // 關鍵:setCharacterStream / setBinaryStream + 長度
    try (FileReader fr = new FileReader(file)) {
        ps.setCharacterStream(2, fr, file.length()); // Clob
        // ps.setBinaryStream(2, new FileInputStream(file), file.length()); // Blob
        ps.executeUpdate();
    }
}

Base64 歷史包袱處理 (如原文場景)

若歷史數據已 Base64 存入 `TEXT`,讀取後解碼:

Clob clob = rs.getClob("Content");
try (Reader reader = clob.getCharacterStream();
     InputStream b64In = new ReaderInputStream(reader, StandardCharsets.US_ASCII); // Apache Commons IO
     InputStream decoded = Base64.getDecoder().wrap(b64In); // Java 8+ Base64
     OutputStream out = Files.newOutputStream(Paths.get(targetPath))) {
    decoded.transferTo(out); // 高效零拷貝
}

需依賴 `commons-io` 提供 `ReaderInputStream` 將 `Reader` 轉 `InputStream` 供 `Base64.Decoder.wrap()` 使用。

現代化建議

  1. **型別升級**:`TEXT`→`VARCHAR(MAX)`、`NTEXT`→`NVARCHAR(MAX)`、`IMAGE`→`VARBINARY(MAX)`
  2. **大文件外部化**:超 256KB 檔案用 **FILESTREAM** (檔案系統 + 事務一致性) 或 **FileTable** (Win32 API 直存取) 或 **雲儲存 (S3/Azure Blob) + DB 存 URL**
  3. **流式處理框架**:Spring `Resource`/`InputStreamResource`、Jakarta EE `Blob`/`Clob`、Hibernate `@Lob` + 流式讀寫
copyright © 萬盛學電腦網 all rights reserved