1. DBeaver#

이 장은 DBeaver 개요, 시스템 요구사항, 설치 및 제거 방법, 그리고 Altibase 데이터베이스 시스템 연결하는 방법에 대해 소개한다.

개요#

DBeaver Community는 DBeaver 사에서 제공하는 무료 데이터베이스 툴이다. 80가지 이상의 데이터베이스 시스템에 연결하여 데이터 조작, 데이터베이스 객체 관리 기능, SQL 편집기, SQL Plan 뷰어, 데이터베이스 연결 세션 모니터링 등의 기능을 제공한다.

Altibase에서 제공하는 DBeaver 패키지는 기존 호환되는 데이터베이스 시스템과 더불어 Altibase에 연결 및 앞서 기술한 다양한 기능들을 제공한다.

DBeaver의 상세 매뉴얼은 DBeaver Desktop Documentation를 참조한다.

시스템 요구사항#

소프트웨어 요구 사항#

호환되는 DBeaver 버전#

Altibase와 호환되는 DBeaver 버전을 열거한다.

DBeaver 23.3.3 이상

호환되는 Altibase 서버 버전#

DBeaver와 호환되는 Altibase 서버 버전을 열거한다.

Altibase 7.1.0 이상

설치 및 제거#

DBeaver 공식 다운로드 사이트에서 내려받을 수 있다. 자세한 설치 및 제거 방법은 해당 사이트의 설명을 참조한다.

Altibase 데이터베이스 시스템 연결#

1. 새 데이터베이스 연결#

[ 데이터베이스 ] → [ 새 데이터베이스 연결 ]

connect1

2. Altibase database 선택#

All 또는 SQL에서 Altibase를 선택 후 [ Next > ] 버튼을 클릭한다.

connect2

3. 데이터베이스 접속 정보 입력#

Host, Port, Database/Schema, Username, Password에 연결하고자 하는 데이터베이스 접속 정보를 입력한다.

connect3

데이터베이스 접속 정보 입력을 마치고 [Finish] 를 클릭하면, Database 목록에 입력한 데이터베이스 연결 정보(mydb)가 추가된다.

auto1

4. JDBC 드라이버 파일 다운로드#

처음 Altibase 연결 정보를 등록한 경우, Altibase JDBC 드라이버 파일이 있어야 연결이 가능하다. 인터넷에 접속 가능한 환경인 경우, '4.1 JDBC 드라이버 다운로드'를 참고한다. 인터넷 접속이 불가능한 환경이거나 수동으로 JDBC 드라이버를 등록하려는 경우는 '4.2 수동으로 JDBC 드라이버 등록' 을 참고한다.

4.1 JDBC 드라이버 다운로드#

Database Navigator 에 추가된 Altibase 연결 정보(mydb)를 더블 클릭하면, Altibase의 JDBC 드라이버 파일을 다운로드 할 수 있는 Driver settings 창이 열린다. 다운로드하려는 JDBC 드라이버를 선택한 다음, [Download]를 클릭한다.

다운로드가 완료되면 데이터베이스 연결이 수행된다. 이 작업은 최초 한번만 수행하면 된다.

4.2 수동으로 JDBC 드라이버 등록#

사용자가 JDBC 드라이버를 직접 등록할 수 있다. 이를 위해, 데이터베이스 접속 정보 입력 창 하단 [Driver Settings] 버튼을 클릭한다.

connect4

Libraries 탭의 [Add File]을 클릭한다.

connect5

사용할 Altibase JDBC 드라이버 파일을 선택하여 추가한 후 [Classpath] 버튼을 클릭한다.

connect6

Global libraries 에 사용할 JDBC 드라이버 파일 위치를 추가하고 [Apply and Close] 를 클릭한다.

connect7

설정이 완료되었다면 [OK] 버튼을 클릭하고, 마지막으로 [Finish] 버튼을 클릭하여 설정을 완료한다.

5. 데이터베이스 연결 완료#

Database Navigator 탭에서 등록된 데이터베이스 연결 정보 목록을 확인할 수 있다.

목록의 데이터베이스 연결 정보를 더블 클릭하면 연결을 시도하며, 성공적으로 연결되면 아이콘에 초록색 체크 표시가 나타난다.

connect9

필요시 mydb 데이터베이스 연결 정보 이름을 원하는 이름으로 변경할 수 있다.

connect10

FAQ#

LOB 타입 데이터 조회가 안됩니다.#

DBeaver는 Auto-Commit이 기본값으로 설정되어 있다. Altibase LOB 타입 데이터를 조회하기 위해서는 커밋 모드를 Auto-Commit에서 Manual Commit으로 변경해야 한다.

다음과 같이 세 가지 방법으로 해당 설정을 변경할 수 있다.

툴바에서 버튼 아이콘을 눌러 Manual Commit으로 전환한다.

버튼 아이콘 커밋 모드

Auto-Commit (자동 커밋)

Manual Commit (수동 커밋)
커밋 모드 목록에서 Manual Commit을 선택한다.
메뉴에서 Auto-commit 기본 설정 옵션을 해제한다. 이 설정을 적용하려면 데이터베이스에 다시 연결을 해야한다.

[ 윈도우 ] → [ 설정 ]

[ 연결 ] → [ 연결 유형 ]에서 "Auto-commit by default" 체크 박스를 해제

[ Apply and Close ] 클릭 → 데이터베이스에 재접속

Note

Manual Commit 모드에서는 테이블 수정 시 반드시 명시적으로 커밋 또는 롤백해야 한다.
commit5

참고: DBeaver Documentation-Auto and manual commit modes

SYSTEM_ 스키마가 보이지 않습니다.#

