Amazon QLDBJava サンプルアプリケーションのインストール - Amazon Quantum 台帳データベース (Amazon QLDB)

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

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

重要

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

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

Java DMVのサンプルアプリケーションは、 GitHub リポジトリ aws-samples/-java amazon-qldb-dmv-sampleのオープンソースです

前提条件

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

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

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

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

インストール

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

以下の手順では、独自のリソースと開発環境を使用して 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 ファイルのコンテキスト (右クリック) メニューを開き、「'' を実行ListLedgers」を選択します。

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

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

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

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

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

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

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

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

  3. テンプレート を指定 のスタックの作成ページで、Amazon S3 を選択します。 Amazon S3 URL

  4. 次の を入力しURL、次へ を選択します。

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

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

  7. スタックの設定を確認し、[Create stack (スタックの作成)] を選択します。 AWS 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. で AWS Cloud9 コンソールを開きますhttps://console.aws.amazon.com/cloud9/

  2. 環境 で、QLDBDMVサンプルアプリケーション という名前の環境のカードを探し、 を開く IDEを選択します。基盤となるEC2インスタンスが起動すると、環境のロードに 1 分かかる場合があります。

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

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

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

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

  4. 次に、セットアップスクリプトをダウンロードして実行し、Open JDK8 をインストールします。該当する場合は、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。サンプルコードを実行するには、「パート 2: のセットアップIDE」で行ったように、 AWS Cloud9 ターミナルに戻るか、新しいターミナルウィンドウを作成します。

サンプルアプリケーションを実行するには
  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. (オプション) このチュートリアルを完了した後、不要になった AWS CloudFormation リソースをクリーンアップします。

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

    2. また、 AWS CloudFormation テンプレートによって作成された AWS Cloud9 スタックも削除します。