步驟 1:請求摘要 QLDB - Amazon Quantum 賬本數據庫(AmazonQLDB)

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

步驟 1:請求摘要 QLDB

重要

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

Amazon QLDB 提供了一個請求摘API要,其中涵蓋分類帳中日誌的當前提。日誌的提示是指截至QLDB收到您的請求時最新提交的塊。您可以使用 AWS Management Console AWS SDK、a 或 AWS Command Line Interface (AWS CLI) 來取得摘要。

AWS Management Console

請按照以下步驟使用QLDB控制台請求摘要。

要求摘要(控制台)
  1. 登錄到 AWS Management Console, 並打開 Amazon QLDB 控制台 https://console.aws.amazon.com/qldb.

  2. 在瀏覽窗格中,選擇「分類帳」。

  3. 在分類帳清單中,選取您要請求摘要的分類帳名稱。

  4. 選擇取得摘要。「取得摘要」對話方塊會顯示下列摘要詳細資訊:

    • 要 — 您要求之摘要的 SHA -256 雜湊值。

    • 摘要提示位址 — 您要求摘要涵蓋的日誌中最新的區塊位置。地址具有以下兩個字段:

      • strandId— 包含區塊之日誌鏈的唯一 ID。

      • sequenceNo— 指定圖塊在鏈中位置的索引號碼。

    • 分類帳 — 您請求摘要的分類帳名稱。

    • 日期 — 您請求摘要時的時間戳記。

  5. 複查摘要資訊。然後選擇 Save (儲存)。您可以保留預設檔案名稱,或輸入新名稱。

    注意

    您可能會注意到,即使您未修改分類帳中的任何資料,摘要雜湊值和提示位址值也會發生變化。這是因為每次您在 PartiQL 編輯器中執行查詢時,主控台都會擷取分類帳的系統目錄。這是一個讀取交易,會認可至日誌,並導致最新的區塊位址發生變更。

    此步驟會以 Amazon Ion 格式儲存內容的純文字檔案。檔案的副檔名為,.ion.txt並包含上述對話方塊中列出的所有摘要資訊。以下是摘要檔案內容的範例。欄位的順序可能會因您的瀏覽器而有所不同。

    { "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",   "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",   "ledger": "my-ledger",   "date": "2019-04-17T16:57:26.749Z" }
  6. 將此檔案儲存在 future 可存取的位置。稍後,您可以使用此檔案來驗證文件的修訂版本。

    重要

    您稍後驗證的文件修訂版本必須涵蓋在您儲存的摘要中。也就是說,文檔地址的序列號必須小於或等於摘要提示地址的序列號。

QLDB API

您也可以通過使用 Amazon QLDB API 與 AWS SDK或 AWS CLI. QLDBAPI提供下列作業供應用程式使用:

  • GetDigest— 傳回期刊中最新提交區塊中分類帳的摘要。該響應包括 256 位哈希值和塊地址。

如需有關使用要求摘要的資訊 AWS CLI,請參閱《命令參考》中的 get-digestAWS CLI 令

範例應用程式

有關 Java 代碼示例,請參閱 GitHub 存儲庫 aws-樣amazon-qldb-dmv-sample本/-java。如需如何下載和安裝此範例應用程式的指示,請參閱安裝 Amazon QLDB Java 示例應用程序。請求摘要之前,請務必遵循中的步驟 1-3 爪哇教程 來建立範例分類帳,並使用範例資料載入分類帳。

類別中的教學課程程式碼GetDigest提供了從範例分類帳要求摘要的vehicle-registration範例。

若要使用您儲存的摘要來驗證文件修訂版本,請繼續執行步驟 2:驗證您的資料 QLDB