步骤 1：在 QLDB 中请求摘要

Amazon QLDB 提供了一个 API，用于请求涵盖分类账中日记账当前提示 的摘要。日记账提示指的是 QLDB 收到您的请求时的最近提交的数据块。您可以使用 AWS Management Console、S AWS DK 或 AWS Command Line Interface (AWS CLI) 来获取摘要。

AWS Management Console

使用 QLDB 控制台，按照以下步骤来还原资源。

请求摘要（控制台）

1. 登录并打开亚马逊 QLDB 控制台，网址为 https://console.aws.amazon.com/qldb。 AWS Management Console

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. 将这个文件保存在您将来可以访问的地方。随后，您可以使用这个文件来验证文档修订。

   重要

   您稍后验证的文档修订必须包含在您保存的摘要中。也就是说，文档地址的序列号必须小于或等于摘要提示地址的序列号。

QLDB API

您还可以使用 Amazon QLDB API 与相关的 AWS SDK 或者使用 AWS CLI，通过向您的分类帐请求摘要。QLDB API 提供以下操作以供应用程序使用：

• GetDigest— 返回日记账中最新提交区块的账本摘要。响应包括一个 256 位的哈希值和一个块地址。

有关使用请求摘要的信息 AWS CLI，请参阅《命令参考》中的 get-diges t AWS CLI 命令。

示例应用程序

有关 Java 代码示例，请参阅 GitHub 存储库 a ws-samples/-amazon-qldb-dmv-sample java。有关如何下载和安装此示例应用程序的说明，请参阅 安装 Amazon QLDB Java 示例应用程序。在请求摘要之前，请确保按照 Java 教程 中的步骤 1-3 创建一个示例分类帐并用示例数据加载它。

课堂中的教程代码GetDigest提供了从vehicle-registration示例账本中请求摘要的示例。

要使用您保存的摘要验证文档修订，请继续执行 步骤 2：在 QLDB 中验证您的数据。