安裝 Amazon QLDB Java 示例應用程序 - Amazon Quantum 賬本數據庫（AmazonQLDB）
必要條件安裝

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

安裝 Amazon QLDB Java 示例應用程序

重要

支援結束通知：現有客戶將能夠使用 Amazon，QLDB直到 2025 年 7 月 31 日終止支援為止。有關更多詳細信息，請參閱將 Amazon QLDB 分類帳遷移到 Amazon Aurora 郵政. SQL

本節說明如何安裝和執行針對 step-by-step Java 教學課程提供的 Amazon QLDB 範例應用程式。此示例應用程序的用例是汽車（DMV）數據庫的一個部門，用於跟踪有關車輛註冊的完整歷史信息。

Java 的DMV示例應用程序是 GitHub 存儲庫中的開源 aws-示例/-java。amazon-qldb-dmv-sample

必要條件

在開始之前，請確定您已完成 Java 的QLDB驅動程式必要條件。這包含下列項目：

  1. 註冊 AWS.

  2. 建立具有適當QLDB權限的使用者。若要完成本教學課程中的所有步驟，您需要透過完整的分類帳資源管理存取權QLDBAPI。

  3. 如果您使用的是IDE其他版本 AWS Cloud9，請安裝 Java 並授予程式設計存取權以進行開發。

安裝

下列步驟說明如何使用本機開發環境下載及設定範例應用程式。或者，您可以使用 AWS Cloud9 做為您的範例應用程式IDE，並使用範本來佈建您的開發資源，來自動設定 AWS 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 組態和來自. 爪哇教程

  2. 載入並執行提供的應用程式。

    • 如果您使用的是日食：

      1. 啟動 Eclipse，並在 Eclipse 菜單上，選擇文件，導入，然後現有搖籃項目。

      2. 在專案根目錄中，瀏覽並選取包含build.gradle檔案的應用程式目錄。然後，選擇「完成」以使用導入的默認 Gradle 設置。

      3. 你可以嘗試運行程ListLedgers序作為一個例子。開啟ListLedgers.java檔案的內容 (按一下滑鼠右鍵) 功能表，然後選擇「以 Java 應用程式執行」。

    • 如果您使用的是 IntelliJ：

      1. 啟動 IntelliJ，然後在 IntelliJ 功能表上選擇檔案，然後選擇開啟。

      2. 在專案根目錄中，瀏覽並選取包含build.gradle檔案的應用程式目錄。然後，選擇 「確定」。保留預設設定，然後再次選擇「確定」。

      3. 你可以嘗試運行程ListLedgers序作為一個例子。打開文件的上下ListLedgers.java文（右鍵單擊）菜單，然後選擇運行 ListLedgers ''。

  3. 繼續進行步驟 1：建立新分類帳以啟動自學課程並建立分類帳。

這些指示說明如何自動設定適用於 Java 的 Amazon QLDB 車輛註冊範例應用AWS Cloud9程式，並將您的IDE. 在本指南中，您會使用AWS CloudFormation範本來佈建您的開發資源。

若要取得有關的更多資訊 AWS Cloud9，請參閱AWS Cloud9 使用者指南。若要進一步了解 AWS CloudFormation，請參閱 AWS CloudFormation 使用者指南。

第 1 部分：佈建資源

在第一個步驟中，您可 AWS CloudFormation 以使用 Amazon QLDB 範例應用程式佈建設定開發環境所需的資源。

開啟 AWS CloudFormation 主控台並載入QLDB範例應用程式範本

  1. 請登入 AWS Management Console 並開啟 AWS CloudFormation 主控台，網址為 https://console.aws.amazon.com/cloudformation。

    切換到支持的區域QLDB。如需完整清 AmazonQLDB，請參閱 AWS 一般參考. 下列螢幕擷取畫面 AWS Management Console 顯示美國東部 (維吉尼亞北部) 為選取項目 AWS 區域。

    AWS Management Console 顯示美國東部 (維吉尼亞北部) 為已選取 AWS 區域。

  2. 在 AWS CloudFormation 主控台上，選擇 [建立堆疊]，然後選擇 [使用新資源 (標準)]。

  3. 在「建立堆疊」頁面的「指定範本」下，選擇 Amazon S3 URL。

  4. 輸入下列項目URL，然後選擇「下一步」。

    https://amazon-qldb-assets.s3.amazonaws.com/templates/QLDB-DMV-SampleApp.yml

  5. 輸入堆疊名稱 (例如qldb-sample-app)，然後選擇「下一步」。

  6. 您可以視需要新增任何標籤，並保留預設選項。然後選擇下一步。

  7. 檢閱堆疊設定，然後選擇 [建立堆疊]。指 AWS CloudFormation 令碼可能需要幾分鐘才能完成。

    此指令碼使用關聯的 Amazon 彈性運算雲端 (AmazonEC2) 執行個體佈建您的 AWS Cloud9 環境，您可以在本教學中用來執行QLDB範例應用程式。它還將 aws-Samples/ amazon-qldb-dmv-sample-java 存儲庫從克隆到您的開發環境中。 GitHub AWS Cloud9

第 2 部分：設置 IDE

在此步驟中，您將完成雲端開發環境的設定。您可以下載並執行提供的 shell 指令碼，以便 AWS Cloud9 IDE使用範例應用程式的相依性來設定。

若要設定您的 AWS Cloud9 環境

  1. 在開啟 AWS Cloud9 主控台https://console.aws.amazon.com/cloud9/。

  2. 在您的環境下，找到名為「QLDBDMV範例應用程式」之環境的卡片，然後選擇「開啟」IDE。基礎EC2執行個體啟動時，您的環境可能需要一分鐘的時間才能載入。

    您的 AWS Cloud9 環境已預先設定好執行教學課程所需的系統相依性。在主控台的 [環境] 導覽窗格中，確認您看到名為的資料夾QLDB DMV Sample Application。 AWS Cloud9 主控台的下列螢幕擷取畫面顯示QLDBDMV範例應用程式環境資料夾窗格。

    AWS Cloud9 主控台顯示QLDBDMV範例應用程式環境資料夾窗格。

    如果您沒有看到導覽窗格，請切換主機左側的 [環境] 索引標籤。如果您在窗格中沒有看到任何資料夾，請使用設定圖示啟用「顯示環境根目錄」( Settings icon )。

  3. 在控制台的底部窗格中，您應該會看到一個打開的bash終端窗口。如果沒有看到此選項，請從主機頂端的「視窗」 選單中選擇「新增終端機」。

  4. 接下來，下載並執行安裝程式指令碼以安裝 Open JDK 8，如果適用，請從 Git 儲存庫中查看適當的分支。在您在上一個步驟中建立的 AWS Cloud9 終端機中，依序執行下列兩個命令：

    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 部分：運行示QLDBDMV例應用程序

在此步驟中，您將學習如何使用執行 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. 下面的命令顯示了搖籃語法來運行每個任務。

    ./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 堆疊。