本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
第 1 步:请求摘要 QLDB
重要
终止支持通知:现有客户将能够使用亚马逊,QLDB直到 2025 年 7 月 31 日终止支持。有关更多详细信息,请参阅将亚马逊QLDB账本迁移到亚马逊 Aurora Postgr SQL
Amazon QLDB 提供了一个API可以请求的摘要,该摘要涵盖了您账本中当前日记账的提示。日志提示是指截至QLDB收到您的请求时最近提交的区块。您可以使用 AWS Management Console,一个 AWS SDK,或者 AWS Command Line Interface (AWS CLI) 来获取摘要。
AWS Management Console
按照以下步骤使用QLDB控制台请求摘要。
请求摘要(控制台)
登录 AWS Management Console,然后在 https://console.aws.amazon.com/ql
db 上打开亚马逊QLDB控制台。 -
在导航窗格中,选择分类账。
-
在分类账列表中,选择要申请摘要的分类账名称。
-
选择“获取摘要”。获取摘要对话框显示以下摘要详细信息:
-
摘要-您请求的摘要的 SHA -256 哈希值。
-
摘要提示地址 - 您请求的摘要所涵盖的日记中的最新区块位置。地址包含以下两个字段:
-
strandId
— 包含数据块的日记账链的唯一 ID。 -
sequenceNo
— 一个索引号,用于指定数据块在链中的位置。
-
-
分类账 - 您请求摘要的分类账名称。
-
日期 - 您请求摘要时的时间戳。
-
-
检查摘要信息。然后选择 Save(保存)。您可以保留默认文件名,或输入新名称。
注意
您可能会注意到,即使您不修改分类账中的任何数据,您的摘要散列值和提示地址值也会发生变化。这是因为每次在 PartiQL 编辑器中运行查询时,控制台都会检索分类账的系统目录。这是向日记账提交的读事务,会导致最新区块地址发生变化。
此步骤将保存一个内容为 Amazon Ion 格式的纯文本文件。该文件的文件扩展名为
.ion.txt
,包含前面对话框中列出的所有摘要信息。以下是摘要内容的示例。字段的顺序可能因您的浏览器而异。{ "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=", "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}", "ledger": "my-ledger", "date": "2019-04-17T16:57:26.749Z" }
-
将这个文件保存在您将来可以访问的地方。随后,您可以使用这个文件来验证文档修订。
重要
您稍后验证的文档修订必须包含在您保存的摘要中。也就是说,文档地址的序列号必须小于或等于摘要提示地址的序列号。
QLDB API
您也可以使用QLDBAPI带有 Amazon 的账本请求摘要 AWS SDK或者 AWS CLI。 QLDBAPI提供了以下操作供应用程序使用:
-
GetDigest— 返回日记账中最新提交区块的账本摘要。响应包括一个 256 位的哈希值和一个块地址。
有关使用请求摘要的信息 AWS CLI,请参阅中的 get-diges t 命令 AWS CLI 命令参考。
示例应用程序
有关 Java 代码示例,请参阅 GitHub 存储库 a ws-samples/-amazon-qldb-dmv-sample
课堂中的教程代码GetDigestvehicle-registration
示例账本中请求摘要的示例。
要使用您保存的摘要验证文档修订,请继续执行 第 2 步:在中验证您的数据 QLDB。