DBeaver는 기본값으로 시스템 객체를 보여주지 않도록 설정되어 있다. SYSTEM_ 스키마를 보기 위해서는 "Show system objects" 옵션을 설정해야 한다.

데이터베이스 연결의 [ Connection View ] → [ Show system objects ] 옵션을 선택한다.

sysschema1

데이터베이스에 다시 연결하면 SYSTEM_ 스키마의 테이블과 뷰를 볼 수 있다.

sysschema2

sysschema3

객체에 대해 정확하지 않은 DDL이 출력됩니다.#

정확한 Altibase 객체의 DDL을 조회하기 위해서는 반드시 SYS 계정으로 DBMS_METADATA 패키지를 설치해야 한다.

DBMS_METADATA 패키지를 설치하기 위해서는 SYS 계정으로 Altibase에 접속하여 아래 구문을 수행해야 한다.

$ cd $ALTIBASE_HOME
$ is -f ./packages/dbms_metadata.sql
$ is -f ./packages/dbms_metadata.plb

예)

다음은 큐 객체 Q1을 생성하는 구문 예제이다.

CREATE QUEUE q1(40) MAXROWS 100000;

위 구문을 수행하고 DBeaver에서 Q1 객체의 DDL을 조회하면 결과가 아래와 같이 비정상적으로 출력될 수 있다.

ddl1

정확한 DDL 구문 출력을 위해 DBMS_METADATA 패키지를 설치한다.

$ cd $ALTIBASE_HOME
$ is -f ./packages/dbms_metadata.sql
$ is -f ./packages/dbms_metadata.plb

설치 후 DBeaver에서 대상 Altibase에 다시 연결하면, Q1 객체의 정확한 DDL을 조회할 수 있다.

ddl2

쿼리 실행 계획을 어디서 확인해야 하나요?#

쿼리 실행 계획은 SQL script 창에 쿼리를 입력한 후, Explain Execution Plan 아이콘을 클릭하여 확인할 수 있다.

연결된 데이터베이스의 [ SQL 편집기 ] → [ 새 SQL 편집기 ] 를 클릭한다.

excplan1

SQL Script 창에 쿼리를 입력 후 "Explain Execution Plan" 아이콘을 클릭하면 쿼리 실행 계획을 확인할 수 있다.

excplan2

쿼리 실행 계획의 기본 옵션 값은 Explain Plan Only이다.

쿼리 실행 계획을 EXPLAIN_PLAN = ON으로 수행하고 싶습니다.#

DBeaver Altibase Plugin에서는 각각의 접속마다 Explain plan을 ONLY 또는 ON으로 지정할 수 있다. 기본값은 ONLY이다.

Explain plan 설정값을 변경하는 방법은 다음의 두 가지가 있다.

접속된 데이터베이스의 설정값을 변경한다.

데이터베이스 연결을 클릭한다.

[ 파일 ] → [ 설정 ]

Altibase settings → Datasource settings → Explain Plan 설정 값을 선택한다.
스크립트 창에서 Preferences를 호출한다.

스크립트 창의 Preferences 호출 버튼을 클릭한다.

Altibase settings → Datasource settings → Explain Plan 설정 값을 선택한다.

서버 출력(PSM PRINTLN 출력) 내용을 보고 싶습니다.#

서버 출력 내용을 보기 위해서는 연결된 데이터베이스의 "Enable DBMS Output" 옵션을 설정해야 한다.

데이터 베이스 연결을 클릭한다.

println1

[ 파일 ] → [ 설정 ]

println2

[ Altibase settings ] → [ Datasource settings ] → 기타에서 "Enable DBMS Output"을 선택한다.

println3

설정을 변경한 데이터베이스 연결의 SQL script 창에서 서버 출력 내용보기 버튼을 클릭한다. 이후 SQL문을 수행하면 서버 출력 내용이 Output 창에 출력된다.

println4

DATE 타입의 마이크로 초가 보이지 않습니다.#

DBeaver의 Timestamp 출력 형식은 yyyy-MM-dd HH:mm:ss.SSS 로 밀리 세컨드 초(소수점 뒤 3자리)까지 표현되는 반면, Altibase의 DATE 타입은 마이크로 초(소수점 뒤 6자리)까지 표현할 수 있다.

DBeaver 기본 설정에 따른 DATE 타입 데이터 조회 결과는 아래와 같다.

datetype1

DATE 타입을 마이크로 초 단위까지 출력하기 위해서는 DBeaver의 데이터 타입 설정을 변경해야 한다. 설정 변경 위치는 다음과 같다.

[ 윈도우 ] → [ 설정 ]

datetype2

[ 편집기 ] → [ 데이터 편집기 ] → [ 데이터 포맷 ] → [ Datasource settings ]을 클릭한다.

datetype3

설정을 변경할 데이터베이스 연결을 선택하고 [ Select ]를 클릭한다.

datetype4

DATE 타입을 마이크로 초까지 볼 수 있도록 설정을 변경하는 방법은 두 가지가 있다.

데이터 타입 Value Settings 변경

[ Datasource settings ] → [ Format ] 의 Type을 Timestamp로 설정하고 Value 값을 yyyy-MM-dd HH:mm.ss.SSSSSS로 변경 후 [ Apply and Close ]를 클릭한다.

DATE 타입 데이터를 조회하면 아래와 같이 0을 포함하여 소수점 뒤 6자리까지 고정된 자리수를 표시한다.
데이터 포맷 Disable date/time formatting 옵션 설정

[ Datasource settings ] → [ Settings ] 에서 "Disable date/time formatting" 옵션을 선택하고 [ Apply and Close ]를 클릭한다.

DATE 타입 데이터를 조회하면 아래와 같이 소수점 뒤 6자리까지 유효한 숫자를 표시한다.