CUBRID Manager 개발 튜터리얼
작성자: 오픈소스 개발자 최중연 (pcraft) 진행 순서
1. CUBRID 소개 및 설치
2. CUBRID MANAGER 소개
3. 개발 환경 구성
4. 아키텍처
5. 튜터리얼
6. CUBRID 도구 개발의 방향 1. CUBRID 소개 및 설치 1.1 인터넷 서비스를 위한 무료 DBMS 라이선스 모델
GNU GPL v2
DBMS ENGINE + = FREE
BSD
INTERFACE 1.2 주요 특징 인터넷 서비스에 최적화된 기능
Pagination Click Counter
Partition Query Plan Cache
Replication Query Result Cache
High Availability Java SP 1.2 주요 특징 Pagination
Pagination ROWNUM
FOR ORDERBY_NUM()
FOR GROUPBY_NUM() 1.2 주요 특징 Partition
HASH
Partition RANGE
LIST 1.2 주요 특징 Replication
Replication
•서버 분산을 통한 성능 향상 및 장애 발생 시 긴급 대처 •트랜잭션 로그 기반의 복제, 중단 없는 온라인 복제 •1:N의 복제 구성 지원 복제, 상태 관리 기능 지원 복제 1.2 주요 특징 High Availability
24 X 365
장애 발생 및 장애 복구 시 자동 절체를 통해 중단 없는 고가용성 서비스 제공 가능 1.2 주요 특징 Click Counter
SELECT INCR(col1) ...
Click Counter 1.2 주요 특징 Query Plan Cache / Query Result Cache
Query Plan Cache - 쿼리 컴파일 시간 단축 동일한 패턴의 쿼리 수행 시 질의 최적화기의 쿼리 컴파일 시간을 최소화 할 수 있도록 지원
Query Plan Cache - 쿼리 데이터 패치 시간 단축 같은 쿼리에 대해 질의 수행 과정 없이 캐쉬에 있는 결과를 이용 1.2 주요 특징 Java Stored Procedure
•SQL로 구현하지 못하는 복잡한 프로그램 로직 구현 •JDBC를 이용한 이기종 데이터베이스 쿼리 가능 •기존 Java 코드 및 개발 환경 재사용
Java Stored Procedure 1.3 지속적이고 안정적인 업데이트 CUBRID Engine Roadmap
(출처: CUBRID 개발 로드맵 문서) 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 1.4 CUBRID DBMS 설치 2. CUBRID MANAGER 소개 2.1 CUBRID Manager의 역할
Database Management User Management Space Management Schema Management Backup and Recovery Monitoring and Performance Tuning support Query editor and data management support 2.2 그림으로 보는 주요 기능 메인 화면 2.2 그림으로 보는 주요 기능 스키마 정보 조회 2.2 그림으로 보는 주요 기능 데이터 조회 2.2 그림으로 보는 주요 기능 실행계획 및 스키마 정보 조회 2.2 그림으로 보는 주요 기능 모니터링 화면 2.3 앞으로 개발해야할 기능들
Replication HA 지원 파티션 지원 SP 지원 보안 강화 SQL 포매팅 마음만 있다면 상태 모니터링 함께 할 일은 많이 있습니다!
버그 및 코드 개선 3. 개발 환경 구성 3.1 개발환경 소개 및 개발 언어 소개 개발환경
Eclipse 3.3 = + J2SE 1.5 + CUBRID 8.2.x + + Your passion 3.1 개발환경 소개 및 개발 언어 소개 개발언어
Java
RCP, SWT, JFace 3.2 Eclipse 기본 환경 구성 Eclipse 다운로드
http://www.eclipse.org/downloads/packages/release/europa/winter 3.2 Eclipse 기본 환경 구성 Eclipse 실행 3.2 Eclipse 기본 환경 구성 Subclipse Plugin 설치
Help - Software Updates - Find and Install... 3.2 Eclipse 기본 환경 구성 Subclipse Plugin 설치 3.2 Eclipse 기본 환경 구성 Subclipse Plugin 설치 3.2 Eclipse 기본 환경 구성 Propedit Plugin 설치 3.2 Eclipse 기본 환경 구성 Propedit Plugin 설치 3.3 CUBRID Manager 개발 사이트 소개 CUBRID Manager Dev Home 3.3 CUBRID Manager 개발 사이트 소개 CUBRID Manager Home 3.3 CUBRID Manager 개발 사이트 소개 포럼 3.3 CUBRID Manager 개발 사이트 소개 CUBRID Manager Home 3.3 CUBRID Manager 개발 사이트 소개 소스 저장소 3.3 CUBRID Manager 개발 사이트 소개 CUBRID 도구개발 카페 3.3 CUBRID Manager 개발 사이트 소개 큐브리드 공부하기 카페 3.4 소스 내려받기 소스 체크아웃 3.4 소스 내려받기 소스 체크아웃 3.4 소스 내려받기 소스 체크아웃 3.4 소스 내려받기 소스 체크아웃
https://dev.naver.com/svn/cubrid-manager/branches/RB-8.2.1 3.4 소스 내려받기 소스 체크아웃 3.4 소스 내려받기 소스 체크아웃 3.4 소스 내려받기 소스 체크아웃 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j) 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j) 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j) 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j)
https://dev.naver.com/svn/cubrid-manager/materials/dependentPlugin 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j) 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j) 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j) 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j)
org.apache.log4j 3.4 소스 내려받기 Eclipse Plugin 설치 (log4j)
eclipse/plugins에 org.apache.log4j_1.2.13.v200706111418.jar 복사 후 이클립스 재시동 3.5 빌드 및 실행 3.5 빌드 및 실행 3.5 빌드 및 실행 3.5 빌드 및 실행 3.5 빌드 및 실행
64bit Mac OSX에서 32bit JRE를 사용할 경우 3.5 빌드 및 실행 4. 아키텍처 4.1 서버 프로세스와 Manager 아키텍처
CUBRID Manager Client
RCP Application Interface Eclipse Plug-In Interface Multi-Language Package
Help Plug-in Logger Package
Common GUI Interface Chart Package
Bussiness Logic Interface
TCP/IP JDBC
CUBRID Manager Server Broker Server
cub_broker cub_cas cub_auto cub_js cub_broker cub_cas cub_server 4.2 컴포넌트 소개
com.cubrid.cubridmanager.app com.cubrid.cubridmanager.plugin RCP Application Interface Eclipse Plug-In Interface
Launcher
com.cubrid.cubridmanager.ui Common GUI Interface
UI
com.cubrid.cubridmanager.help Help Plug-in
Online Help system
com.cubrid.cubridmanager.core Bussiness Logic Interface
Core API 4.3 컴포넌트별 역할
SVN 주소 https://dev.naver.com/svn/cubrid-manager/branches/RB-8.2.1
Standalone application package - Launcher
Core API package - Task, Model, Business logic classes
Eclipse Plug-in package - Launcher
Common UI package - Standalone, Plug-in의 공통 UI (SWT / JFace) 4.4 컴포넌트별 패키지 구조 com.cubrid.cubridmanager.app , plugin package
com.cubrid.cubridmanager.app com.cubrid.cubridmanager.plugin
독립 실행 빌드 버전 Eclipse Plug-in 빌드 버전 4.4 컴포넌트별 패키지 구조 com.cubrid.cubridmanager.ui package 4.4 컴포넌트별 패키지 구조 com.cubrid.cubridmanager.core package 5. 튜터리얼 5.1 과제 제시 요구사항 접수
도구개발 카페에 올라온 의견
INSERT INTO table (col1, col2) VALUES (?, ?) + CSV 파일 5.2 스팩 정의
•측면 네비게이션의 테이블 폴더에서 컨텍스트 메뉴를 통해 대화창 접근
•SQL을 입력하고 CSV 파일을 선택
•컬럼 목록은 입력한 SQL의 컬럼 목록 기준(컬럼 목록이 없는 SQL은 에러처리)
•미리보기 테이블을 제공하여 SQL과 CSV 데이터의 매핑을 확인 (최대 10개만 출력)
•데이터 입력후 입력 건수를 유저에게 알림 5.2 스팩 정의 기능 접근 포인트 결정
측면 네비게이션의 테이블 폴더에서 컨텍스트 메뉴를 통해 대화창 접근 5.2 스팩 정의 SQL 입력 및 CSV 파일 입력
SQL 입력창
CSV 찾아보기 5.2 스팩 정의 미리보기 제공
•미리보기 테이블을 제공하여 SQL과 CSV 데이터의 매핑을 확인 •성능 문제로 미리보기는 최대 10개만 출력 •컬럼 목록은 입력한 SQL의 컬럼 목록 기준 (컬럼 목록이 없는 SQL은 에러처리) 5.2 스팩 정의 데이터 입력 결과창
데이터 입력후 입력 건수를 유저에게 알림 5.3 UI 설계 및 구현 질의 데이터 입력 대화창
CMTitleAreaDialog
Multi-line Text Field
Button - FileDialog
TableViewer Text Field - Editable Button - Preview Action
Dynamic Help system 5.3 UI 설계 및 구현 질의 데이터 입력 대화창
public class QueryDataInsertDialog extends CMTitleAreaDialog
com.cubrid.cubridmanager.ui.spi.dialog.CMTitleAreaDialog - 상단 제목 영역을 갖는 공통 Dialog UI 추상 클래스 - 동적 도움말 시스템을 제공
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.3 UI 설계 및 구현 Dialog UI 구현
public class QueryDataInsertDialog extends CMTitleAreaDialog
// "질의 데이터 입력" getShell().setText(Messages.titleQueryDataInsertDialog); // "질의 데이터 입력" setTitle(Messages.titleQueryDataInsertHeader); // "Prepared statement 유형의 SQL에 CSV 데이터를 제공하여 SQL을 실행할 수 있습니다." setMessage(Messages.titleQueryDataInsertHeaderMsg);
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.3 UI 설계 및 구현 Dialog UI 구현
public class QueryDataInsertDialog extends CMTitleAreaDialog
// SQL 입력폼 { Label lbl = new Label(parent, SWT.NONE); lbl.setText(Messages.lblSql); // "SQL" GridData gd = new GridData(SWT.FILL, SWT.FILL, false, false); gd.verticalAlignment = GridData.BEGINNING; lbl.setLayoutData(gd); } txtSql = new Text(parent, SWT.BORDER | SWT.MULTI | SWT.V_SCROLL); txtSql.setText(sql); { GridData gd = new GridData(SWT.FILL, SWT.FILL, true, false); gd.horizontalSpan = 3; gd.heightHint = 80; txtSql.setLayoutData(gd); }
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.3 UI 설계 및 구현 Dialog UI 구현
public class QueryDataInsertDialog extends CMTitleAreaDialog
// 입력파일 선택폼 new Label(parent, SWT.NONE).setText(Messages.lblCsvFile); // "입력 파일" txtFilename = new Text(parent, SWT.BORDER); txtFilename.setText(""); txtFilename.addModifyListener(new ModifyListener() { @Override public void modifyText(ModifyEvent event) { btnPreview.setEnabled(txtFilename.getText().length() > 0); } }); { GridData gd = new GridData(SWT.FILL, SWT.FILL, true, false); txtFilename.setLayoutData(gd); }
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.3 UI 설계 및 구현 Dialog UI 구현
public class QueryDataInsertDialog extends CMTitleAreaDialog
// CSV 찾아보기 버튼 Button btnSelectFile = new Button(parent, SWT.PUSH); btnSelectFile.setText(Messages.lblBrowse); // "찾아보기..." btnSelectFile.addSelectionListener(new SelectionAdapter() { public void widgetSelected(final SelectionEvent e) { FileDialog dlgFile = new FileDialog(getShell(), SWT.OPEN); dlgFile.setFilterExtensions(new String[] { "*.csv" }); String filepath = dlgFile.open(); if (filepath != null) { txtFilename.setText(filepath); } } });
// 미리보기 버튼 btnPreview = new Button(parent, SWT.PUSH); btnPreview.setText(Messages.lblPreview); // "미리보기" btnPreview.setEnabled(true);// TODO btnPreview.addSelectionListener(new SelectionAdapter() { public void widgetSelected(final SelectionEvent e) { doPreview(); } }); com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.3 UI 설계 및 구현 Dialog UI 구현
public class QueryDataInsertDialog extends CMTitleAreaDialog
// 미리보기 테이블 tbvPreviewer = new TableViewer(parent, SWT.BORDER); { GridData gd = new GridData(SWT.FILL, SWT.FILL, true, false); gd.horizontalSpan = 4; gd.heightHint = 120; tbvPreviewer.getTable().setLayoutData(gd); }
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.3 UI 설계 및 구현 CSV 파일 선택 대화창
org.eclipse.swt.widgets.FileDialog
FileDialog dlgFile = new FileDialog(getShell(), SWT.OPEN); dlgFile.setFilterExtensions(new String[] { "*.csv" }); String filepath = dlgFile.open(); if (filepath != null) { ... } 5.3 UI 설계 및 구현 Action 클래스 작성
public class QueryDataInsertAction extends SelectionAction
com.cubrid.cubridmanager.ui.spi.action.SelectionAction
public static final String ID = QueryDataInsertAction.class.getName();
public QueryDataInsertAction(Shell shell, String text, ImageDescriptor icon)
public boolean allowMultiSelections()
public boolean isSupported(Object obj)
public void run()
소스파일 참조 com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertAction.java 5.3 UI 설계 및 구현 네비게이션에 컨텍스트 메뉴 추가
com.cubrid.cubridmanager.ui.spi.ActionBuilder
private IAction queryDataInsertAction = null;
...
public void makeActions(IWorkbenchWindow window) { ...
queryDataInsertAction = new QueryDataInsertAction(window.getShell(), "질의 데이터 입력", CubridManagerUIPlugin.getImageDescriptor("icons/action/table_record_insert.png")); ActionManager.getInstance().registerAction(queryDataInsertAction);
... }
질의 데이터 입력 Dialog 출력을 위한 액션을 초기화
com.cubrid.cubridmanager.ui.spi.ActionBuilder.java 5.3 UI 설계 및 구현 네비게이션에 컨텍스트 메뉴 추가
com.cubrid.cubridmanager.ui.spi.ActionManager
public void setActionsMenu(IMenuManager manager) { ...
case TABLE_FOLDER: addActionToManager(manager, getAction(NewTableAction.ID)); addActionToManager(manager, getAction(QueryDataInsertAction.ID)); break; ... }
네비게이션의 테이블 폴더 영역의 컨텍스트 메뉴에 ActionBuilder에 초기화된 액션을 바인딩
com.cubrid.cubridmanager.ui.spi.ActionManager.java 5.4 기능 구현 QueryDataInsertDialg 주요 메소드
public QueryDataInsertDialog(Shell shell, DatabaseInfo dbInfo)
•대화창의 생성자
•DatabaseInfo 객체를 받아서 대상 테이블의 컬럼 정보를 확인하고 데이터베이스 접속 객체(Connection)를 초기화하기 위해 사용
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.4 기능 구현 QueryDataInsertDialg 주요 메소드
protected Control createDialogArea(Composite parent)
•대화창 제목 초기화
•대화창 헤더 영역 제목 및 설명 초기화
•동적 도움말 초기화
•parent 하부의 컴포지트 초기화
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.4 기능 구현 QueryDataInsertDialg 주요 메소드
protected void createButtonsForButtonBar(Composite parent)
•대화창 하단 버튼 초기화
Action
protected void buttonPressed(int buttonId) com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.4 기능 구현 QueryDataInsertDialg 주요 메소드
private void createForm()
•대화창의 각종 폼을 생성하고 초기화
•각종 버튼에 대한 액션 정의
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.4 기능 구현 QueryDataInsertDialg 주요 메소드
private boolean validate()
•입력폼에 대한 검증 수행
•입력 오류나 누락이 있을 경우 메시지 대화창 출력하고 false를 반환
•입력폼 검증이 성공하면 true를 반환
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.4 기능 구현 QueryDataInsertDialg 주요 메소드
private void doPreview()
•CSV 데이터를 로드하고 SQL에 입력된 컬럼명과 바인딩하여 샘플 10건 출력
•CSV 데이터 로드 루틴을 수행 (단, 테이블에 데이터 입력은 없음)
•CSV는 com.cubrid.cubridmanager.core.cubrid.table.CSVReader를 활용
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.4 기능 구현 QueryDataInsertDialg 주요 메소드
private boolean importData()
•CSV 데이터를 로드하고 건별로 importRowData() 메소드를 호출
•ITask 인터페이스와 JDBC 클래스를 이용하여 Batch insert를 위한 초기화 수행
•최종 입력 결과 출력 메시지 대화창 출력
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.4 기능 구현 QueryDataInsertDialg 주요 메소드
private void importRowData()
•데이터 1건별 대상 테이블에 기록
•PreparedStatement에 입력할 컬럼별 데이터 타입을 SchemaInfo 클래스의 정보를 바탕으로 결정하고 입력 메소드 (setXxx())를 결정
setInt(), setString(), ...
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertDialog.java 5.5 국제화 메시지
com.cubrid.cubridmanager.ui.cubrid.table.Messages
public class Messages extends NLS { ... public static String titleQueryDataInsertDialog; ... }
Messages_ko_KR.properties Messages.properties
titleQueryDataInsertDialog=질의 데이터 입력 titleQueryDataInsertDialog=Query Data Insert ......
메시지 사용 예:
String titleMsg = Messages.titleQueryDataInsertDialog; com.cubrid.cubridmanager.ui.cubrid.table.Messages.java 5.6 동적 도움말 구현 메타정보 추가
com.cubrid.cubridmanager.help/dynamicHelp.xml
com.cubrid.cubridmanager.help.CubridManagerHelpContextIDs
public static final String queryDataInsert = PREFIX + ".queryDataInsert";
com.cubrid.cubridmanager.ui.cubrid.table.action.QueryDataInsertAction
getHelpSystem().setHelp(parentComp, CubridManagerHelpContextIDs.queryDataInsert); 5.6 동적 도움말 구현 동적 도움말 HTML 작성
com.cubrid.cubridmanager.help/html/manager/manager_query_data_insert.htm
...
HTML
질의 데이터 입력
질의 데이터 입력 설명
5.6 동적 도움말 구현 동적 도움말 출력 화면 5.7 완료 및 테스트테스트 테이블 생성:
CREATE TABLE "athlete2"( "code" integer PRIMARY KEY, "name" character varying(40) NOT NULL, "gender" character(1), "nation_code" character(3), "event" character varying(30) );
SQL:
INSERT INTO athlete2 (code, name, gender, nation_code, event) VALUES (?, ?, ?, ?, ?) 입력파일: athlete2.csv 6. CUBRID 도구개발의 방향 6.1 DBMS 관리도구
Replication 관리 기능
HA 관리 기능
Partition 관리 기능
CORE API의 독립 패키지
Shell 유틸리티의 역할을 100% 대체
최고의 CUBRID DBMS Management 도구 구현 플랫폼화하여 개별 기업의 환경에 맞는 커스터마이징 환경 제공 6.2 개발자 도구
Query 작성 및 실행 (자동생성포함)
Stored Procedure 개발 및 설치
실행계획 튜닝 및 히스토리 관리
? 편리한 데이터 조회 및 편집
Query 작성, 튜닝, 데이터 조회 및 편집만을 전문으로 하는 도구 6.3 모니터링 도구
개별 DBMS의 통합 모니터링 지원
Query 처리 성능 및 버퍼 사용량의 시각적 제공
브로커 성능 통합 관리
? 리포팅 기능
CUBRID 통합 모니터링 도구 Thanks.
?!