자바용 아마존 QLDB 드라이버 - Amazon Quantum 원장 데이터베이스(Amazon QLDB)
드라이버 리소스사전 조건기본 AWS 보안 인증 정보 및 리전 설정설치

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

자바용 아마존 QLDB 드라이버

중요

지원 종료 알림: 기존 고객은 2025년 7월 31일 지원이 종료될 QLDB 때까지 Amazon을 사용할 수 있습니다. 자세한 내용은 아마존 QLDB 원장을 Amazon Aurora SQL Postgre로 마이그레이션을 참조하십시오.

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

주제

드라이버 리소스

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

사전 조건

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

  1. 의 AWS 설치 지침을 따르십시오아마존 액세스 QLDB. 다음 내용이 포함됩니다:

    1. 가입하세요 AWS.

    2. 적절한 QLDB 권한을 가진 사용자를 만드세요.

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

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

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

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

  3. BY에 맞게 개발 환경을 구성하십시오. AWS SDK for Java 기본 AWS 보안 인증 정보 및 리전 설정

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

  • 기존 프로젝트에 QLDB 드라이버와 를 AWS SDK for Java 설치하려면 로 진행하십시오설치.

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

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

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

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

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

다음은 이라는 AWS ~/.aws/credentials 자격 증명 파일의 예입니다. 여기서 틸드 문자 (~) 는 홈 디렉터리를 나타냅니다.

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

값을 AWS 사용자 고유의 자격 증명 값으로 대체하십시오.your_access_key_id 그리고 your_secret_access_key.

설치

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 아래에 있는 패키지를 사용해야 합니다. 는 네임스페이스 software.amazon.ion 아래의 다른 Ion 패키지에 AWS SDK for Java 따라 다르지만 이 패키지는 드라이버와 호환되지 않는 레거시 패키지입니다. QLDB

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

기타 옵션 라이브러리

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

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

    애플리케이션에서 이 모듈을 사용하여 에 나열된 관리 API 작업과 직접 상호 작용할 수 아마존 QLDB API 레퍼런스 있습니다.

  2. jackson-dataformat-ion— XML Faster의 Ion용 잭슨 데이터 형식 모듈. 샘플 애플리케이션에는 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>