ステップ 2: でデータを検証する QLDB

ドキュメントリビジョンを検証するには (コンソール)

1. https://console.aws.amazon.com/qldb で Amazon QLDBコンソールを開きます。

2. 最初に、検証するリビジョンの id と blockAddress に関するクエリを台帳に対して実行します。これらのフィールドはドキュメントのメタデータに含まれており、コミット済みビューでクエリを実行できます。

   ドキュメント id は、システムによって割り当てられた一意の ID 文字列です。blockAddress は、リビジョンがコミットされたブロックの位置を指定する Ion 構造です。

   ナビゲーションペイン内で [PartiQL エディタ] を選択します。

3. リビジョンを検証する台帳名を選択します。

4. クエリエディタウィンドウ内で SELECT 文を下記の構文に入力し、[Run (実行)] を選択します。

   SELECT metadata.id, blockAddress FROM _ql_committed_table_name
   WHERE criteria

   例えば、以下のクエリは、「Amazon QLDBコンソールの開始方法」で作成されたサンプル台帳の VehicleRegistration テーブルのドキュメントを返します。

   SELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r 
   WHERE r.data.VIN = 'KM8SRDHF6EU074761'

5. クエリによって返された id と blockAddress の値をコピーし、保存します。id フィールドの二重引用符は必ず省略してください。Amazon Ion では、文字列データ型は二重引用符で区切られます。たとえば、以下のスニペットでは、英数文字のテキストのみをコピーする必要があります。

   "LtMNJYNjSwzBLgf7sLifrG"

6. これでドキュメントリビジョンが選択されたため、検証プロセスを開始できます。

   ナビゲーションペイン内で [Verification (検証)] を選択します。

7. [Verify document (ドキュメントの検証)] フォームの [Specify the document that you want to verify (検証するドキュメントの指定)] に、次の入力パラメータを入力します。

   • [Ledger] (台帳) - リビジョンを検証する台帳。

   • [ブロックアドレス] - ステップ 4 のクエリで返された blockAddress 値。

   • [ドキュメント ID] - ステップ 4 のクエリで返された id 値。

8. [Specify the digest to use for verification (検証に使用するダイジェストの指定)] で、[Choose digest (ダイジェストの選択)] を選択することで、以前に保存されたダイジェストを選択します。ファイルが有効であれば、コンソールにあるすべてのダイジェストフィールドにデータが自動入力されます。また、以下の値をダイジェストファイルから手動で直接コピーして貼り付けることもできます。

   • [Digest] (ダイジェスト) - ダイジェストファイルからの digest 値。

   • [Digest tip address] (ダイジェストティップアドレス) - ダイジェストファイルからの digestTipAddress 値。

9. ドキュメントおよびダイジェストの入力パラメータを再確認し、[Verify (検証)] を選択します。

   コンソールが次の 2 つのステップを自動的に実行します。

   1. 指定したドキュメントQLDBの証明を にリクエストします。

   2. によって返された証明を使用してQLDB、クライアント側の を呼び出します。これによりAPI、提供されたダイジェストに対してドキュメントリビジョンが検証されます。この検証のアルゴリズムを調べるには、以下のセクション「QLDB API」を参照し、サンプルコードをダウンロードしてください。

   コンソールの [Verification results (検証結果)] カードに、リクエストの結果が表示されます。詳細については、「検証結果」を参照してください。