Amazon QLDB Java サンプルアプリケーションのインストール - Amazon Quantum Ledger Database (Amazon QLDB)

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

Amazon QLDB Java サンプルアプリケーションのインストール

重要

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

このセクションでは、ステップバイステップの Java チュートリアル用に提供されている Amazon QLDB サンプルアプリケーションをインストールして実行する方法について説明します。このサンプルアプリケーションのユースケースは、車両登録に関する完全な履歴情報を追跡する自動車部門 (DMV) データベースです。

Java 用の DMV サンプルアプリケーションは、GitHub リポジトリ aws-samples/amazon-qldb-dmv-sample-java でオープンソースとして公開されています。

前提条件

開始する前に、Java 用 QLDB ドライバーの「前提条件」を完了していることを確認します。これには以下が含まれます。

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

  2. QLDB の適切なアクセス許可を持つユーザーを作成します。このチュートリアルのすべての手順を完了するには、QLDB API を介して台帳リソースへのフル管理アクセス権が必要です。

  3. 以外の IDE を使用している場合は AWS Cloud9、Java をインストールし、開発用のプログラムによるアクセスを許可します。

インストール

以下のステップでは、ローカル開発環境でサンプルアプリケーションをダウンロードして設定する方法について説明します。または、 を IDE AWS Cloud9 として使用し、 CloudFormation テンプレートを使用して開発リソースをプロビジョニングすることで、サンプルアプリケーションのセットアップを自動化することもできます。

ここでは、独自のリソースと開発環境を使用して QLDB Java サンプルアプリケーションをダウンロードしてインストールする方法について説明します。

サンプルアプリケーションをダウンロードして実行するには
  1. 次のコマンドを入力して、GitHub からサンプルアプリケーションのクローンを作成します。

    2.x
    git clone https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git
    1.x
    git clone -b v1.2.0 https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git

    このパッケージには、Gradle 設定と Java チュートリアル からの完全なコードが含まれています。

  2. 提供されたアプリケーションをロードして実行します。

    • Eclipse を使用している場合:

      1. Eclipse を起動し、[Eclipse] メニューで、[File (ファイル)]、[Import (インポート)]、[Existing Gradle Project (既存の Gradle プロジェクト)] の順に選択します。

      2. プロジェクトのルートディレクトリで、build.gradle ファイルが格納されているアプリケーションディレクトリを参照して選択します。次に、[Finish (完了)] を選択し、インポートにデフォルトの Gradle 設定を使用します。

      3. 例として ListLedgers プログラムを実行してみることができます。ListLedgers.java ファイルのコンテキスト (右クリック) メニューを開き、[Run as Java Application (Java アプリケーションとして実行)] を選択します。

    • IntelliJ を使用している場合:

      1. IntelliJ を起動し、[IntelliJ] メニューで [File (ファイル)]、[Open (開く)] の順に選択します。

      2. プロジェクトのルートディレクトリで、build.gradle ファイルが格納されているアプリケーションディレクトリを参照して選択します。次に、[OK] を選択します。デフォルト設定をそのままにして、[OK] を再び選択します。

      3. 例として ListLedgers プログラムを実行してみることができます。ListLedgers.java ファイルのコンテキスト (右クリック) メニューを開き、[Run 'ListLedgers' (「ListLedgers」として実行)] を選択します。

  3. ステップ 1: 新しい台帳を作成する に進み、チュートリアルを開始して台帳を作成します。

以下の手順では、AWS Cloud9 を IDE として使用して Java 用の Amazon QLDB 車両登録サンプルアプリケーションのセットアップを自動化する方法について説明します。このガイドでは、CloudFormation テンプレートを使用して、開発リソースをプロビジョニングします。

詳細については AWS Cloud9、「 AWS Cloud9 ユーザーガイド」を参照してください。 CloudFormationの詳細については、「AWS CloudFormation ユーザーガイド」を参照してください。

パート 1: リソースのプロビジョニング

この最初のステップでは、 CloudFormation を使用して、Amazon QLDB サンプルアプリケーションで開発環境をセットアップするために必要なリソースをプロビジョニングします。

