페이지 트리

 

 

 

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) 업데이트할 컬럼 정보

컬럼명

비고

DRIVER_NO

0

 

DRIVER_NAME

User Defin e

임의로 변경 가능.

(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) 업데이트할 컬럼 정보

컬럼명

비고

PRODUCT_NO

0

 

PRODUCT_NAME

S elf Matrix SQL

임의로 변경 가능.

ENABLED_FLAG

Y

 

PRODUCT_DESC

Matrix 제품 JDBC Driver

임의 변경 및 빈값 가능

(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) 신규 데이터베이스 정보를 추가한다.

 

항목

설명

비고

DB 별칭

Matrix JDBC Driver로 설정할 DB .

보고서 개발 시 DataSource Connection

 

서버명

MTXRPTY 선택

변경불가

제품명

MTX_PRODUCT에 추가한 항목 선택

변경불가

드라이버명

MTX_DRIVER에 추가한 항목 선택

변경불가

DB JNDI

J dbc :matrixfile://127.0.0.1:5000

IP:PORT는 임의 설정

DB 설명

[[DRIVER=com.matrix.Jdbc.FileDriver.FileDriver]]

변경불가

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

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

(예시)

 

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별 파일을 생성하여 저장한다

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

(3) 적용 방법

1-1. 디자이너에서 Grid 컴포넌트를 선택하여 Data Source 를 사용자가 직접 설정한 항목으로 지정하여 Grid Data 를 조회한다.

1-2. i-AUD grid에서 설정 할 수 있는 일부 기능을 지원한다.

-           G r id 페이징 , 항목별 필터 처리 기능

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

서울시 강남구 선릉로 433 세방빌딩 신관17층 (우)135-919

홈페이지 : http://www.bimatrix.co.kr

대표전화 : 02-561-4475 /  팩스 : 02-561-4479

Copyright © BI MATRIX, Co., Ltd. All rights reserved.