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. |