步驟 2：在 中驗證資料 QLDB - Amazon Quantum Ledger 資料庫 （Amazon QLDB）
AWS Management ConsoleQLDB API

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

步驟 2：在 中驗證資料 QLDB

重要

支援終止通知：現有客戶將可以使用 Amazon，QLDB直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱將 Amazon QLDB Ledger 遷移至 Amazon Aurora Postgre。SQL

Amazon QLDB提供 API來請求指定文件 ID 及其關聯區塊的證明。您還必須提供先前儲存的摘要的提示地址，如 中所述步驟 1：在 中請求摘要 QLDB。您可以使用 AWS Management Console、 AWS SDK或 AWS CLI 來取得證明。

然後，您可以使用 傳回的驗證QLDB，使用用戶端 ，針對儲存的摘要驗證文件修訂API。這可讓您控制用來驗證資料的演算法。

AWS Management Console

本節說明使用 Amazon QLDB主控台，針對先前儲存的摘要驗證文件修訂的步驟。

開始之前，請務必遵循 中的步驟步驟 1：在 中請求摘要 QLDB。驗證需要先前儲存的摘要，其中包含您要驗證的修訂版本。

驗證文件修訂版本 （主控台）

  1. 在 https://console.aws.amazon.com/qldb 開啟 Amazon QLDB主控台。

  2. 首先，查詢您的分類帳，尋找您要驗證blockAddress之修訂的 id和 。這些欄位包含在文件的中繼資料中，您可以在遞交的檢視 中查詢這些欄位。

    文件id是系統指派的唯一 ID 字串。blockAddress 是 Ion 結構，指定提交修訂的區塊位置。

    在導覽窗格中，選擇 PartiQL 編輯器 。

  3. 選擇您要驗證修訂的分類帳名稱。

  4. 在查詢編輯器視窗中，輸入下列語法中的SELECT陳述式，然後選擇執行 。

    SELECT metadata.id, blockAddress FROM _ql_committed_table_name
WHERE criteria

    例如，下列查詢會從在 中建立的範例分類帳中的VehicleRegistration資料表傳回文件Amazon QLDB主控台入門。

    SELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r 
WHERE r.data.VIN = 'KM8SRDHF6EU074761'

  5. 複製並儲存查詢傳回的 id和 blockAddress值。請務必省略 id 欄位的雙引號。在 Amazon Ion 中，字串資料類型會以雙引號分隔。例如，您必須僅複製下列程式碼片段中的英數文字。

    "LtMNJYNjSwzBLgf7sLifrG"

  6. 現在您已選取文件修訂版本，您可以開始驗證該修訂版本的程序。

    在導覽窗格中，選擇驗證 。

  7. 在驗證文件表單中，在指定您要驗證的文件下，輸入下列輸入參數：

    • Ledger – 您要驗證修訂的分類帳。

    • 封鎖地址 – 步驟 4 中查詢傳回blockAddress的值。

    • 文件 ID – 步驟 4 中查詢傳回id的值。

  8. 在指定要用於驗證的摘要 下，選擇選擇選擇摘要 ，以選取您先前儲存的摘要。如果檔案有效，此 會自動填入主控台上的所有摘要欄位。或者，您可以直接從摘要檔案手動複製和貼上下列值：

    • 摘要 – 摘要檔案digest的值。

    • 摘要提示地址 – 摘要檔案中digestTipAddress的值。

  9. 檢閱您的文件並摘要輸入參數，然後選擇驗證 。

    主控台會為您自動化兩個步驟：

    1. 為指定的文件請求來自 QLDB的證明。

    2. 使用 傳回的驗證QLDB來呼叫用戶端 API，以根據提供的摘要驗證文件修訂。若要檢查此驗證演算法，請參閱下列章節QLDB API以下載程式碼範例。

    主控台會在驗證結果卡中顯示請求的結果。如需詳細資訊，請參閱驗證結果。

QLDB API

您也可以使用 Amazon QLDBAPI搭配 AWS SDK或 來驗證文件修訂 AWS CLI。QLDB API 提供下列操作供應用程式使用：

  • GetDigest – 傳回 日誌中最近遞交區塊的分類帳摘要。回應包含 256 位元雜湊值和區塊地址。

  • GetBlock – 傳回日誌中指定地址的區塊物件。如果DigestTipAddress提供 ，也會傳回指定區塊的驗證證明以進行驗證。

  • GetRevision – 傳回指定文件 ID 和區塊地址的修訂資料物件。如果DigestTipAddress已提供 ，也會傳回指定修訂的證明以供驗證。

如需這些API操作的完整說明，請參閱 Amazon QLDB API 參考。

如需使用 驗證資料的相關資訊 AWS CLI，請參閱 AWS CLI 命令參考 。

範例應用程式

如需 Java 程式碼範例，請參閱 GitHub 儲存庫 aws-samples/amazon-qldb-dmv-sample-java 。如需如何下載和安裝此範例應用程式的指示，請參閱 安裝 Amazon QLDB Java 示例應用程序。在進行驗證之前，請務必遵循 中的步驟 1–3 爪哇教程 來建立範例分類帳，並使用範例資料將其載入。

類別中的教學課程程式碼GetRevision提供請求文件修訂證明，然後驗證該修訂的範例。此類別執行下列步驟：

  1. 從範例分類帳 請求新的摘要vehicle-registration。

  2. 從vehicle-registration分類帳中的VehicleRegistration資料表請求範例文件修訂的證明。

  3. 使用傳回的摘要和驗證來驗證範例修訂。