Java 用 Amazon QLDBドライバー - Amazon Quantum 台帳データベース (Amazon QLDB）
ドライバーに関するリソース前提条件デフォルトの AWS の認証情報とリージョンを設定するインストール

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Java 用 Amazon QLDBドライバー

重要

サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon Ledger QLDB を Amazon Aurora Postgre に移行するSQL」を参照してください。

台帳内のデータを操作するには、 AWS が提供するドライバーを使用して Java アプリケーションQLDBから Amazon に接続できます。以下のトピックでは、Java 用QLDBドライバーの使用を開始する方法について説明します。

トピック

ドライバーに関するリソース

Java ドライバーでサポートされる機能の詳細については、以下のリソースを参照してください。

前提条件

Java 用QLDBドライバーの使用を開始する前に、次の操作を行う必要があります。

  1. AWS 「」のセットアップ手順に従ってくださいAmazon へのアクセス QLDB。これには以下が含まれます。

    1. にサインアップします AWS。

    2. 適切なQLDBアクセス許可を持つユーザーを作成します。

    3. 開発に必要なプログラムへのアクセスを提供します。

  2. 以下をダウンロードおよびインストールして、Java 開発環境を設定します。

    1. Java SE 開発キット 8 (Amazon Corretto 8 など)。

    2. （オプション) Eclipse や IntelliJ など、任意の Java 統合開発環境 (IDE）。 IntelliJ

  3. AWS SDK for Java で の開発環境を設定しますデフォルトの AWS の認証情報とリージョンを設定する。

次に、すべてのチュートリアル用のサンプルアプリケーションをダウンロードするか、Java プロジェクトにのみドライバーをインストールして短いコード例を実行できます。

  • QLDB ドライバーと を既存のプロジェクト AWS SDK for Java にインストールするには、「」に進みますインストール。

  • プロジェクトを設定し、台帳の基本的なデータトランザクションを示す短いコード例については、「クイックスタートチュートリアル」を参照してください。

  • 完全なチュートリアルサンプルアプリケーションでデータと管理APIオペレーションの両方の詳細な例を実行するには、「」を参照してくださいJava チュートリアル。

デフォルトの AWS の認証情報とリージョンを設定する

QLDB ドライバーと基盤となる AWS SDK for Javaでは、実行時にアプリケーションに AWS 認証情報を指定する必要があります。このガイドのコード例では、 AWS 認証情報ファイルを使用していることを前提としています。詳細については、「AWS SDK for Java 2.x デベロッパーガイド」の「デフォルトの認証情報とリージョンを設定する」を参照してください。

これらのステップの一環として、デフォルトQLDBエンドポイントを決定する AWS リージョン ためにデフォルトも設定する必要があります。コード例は、デフォルトの 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 の下にあるパッケージを使用する必要があります。 AWS SDK for Java は、名前空間 の別の Ion パッケージに依存しますがsoftware.amazon.ion、これはQLDBドライバーと互換性のないレガシーパッケージです。

台帳に対して基本的なデータトランザクションを実行する方法を示す短いコード例については、「クックブックリファレンス」を参照してください。

他のオプションのライブラリ

オプションで、プロジェクトに以下の便利なライブラリを追加することもできます。これらのアーティファクトは、Java チュートリアルサンプルアプリケーションで必須の依存関係にあります。

  1. aws-java-sdk-qldb – のQLDBモジュール AWS SDK for Java。QLDB サポートされている最小バージョンは です1.11.785。

    アプリケーションでこのモジュールを使用して、 にリストされている管理APIオペレーションを直接操作しますAmazon QLDBAPIリファレンス。

  2. jackson-dataformat-ion – Ion 用の XMLの 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>