Java 用 Amazon QLDB ドライバー - Amazon Quantum Ledger Database (Amazon QLDB)

Java 用 Amazon QLDB ドライバー

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

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

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

前提条件

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

  1. Amazon QLDB へのアクセス」にある AWS の設定手順に従います。

  2. Java 統合開発環境 (IDE) を選択します。

    • AWS Cloud9 (推奨) – Java IDE として AWS Cloud9 を使用し、提供された AWS CloudFormation テンプレートを使用して QLDB サンプルアプリケーションのセットアップを自動化します。このオプションでは、手動によるインストールと設定作業が最小限で済みます。

      このオプションでは、このセクションの残りの部分をスキップして、Java チュートリアル に進みます。次に、サンプルアプリケーションのインストールAWS Cloud9 の手順を実行します。

    • 他の IDE – 独自の開発リソースを使用して、任意の IDE を手動でインストールします。

      このオプションでは、次のセットアップ手順を続行します。

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

  4. 開発用の AWS 認証情報とリージョンを設定する。

次に、チュートリアルのサンプルアプリケーション全体をダウンロードするか、既存の Java プロジェクトにドライバーのみをインストールできます。

  • QLDB サンプルアプリケーションを使用して完全なチュートリアルを実行する方法については、「Java チュートリアル」を参照してください。

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

AWS 認証情報の設定

QLDB ドライバーとその基になる AWS SDK for Java では、アプリケーションのランタイムに AWS 認証情報を提供する必要があります。このガイドのサンプルコードでは、AWS SDK for Java Developer Guide の「開発用の AWS 認証情報とリージョンのセットアップ」で説明されているように、AWS 認証情報ファイルを使用することを前提としています。

~/.aws/credentials という名前の AWS 認証情報ファイルの例を次に示します。ここで、チルダ文字 (~) はホームディレクトリを表します。

[default] aws_access_key_id = AWS access key ID goes here aws_secret_access_key = Secret key goes here

AWS リージョンとエンドポイントの設定

AWS 認証情報の設定前の手順の一部として、デフォルトの AWS リージョンを設定する必要もあります。サンプルアプリケーションは、デフォルトの AWS リージョンの QLDB に接続します。また、AmazonQLDB クライアントオブジェクト (コントロールプレーン) または AmazonQLDBSessionClientBuilder オブジェクト (トランザクションデータプレーン) を変更することで、コード内のリージョンを変更することもできます。

次のサンプルコードは、新しい AmazonQLDB クライアントオブジェクトをインスタンス化します。

import com.amazonaws.regions.Regions; import com.amazonaws.services.qldb.AmazonQLDB; import com.amazonaws.services.qldb.AmazonQLDBClientBuilder; // This client will default to US East (Ohio) AmazonQLDB client = AmazonQLDBClientBuilder.standard() .withRegion(Regions.US_EAST_2) .build();

withRegion メソッドを使用して、利用可能な任意のリージョンで、QLDB を対象としてコードを実行します。完全なリストについては、アマゾン ウェブ サービス全般のリファレンス の「Amazon QLDB エンドポイントとクォータ」を参照してください。

インストール (ドライバーのみ)

QLDB ドライバーと AWS SDK for Java をインストールするには、Java プロジェクトの依存関係として次のアーティファクトを追加します。

  1. amazon-qldb-driver-java – Java 用 QLDB ドライバー。最新バージョンは 1.1.0 です。

    このアーティファクトには、AWS SDK for Java コアモジュール、Amazon Ion ライブラリ、およびその他の必要な依存関係が自動的に含まれています。

    重要

    Amazon Ion 名前空間

    アプリケーションの名前空間 com.amazon.ion 下にある Amazon Ion パッケージを使用する必要があります。AWS SDK for Java は、名前空間 software.amazon.ion の別の Ion パッケージに依存しますが、これは QLDB ドライバーと互換性がないレガシーパッケージです。

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

    このモジュールにより、アプリケーションは「Amazon QLDB API リファレンス」に記載されているコントロールプレーン API オペレーションとやり取りできます。

  3. jackson-dataformat-ion – オープンソースの Ion 用 Jackson データ形式モジュール。Java チュートリアル でコードを実行するには、このアーティファクトが必要です。サンプルアプリケーションにはバージョン 2.10.0.pr1 以降が必要です。

    独自のアプリケーションを使用して QLDB を操作する場合は、この Jackson 依存関係をプロジェクトに追加する必要はありません。

たとえば、ビルドツールとして Maven または Gradle を使用する場合は、build.gradle (Gradle) または pom.xml (Maven) 設定ファイルに以下の依存関係を追加します。

Gradle
dependencies { compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '1.1.0' 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.pr1' }
Maven
<dependencies> <dependency> <groupId>software.amazon.qldb</groupId> <artifactId>amazon-qldb-driver-java</artifactId> <version>1.1.0</version> </dependency> <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.pr1</version> </dependency> </dependencies>

台帳を作成し、台帳でデータトランザクションを実行する方法などの操作を示すコード例については、Java チュートリアル を参照してください。