Java용 Amazon QLDB 드라이버

원장의 데이터로 작업하려면 AWS에서 제공하는 드라이버를 사용하여 Java 애플리케이션에서 Amazon QLDB에 연결할 수 있습니다. 다음 주제에서는 Java용 QLDB 드라이버를 시작하는 방법에 대해 설명합니다.

주제

• 드라이버 리소스
• 사전 조건
• 기본 AWS 보안 인증 정보 및 리전 설정
• 설치
• 빠른 시작 자습서
• Cookbook 참조

드라이버 리소스

Java 드라이버가 지원하는 기능에 대한 자세한 정보는 다음 리소스를 참조하십시오.

• API 참조: 2.x, 1.x

• 드라이버 소스 코드(GitHub)

• 샘플 애플리케이션 소스 코드(GitHub)

• 원장 로더 프레임워크(GitHub)

• Amazon Ion 코드 예제

사전 조건

Java용 QLDB 드라이버를 시작하기 전에 다음을 수행해야 합니다.

1. Amazon QLDB 액세스의 AWS 설정 지침을 따르십시오. 다음 내용이 해당됩니다.

   1. AWS에 가입합니다.

   2. 적절한 QLDB 권한을 가진 사용자를 생성합니다.

   3. 개발을 위한 프로그래밍 방식 액세스 권한을 부여합니다.

2. 다음을 다운로드하고 설치하여 Java 개발 환경을 설정합니다.

   1. Java SE 개발 키트 8(예: Amazon Corretto 8)

   2. (선택 사항) Eclipse 또는 IntelliJ와 같은 Java 통합 개발 환경(IDE)을 선택할 수 있습니다.

3. 기본 AWS 보안 인증 정보 및 리전 설정별로 AWS SDK for Java에 대한 개발 환경을 구성합니다.

그런 다음 전체 자습서 샘플 애플리케이션을 다운로드하거나 Java 프로젝트에 드라이버만 설치하고 단축 코드 예제를 실행할 수 있습니다.

• 기존 프로젝트에 QLDB 드라이버와 AWS SDK for Java를 설치하려면 설치로 이동하세요.

• 프로젝트를 설정하고 원장에 대한 기본 데이터 트랜잭션을 보여주는 단축 코드 예제를 실행하려면 빠른 시작 자습서를 참조하십시오.

• 전체 자습서 샘플 애플리케이션에서 데이터 및 관리 API 작업에 대한 보다 심층적인 예제를 실행하려면 Java 자습서를 참조하십시오.

기본 AWS 보안 인증 정보 및 리전 설정

QLDB 드라이버와 기본 AWS SDK for Java를 사용하려면 런타임 시 애플리케이션에 AWS 보안 인증을 제공해야 합니다. 이 설명서의 코드 예제에서는 AWS SDK for Java 2.x 개발자 안내서의 보안 인증 정보 및 리전 설정에 설명된 대로 AWS 보안 인증 정보 파일을 사용한다고 가정합니다.

이 단계의 일부로 기본값 AWS 리전을 설정하여 기본 QLDB 엔드포인트를 설정해야 합니다. 코드 예제는 기본 AWS 리전의 QLDB에 연결됩니다. QLDB를 사용할 수 있는 리전의 전체 목록은 AWS 일반 참조에서 Amazon QLDB 엔드포인트 및 할당량을 참조하십시오.

다음은 ~/.aws/credentials라는 AWS 자격 증명 파일의 예입니다. 여기서 물결 문자(~)는 사용자의 홈 디렉터리입니다.

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

your_access_key_id 및 your_secret_access_key 값을 자신의 AWS 보안 인증 정보 값으로 대체합니다.

설치

QLDB는 다음 Java 드라이버 버전과 해당 AWS SDK 종속성을 지원합니다.

드라이버 버전	AWS SDK	상태	최근 릴리스 날짜
1.x	AWS SDK for Java 1.x	프로덕션 릴리스	2020년 3월 20일
2.x	AWS SDK for Java 2.x	프로덕션 릴리스	2021년 6월 4일

QLDB 드라이버를 설치하려면 Gradle 또는 Maven과 같은 종속성 관리 시스템을 사용할 것을 권장합니다. 예를 들어, Java 프로젝트에 다음 아티팩트를 종속성 항목으로 추가합니다.

2.x

Gradle

build.gradle 구성 파일에 이 종속성을 추가합니다.

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '2.3.1'
}

Maven

pom.xml 구성 파일에 이 종속성을 추가합니다.

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>2.3.1</version>
  </dependency>
</dependencies>

이 아티팩트에는 AWS SDK for Java 2.x 코어 모듈, Amazon Ion 라이브러리 및 기타 필수 종속성이 자동으로 포함됩니다.

1.x

Gradle

build.gradle 구성 파일에 이 종속성을 추가합니다.

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '1.1.0'
}

Maven

pom.xml 구성 파일에 이 종속성을 추가합니다.

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>1.1.0</version>
  </dependency>
</dependencies>

이 아티팩트에는 AWS SDK for Java 코어 모듈, Amazon Ion 라이브러리 및 기타 필수 종속성이 자동으로 포함됩니다.

중요

Amazon Ion 네임스페이스 — 애플리케이션에서 Amazon Ion 클래스를 가져올 때는 네임스페이스 com.amazon.ion 아래에 있는 패키지를 사용해야 합니다. AWS SDK for Java은 네임스페이스 software.amazon.ion 아래의 다른 Ion 패키지에 따라 다르지만 이 패키지는 QLDB 드라이버와 호환되지 않는 레거시 패키지입니다.

원장에서 기본 데이터 트랜잭션을 실행하는 방법에 대한 단축 코드 예제는 Cookbook 참조를 참조하십시오.

기타 옵션 라이브러리

선택 사항으로 프로젝트에 다음과 같은 유용한 라이브러리를 추가할 수도 있습니다. 이러한 아티팩트는 Java 자습서 샘플 애플리케이션의 필수 종속성입니다.

1. aws-java-sdk-qldb – AWS SDK for Java의 QLDB 모듈입니다. 현재 지원되는 QLDB 최소 버전은 1.11.785입니다.

   애플리케이션에서 이 모듈을 사용하여 Amazon QLDB API 참조에 나열된 관리 API 작업과 직접 상호 작용할 수 있습니다.

2. jackson-dataformat-ion – FasterXML의 Ion용 Jackson 데이터 형식 모듈입니다. 샘플 애플리케이션에는 2.10.0 버전 이상이 필요합니다.

Gradle

build.gradle 구성 파일에 이 종속성을 추가합니다.

dependencies {
    compile group: 'com.amazonaws', name: 'aws-java-sdk-qldb', version: '1.11.785'
    compile group: 'com.fasterxml.jackson.dataformat', name: 'jackson-dataformat-ion', version: '2.10.0'
}

Maven

pom.xml 구성 파일에 이 종속성을 추가합니다.

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-qldb</artifactId>
    <version>1.11.785</version>
  </dependency>
  <dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-ion</artifactId>
    <version>2.10.0</version>
  </dependency>
</dependencies>