Matrix_JDBC_DRIVER_적용가이드.docx

Matrix JDBC Driver 사용 가이드

2 021 년 02 월 01 일

㈜ 비아이매트릭스 기술연구소

01. Matrix JDBC Driver란

  (1) i-AUD 보고서 개발 시 Data Source 의 Connection 을 DB 연결이 아닌 Matrix 서버에 연결하여 사용자가 작성한 Data 의 내용을 JDBC 형식으로 조회 하도록 지원

Re sult Set 형식으로 조회 및 표현 >> 보고서 개발 시 DB 에 접속하여 Data 로 사용할 값을 직접 넣지 않고 보고서의 Data Source 에서 직접 Data 생성 및 핸들링 가능

1. 실행 가능한 형식(지시자)

(1) @@CSV

CSV 파일 형식으로 구분자 콤마( ,) 를 사용하여 값을 설정

(예시)

( 2 ) @@TXT

     Text로 작성하여 Grid Data 의 값을 설정 . 구분자는 TAB

( 예시)

( 3 ) @@FILE

     Grid Data로 사용할 파일의 경로를 직접 삽입하여 사용.

( 예시)

( 4 ) @@URL

     Grid Data로 사용할 값을 URL 경로를 통해 가져와 사용.

단 , 제약 사항으로 해당 URL 경로의 Data 는 CSV 형식으로 되어 있어야함.

-           해당 기능은 현재 개발 예정 . 21 년 상반기 중으로 배포 예정.

(2) 타 데이터 시스템 (SAP RFC , SPlunk 등)과 Matrix 서버와 연동 기능

- 각 연동하고자 하는 시스템의 연동 interface 에 맞춰 custom 개발 , JDBC 형식으로 지원 가능.

02. 설정 방법

1. Repository DB에 정보를 업데이트 한다.

(1 -1 ) 테이블명 : MTX_DRIVER

(1-2) 업데이트할 컬럼 정보

(1-3) insert 문 예시 ( 각 R epository D B 의 종류에 따라 insert 쿼리문 변경)

INSERT INTO MTX_DRIVER( DRIVER_NO, DRIVER_NAME) VALUES (0, 'User Define')

(2 -1 ) 테이블명 : MTX_ PRODUCT

(2-2) 업데이트할 컬럼 정보

(2-3) insert 문 예시 ( 각 R epository D B 의 종류에 따라 insert 쿼리문 변경)

INSERT INTO MTX_ PRODUCT ( PRODUCT_NO , PRODUCT_NAME , ENABLED_FLAG , PRODUCT_DESC ) VALUES (0, 'Self Matrix SQL', ‘Y’, ‘Matrix 제품 JDBC Driver’)

2. i-Mgt에 접속하여 데이터베이스를 추가한다.

(1) 자원관리 – 데이터베이스관리 클릭

(2) 신규 버튼을 클릭한다.

(3) 신규 데이터베이스 정보를 추가한다.

-           위 항목에 대해서는 필수 설정

-           추가적인 나머지 항목은 사용자가 임의로 작성 또는 안해도 무방함.

(예시)

3. Matrix 서버의 lib 파일을 추가한다.

(1) WEB_ROOT_PATH/WEB-INF/ lib/matrix_jdbc_driver-1.0.0.0.jar 파 일을 추가한다.

- 신규 라이브러리 파일은 최신 패키지 또는 패치 파일로 QA 팀에 문의.

- 개별로 해당 jar파일만 받아서 위 경로에 추가한 후에 기능 적용 가능

(2) 추가한 후 Matrix 서버를 재 기동 한다.

4. i -AUD 디자이너에서 Data Source 를 Matrix JDBC Driver를 통해 개발한다.

(1) 아래 예시 캡쳐 화면을 통해 참고하여 SQL Text 화면에 작성한다.

1-1. 첫번째 라인 : Matrix JDBC Driver에서 지원하는 지시어를 작성

-           @@FILE , @@CSV , @@TXT ( 현재 version 1.0.0.0 에서 가능)

-           @@URL 지시어는 개발 예정이며 2021 년 상반기에 배포 예정임.

1-2. 두번째 라인

-           @@ FILE : 파일 경로를 작성 . 단 파일 경로에 괄호가 들어가면 안됨 . 추후 보완예정

-           @@CSV , @@TXT : column 의 스키마 항목 정의 (header 정의)

1-2. 세번째 라인

-           @@ CSV , @@TXT : grid data 로 사용할 값을 정의

(2) 설정 하는 방법

2 -1. 작성한 경로에 위치한 파일을 읽어서 Data set 형식으로 변환. 결과를 추출하여 보여준다 .

2-2. 지시어에 해당하는 확장자 파일 형태로 설정한 값을 작성하여 저장한다.

- report_path/FILE_DATA_BASE 아래에 Data Source별 파일을 생성하여 저장한다