步驟 2：在 QLDB 中驗證您的資料

重要

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

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

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

AWS Management Console

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

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

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

1. 在 https：//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. 在驗證文件表單中，指定您要驗證的文件下，輸入下列輸入參數：

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

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

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

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

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

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

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

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

   1. 向 QLDB 請求您指定文件的證明。

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

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

QLDB API

您也可以使用 Amazon QLDB API 搭配 SDK 或 來 AWS 驗證文件修訂版 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 Java 教學課程 來建立範例分類帳，並使用範例資料將其載入。

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

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

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

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