步驟 1:在 中請求摘要 QLDB - Amazon Quantum Ledger 資料庫 (Amazon QLDB)

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

步驟 1:在 中請求摘要 QLDB

重要

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

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

AWS Management Console

請依照下列步驟,使用QLDB主控台請求摘要。

請求摘要 (主控台)
  1. 登入 AWS Management Console,然後在 https://console.aws.amazon.com/qldb 開啟 Amazon QLDB主控台。

  2. 在導覽窗格中,選擇 Ledgers

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

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

    • 摘要 – 您請求的摘要的 SHA-256 雜湊值。

    • 摘要提示地址 – 您請求的摘要所涵蓋日誌中的最新區塊位置。地址有兩個欄位:

      • strandId – 包含 區塊之日誌股的唯一 ID。

      • sequenceNo – 索引號碼,指定 股內區塊的位置。

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

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

  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. 儲存此檔案,以便日後存取。稍後,您可以使用此檔案來驗證文件修訂版本。

    重要

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

QLDB API

您也可以使用 Amazon QLDBAPI搭配 AWS SDK或 ,向 分類帳請求摘要 AWS CLI。QLDB API 提供下列操作供應用程式使用:

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

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

範例應用程式

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

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

若要使用您儲存的摘要驗證文件修訂,請繼續 步驟 2:在 中驗證資料 QLDB