CloudFormation コンソールを開き、QLDB サンプルアプリケーションテンプレートをロードするには
  1. にサインイン AWS マネジメントコンソール し、https://console.aws.amazon.com/cloudformation で CloudFormation コンソールを開きます。

    QLDB をサポートするリージョンに切り替えます。完全なリストについては、「AWS 全般のリファレンス」の「Amazon QLDB エンドポイントとクォータ」を参照してください。次の のスクリーンショット AWS マネジメントコンソール は、米国東部 (バージニア北部) が選択されています AWS リージョン。

    AWS マネジメントコンソール 選択した として米国東部 (バージニア北部) を表示 AWS リージョンしています。
  2. CloudFormation コンソールで、スタックの作成を選択し、新しいリソース (標準) で を選択します。

  3. [Create stack (スタックの作成)] ページの [Specify template (テンプレートの指定)] で、[Amazon S3 URL] を選択します。

  4. 次の URL を入力し、[Next (次へ)] を選択します。

    https://amazon-qldb-assets.s3.amazonaws.com/templates/QLDB-DMV-SampleApp.yml
  5. [Stack name (スタック名)] (qldb-sample-app など) を入力し、[Next (次へ)] を選択します。

  6. 必要に応じてタグを追加し、デフォルトのオプションはそのままにしておきます。次いで、[次へ] を選択します。

  7. スタックの設定を確認し、[Create stack (スタックの作成)] を選択します。 CloudFormation スクリプトが終了するまでに数分かかる場合があります。

    このスクリプトは、このチュートリアルで QLDB サンプルアプリケーションの実行に使用する、関連付けられた Amazon Elastic Compute Cloud (Amazon EC2) インスタンスを AWS Cloud9 環境をプロビジョニングします。また、aws-samples/amazon-qldb-dmv-sample-java リポジトリを GitHub から AWS Cloud9 開発環境にクローンします。

パート 2: IDE をセットアップする

このステップでは、クラウド開発環境のセットアップを完了します。提供されているシェルスクリプトをダウンロードして実行し、サンプルアプリケーションの依存関係を使用して AWS Cloud9 IDE を設定します。

AWS Cloud9 環境を設定するには
  1. https://console.aws.amazon.com/cloud9/ で AWS Cloud9 コンソールを開きます。

  2. [Your environments (環境)] で、QLDB DMV Sample Application という名前の環境のカードを探し、[Open IDE (IDE を開く)] を選択します。お使いの環境によっては、基盤となる EC2 インスタンスが起動する際、ロードに時間がかかる場合があります。

    AWS Cloud9 環境は、チュートリアルの実行に必要なシステムの依存関係で事前設定されています。コンソールの [Environment (環境)] ナビゲーションペインで、QLDB DMV Sample Application という名前のフォルダが表示されていることを確認します。次の AWS Cloud9 コンソールのスクリーンショットは、QLDB DMV サンプルアプリケーション環境フォルダペインを示しています。

    AWS Cloud9 QLDB DMV サンプルアプリケーション環境フォルダペインを示す コンソール。

    ナビゲーションペインが表示されない場合は、コンソールの左側にある [Environment (環境)] タブを切り替えます。ペインにフォルダが全く表示されない場合は、設定アイコン ( Settings icon ) を使用して [Show Environment Root] (環境ルートの表示) を有効にします。

  3. コンソールの下部のペインに、bash ターミナルウィンドウが開かれます。これが表示されない場合は、コンソール上部にある [Window] (ウィンドウ) メニューから [New Terminal] (新しいターミナル) を選択します。

  4. 次に、セットアップスクリプトをダウンロードして実行して OpenJDK 8 をインストールし、該当する場合は Git リポジトリから適切なブランチをチェックアウトします。前のステップで作成した AWS Cloud9 ターミナルで、次の 2 つのコマンドを順番に実行します。

    2.x
    aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup-v2.sh .
    sh dmv-setup-v2.sh
    1.x
    aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup.sh .
    sh dmv-setup.sh

    完了すると、ターミナルに次のメッセージが表示されます。

    ** DMV Sample App setup completed , enjoy!! **
  5. でサンプルアプリケーションコードを参照します。 AWS Cloud9特にディレクトリパス で参照しますsrc/main/java/software/amazon/qldb/tutorial

パート 3: QLDB DMV サンプルアプリケーションを実行する

このステップでは、 を使用して Amazon QLDB DMV サンプルアプリケーションタスクを実行する方法について説明します AWS Cloud9。サンプルコードを実行するには、 AWS Cloud9 ターミナルに戻るか、パート 2: IDE のセットアップで行ったように新しいターミナルウィンドウを作成します。

サンプルアプリケーションを実行するには
  1. ターミナルで次のコマンドを実行し、プロジェクトのルートディレクトリに切り替えます。

    cd ~/environment/amazon-qldb-dmv-sample-java

    次のディレクトリパスの例を実行していることを確認します。

    /home/ec2-user/environment/amazon-qldb-dmv-sample-java/
  2. 次のコマンドは、各タスクを実行するための Gradle 構文を示します。

    ./gradlew run -Dtutorial=Task

    例えば、次のコマンドを実行して、 AWS アカウント と現在のリージョンのすべての台帳を一覧表示します。

    ./gradlew run -Dtutorial=ListLedgers
  3. ステップ 1: 新しい台帳を作成する に進み、チュートリアルを開始して台帳を作成します。

  4. (オプション) このチュートリアルを完了した後、不要になった CloudFormation リソースをクリーンアップします。

    1. https://console.aws.amazon.com/cloudformation で CloudFormation コンソールを開き、パート 1: リソースのプロビジョニングで作成したスタックを削除します。

    2. また、 CloudFormation テンプレートが作成した AWS Cloud9 スタックも削除します。