本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 步骤 1：在 QLDB 中请求摘要
<a name="verification.digest"></a>

**重要**  
终止支持通知：现有客户将能够使用 Amazon QLDB，直到 2025 年 7 月 31 日终止支持。有关更多详细信息，请参阅[将亚马逊 QLDB 账本迁移到亚马逊 Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)。

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

**Topics**
+ [AWS 管理控制台](#verification.digest.con)
+ [QLDB API](#verification.digest.api)

## AWS 管理控制台
<a name="verification.digest.con"></a>

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

**请求摘要（控制台）**

1. [登录并打开亚马逊 QLDB 控制台，网址为 /qldb。 AWS 管理控制台 https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)

1. 在导航窗格中，选择**分类账**。

1. 在分类账列表中，选择要申请摘要的分类账名称。

1. 选择“**获取摘要**”。**获取摘要**对话框显示以下摘要详细信息：
   + **摘要** - 您请求的摘要的 SHA-256 哈希值。
   + **摘要提示地址** - 您请求的摘要所涵盖的日记中的最新区块位置。地址包含以下两个字段：
     + `strandId` — 包含数据块的日记账链的唯一 ID。
     + `sequenceNo` — 一个索引号，用于指定数据块在链中的位置。
   + **分类账** - 您请求摘要的分类账名称。
   + **日期** - 您请求摘要时的时间戳。

1. 检查摘要信息。然后选择 **Save**（保存）。您可以保留默认文件名，或输入新名称。
**注意**  
您可能会注意到，即使您不修改分类账中的任何数据，您的摘要散列值和提示地址值也会发生变化。这是因为每次在 *PartiQL 编辑器*中运行查询时，控制台都会检索分类账的系统目录。这是向日记账提交的读事务，会导致最新区块地址发生变化。

   此步骤将保存一个内容为 [Amazon Ion](ion.md) 格式的纯文本文件。该文件的文件扩展名为 `.ion.txt`，包含前面对话框中列出的所有摘要信息。以下是摘要内容的示例。字段的顺序可能因您的浏览器而异。

   ```
   {
     "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",
     "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",
     "ledger": "my-ledger",
     "date": "2019-04-17T16:57:26.749Z"
   }
   ```

1. 将这个文件保存在您将来可以访问的地方。随后，您可以使用这个文件来验证文档修订。
**重要**  
您稍后验证的文档修订必须包含在您保存的摘要中。也就是说，文档地址的序列号必须小于或等于**摘要提示地址**的序列号。

## QLDB API
<a name="verification.digest.api"></a>

您还可以使用 Amazon QLDB API 与相关的 AWS SDK 或者使用 AWS CLI，通过向您的分类帐请求摘要。QLDB API 提供以下操作以供应用程序使用：
+ [GetDigest](https://docs.aws.amazon.com/qldb/latest/developerguide/API_GetDigest.html) — 返回日记账中最新提交区块的分类账摘要。响应包括一个 256 位的哈希值和一个块地址。

有关使用请求摘要的信息 AWS CLI，请参阅《命令参考》中的 [get-diges](https://docs.aws.amazon.com/cli/latest/reference/qldb/get-digest.html) t *AWS CLI 命令*。

### 示例应用程序
<a name="verification.digest.api.sample"></a>

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

课堂中的教程代码[GetDigest](https://github.com/aws-samples/amazon-qldb-dmv-sample-java/blob/master/src/main/java/software/amazon/qldb/tutorial/GetDigest.java)提供了从`vehicle-registration`示例账本中请求摘要的示例。

要使用您保存的摘要验证文档修订，请继续执行 [步骤 2：在 QLDB 中验证您的数据](verification.verify.md)。