2. 설치 및 설정

설치

Altibase 서버 설치

먼저 Altibase 8.1.0.0.1 서버를 설치한다.

Altibase Document Access Java API를 사용하기 위해서는 라이브러리 설치와 관련 데이터베이스 설정(메타테이블, 프로시저, 사용자 계정 생성)이 필요하다.

• 함수 기반 인덱스를 사용하려면 아래의 프로퍼티 설정이 필요하다.

• Altibase 서버의 프로퍼티 설정 파일(altibase.properties)에 아래의 프로퍼티 설정을 추가한 다음, 서버를 재시작 해야한다.

  QUERY_REWRITE_ENABLE =1
  

라이브러리 설치

Gradle을 통한 설치

Maven 저장소에서 의존성을 추가하여 설치한다.

dependencies {
    implementation 'com.altibase:document-access-java:1.0.0'
}

알티베이스 support 페이지를 통한 설치

Altibase Document Access Java API용 압축 파일(document-access-java-1.0.0-ALL.zip)을 직접 다운로드하여 압축 해제하여 설치한다.

파일명: document-access-java-1.0.0-ALL.zip

메타 테이블 및 프로시저 생성

관련 메타테이블 및 프로시저를 생성하기 위해서는 스크립트를 이용하거나 API(DatabaseInstaller.initializeDatabase)를 이용해서 생성하는 방법이 있다. 작업이 완료되면 아래의 항목이 생성된다.

• kada_api_admin 계정
• collection_metadata 테이블
• DBMS_KADA 패키지 (5개 프로시저)

방법 1: install.sh 또는 install.bat를 통한 설정

# Linux/Mac
cd scripts/database/java
./install.sh

# Windows
cd scripts\database\java
install.bat

방법 2: API를 통한 설정

Java 애플리케이션 내에서 DatabaseInstaller.initializeDatabase() 메서드를 호출하여 설정할 수도 있다. 보안을 위해 비밀번호는 환경 변수를 통해 전달하는 방식을 권장한다.

필수 환경 변수:

• KADA_ALTIBASE_SYS_PASSWORD: SYSDBA 계정 비밀번호
• KADA_API_ADMIN_PASSWORD: 생성할 API 관리자 (kada_api_admin) 계정 비밀번호

import com.altibase.document.installer.DatabaseInstaller;

public class DatabaseSetup {
    public static void main(String[] args) {
        // 비밀번호는 환경 변수(KADA_ALTIBASE_SYS_PASSWORD, KADA_API_ADMIN_PASSWORD)에서 읽어옴
        String url = "jdbc:Altibase://localhost:20300/mydb";

        try {
            boolean success = DatabaseInstaller.initializeDatabase(url);
            if (success) {
                System.out.println("데이터베이스 설치 완료");
            } else {
                System.out.println("데이터베이스가 이미 설치되어 있습니다.");
            }
        } catch (Exception e) {
            System.err.println("설치 실패: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Important

kada_api_admin계정이 생성되면, KADA_ROLE 권한을 부여해야 한다.

GRANT KADA_ROLE TO <your_db_user>;

제거

설치된 메타테이블 및 저장 프로시저, 관련 계정을 제거 할 수 있다.

Caution

이 작업을 수행하면 모든 문서 데이터와 컬렉션이 영구적으로 삭제된다.

방법 1: 스크립트를 통한 제거

# Linux/Mac
cd scripts/database/java
./uninstall.sh

# Windows
cd scripts\database\java
uninstall.bat

방법 2: API를 통한 제거

Java 애플리케이션 내에서 DatabaseUninstaller.uninstallDatabase() 메서드를 호출하여 제거할 수 있다.

필수 환경 변수:

• KADA_ALTIBASE_SYS_PASSWORD: SYS (DBA) 계정 비밀번호

import com.altibase.document.installer.DatabaseUninstaller;

public class DatabaseCleanup {
    public static void main(String[] args) {
        // 비밀번호는 환경 변수(KADA_ALTIBASE_SYS_PASSWORD)에서 읽어옴
        String url = "jdbc:Altibase://localhost:20300/mydb";

        try {
            boolean success = DatabaseUninstaller.uninstallDatabase(url);
            if (success) {
                System.out.println("데이터베이스 제거 완료");
            }
        } catch (Exception e) {
            System.err.println("제거 실패: " + e.getMessage());
            e.printStackTrace();
        }
    }
}