LOB 데이터 처리

개요

JDBC 표준에서는 LOB 데이터를 처리하기 위해 두 가지 타입을 제공합니다. BLOB(바이너리 데이터)와 CLOB(문자열 데이터)가 이에 해당합니다. tbJDBC에서는 이 두 가지 타입을 효율적으로 처리하기 위해 지시자(locator)라는 개념을 사용합니다.

일반적으로 LOB 데이터는 데이터베이스에 저장된 후에 지시자를 생성하여 데이터가 저장된 위치를 찾아 갈 수 있도록 합니다. 따라서 사용자는 이 지시자만을 사용하여 필요할 때마다 LOB 데이터를 읽고 쓸 수 있 다. 이 때문에 시스템 성능을 향상시키는 데 도움을 줄 수 있습니다.

다음은 tbJDBC에서 제공하는 LOB 클래스입니다.

• com.tmax.tibero.jdbc.TbBlob

• com.tmax.tibero.jdbc.TbClob

LOB 지시자

1. LOB 지시자 얻어오기

JDBC 표준에서 제공하는 ResultSet 객체나 CallableStatement 객체의 메소드를 이용하여 LOB 지시자를 얻어올 수 있습니다.

• ResultSet 객체

다음은 ResultSet 객체를 이용하여 LOB 지시자를 얻어오는 예입니다.

• CallableStatement 객체

다음은 CallableStatement 객체를 이용하여 LOB 지시자를 얻어오는 예입니다.

LOB 지시자 넘겨주기

JDBC 표준에서 제공하는 PreparedStatement 객체나 CallableStatement 객체의 메소드를 이용하여 LOB 지시자를 넘겨줄 수 있습니다.

• PreparedStatement 객체

다음은 PreparedStatement 객체를 이용하여 LOB 지시자를 넘겨주는 예입니다.

• CallableStatement 객체

다음은 CallableStatement 객체를 이용하여 LOB 지시자를 넘겨주는 예입니다.

LOB 데이터 읽고 쓰기

LOB 지시자를 얻어오면 JDBC 표준에서 제공하는 API를 이용하여 데이터를 읽고 쓸 수 있습니다. LOB 데이 터는 보통 Byte 배열이나 스트림 형태로 읽어올 수 있는데, 일반적인 스트림 형태와 달리 데이터베이스 서 버 내부에 데이터가 있으므로 연결이 유지되는 한 언제든지 접근할 수 있습니다.

JDBC 표준에서는 LOB 데이터를 읽고 쓸 수 있도록 다음과 같은 API를 제공합니다.

• InputStream Clob.getAsciiStream()

• Reader Clob.getCharacterStream()

• String Clob.getSubString()

• OutputStream Clob.setAsciiStream()

다음은 LOB 데이터를 읽는 예입니다.

다음은 LOB 데이터를 쓰는 예입니다.

위의 예에서 OutputStream이나 Writer 객체는 데이터를 쓸 때마다 데이터베이스에 직접 전송되므로 별도 의 UPDATE 문장을 실행할 필요가 없습니다. 하지만 LOB 자체는 트랜잭션 범위에 포함되므로 반드시 커밋을 수행해야 데이터베이스에 최종적으로 반영됩니다.

임시 LOB

tbJDBC에서는 대용량 데이터를 LOB 형태로 저장하기 위해 임시 LOB을 제공합니다. 단, 이 대용량 데이터 는 테이블에 저장되지 않습니다.

이를 위해 다음과 같은 메소드를 제공합니다.

• Connection.createBlob() return Blob

• Connection.createClob() return Clob

• Connection.createNClob() return NClob

임시 LOB을 사용하여 저장한 데이터는 임시 테이블 스페이스에 저장됩니다. 이 영역에 저장된 데이터가 더 는 필요하지 않게 되면, 사용자는 반드시 이것을 해제해야 합니다. 그렇지 않으면 이 영역의 데이터는 계속 남아있게 됩니다.

임시 LOB는 LOB 컬럼의 데이터를 바인딩할 때 주로 사용합니다. 예를 들면 다음과 같습니다.

위에서 나열한 메소드들은 JDBC 표준 API들로 일부 메소드는 Java 버전에 따라 사용할 수 없는 것들이 존재합니다. 이를 위해 tbJDBC에서는 별도로 다음과 같은 구현 메소드들을 제공하고 있습니다. 이 메소드들을 이용할 경우 다른 JDBC와의 호환성은 떨어지지만 tbJDBC에 한하여 Java 버전에 관계 없이 사용할 수 있 는 장점이 있습니다.

• TbConnection.createTbBlob() return TbBlob

• TbConnection.createTbClob() return TbClob

• TbConnection.createTbNClob() return TbNClob

Tibero 4.0 SP1까지의 tbJDBC에서는 구현 메소드를 다음과 같은 형태로 제공하였으나, 호환성에 문제가 있어 폐기(deprecated)하고 위의 메소드들로 대체되었습니다.

• static TbBlob.createTemporary(Connection conn) return TbBlob

• static TbClob.createTemporary(Connection conn) return TbClob

• static TbClob.createTemporaryNClob(Connection conn) return TbClob

API 목록

표준 API

LOB와 관련된 표준 API의 정보는 JDBC 표준 문서를 참고합니다.

확장 API

tbJDBC에서는 LOB와 관련된 API로 BLOB, CLOB, NCLOB 메소드를 추가로 제공합니다.

CONNECTION API

TbConnection 클래스에서는 다음과 같은 API를 추가로 제공합니다.

BLOB API

TbBlob 클래스에서는 다음과 같은 API를 추가로 제공합니다.

CLOB API

TbClob 클래스에서는 다음과 같은 API를 추가로 제공합니다.

NCLOB API

TbNClob 클래스에서는 다음과 같은 API를 추가로 제공합니다.