翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ステップ 1: でダイジェストをリクエストする QLDB
重要
サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon QLDB 台帳を Amazon Aurora Postgre に移行する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/qldb
で Amazon QLDBコンソールを開きます。 -
ナビゲーションペイン内で [Ledgers (台帳)] を選択します。
-
台帳のリストで、ダイジェストをリクエストする台帳名を選択します。
-
[Get digest (ダイジェストの取得)] を選択します。[Get digest (ダイジェストの取得)] ダイアログボックスに、以下のようなダイジェスト詳細が表示されます。
-
Digest – リクエストしたダイジェストの SHA-256 ハッシュ値。
-
[Digest tip address] (ダイジェストティップアドレス) - リクエストしたダイジェストの対象となっているジャーナル内の最新のブロック位置。アドレスには以下の 2 つのフィールドがあります。
-
strandId
- ブロックを含むジャーナルストランドの一意の ID。 -
sequenceNo
- ストランド内のブロックの位置を指定するインデックス番号。
-
-
[Ledger] (台帳) - ダイジェストをリクエストした台長名。
-
[Date] (日付) - ダイジェストをリクエストしたときのタイムスタンプ。
-
-
ダイジェスト情報を確認します。次に、[Save] (保存) を選択します。デフォルトのファイル名はそのままにしておくことも、新しい名前を入力することもできます。
注記
台帳内のデータに修正を加えていない場合でも、ダイジェストハッシュやティップアドレス値に変更が認められる場合があります。これは、PartiQL エディタでクエリを実行するたびに、コンソールによって台帳のシステムカタログが取得されるためです。これは読み取りトランザクションで、ジャーナルにコミットされ、最新ブロックアドレスの変更を引き起こします。
このステップでは、Amazon Ion 形式のコンテンツを含むプレーンテキストファイルが保存されます。このファイルには、
.ion.txt
のファイル名拡張子が付いており、前述のダイアログボックスに列挙されたすべてのダイジェスト情報が含まれています。以下は、ダイジェストファイルのコンテンツ例です。フィールドの順序はブラウザにより異なる場合があります。{ "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=", "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}", "ledger": "my-ledger", "date": "2019-04-17T16:57:26.749Z" }
-
後でアクセスできるよう、このファイルを保存しておきます。このファイルは、後でドキュメントリビジョンを検証する際に使用します。
重要
後に検証するドキュメントリビジョンは、保存したダイジェストによりカバーされているものでなければなりません。つまり、ドキュメントのアドレスのシーケンス番号は、[Digest tip address (ダイジェストティップアドレス)] のシーケンス番号以下であることが必要です。
QLDB API
AWS SDK または QLDBAPIで Amazon を使用して台帳からダイジェストをリクエストすることもできます AWS CLI。QLDB API では、アプリケーションプログラムで使用できるように、次の操作が用意されています。
-
GetDigest — ジャーナル内の最新のコミットされたブロックで台帳のダイジェストを返します。応答には、256 ビットのハッシュ値とブロックアドレスが含まれます。
を使用してダイジェストをリクエストする方法については AWS CLI、 AWS CLI コマンドリファレンス の get-digest コマンドを参照してください。
サンプルアプリケーション
Java コードの例については、 GitHub リポジトリ aws-samples/amazon-qldb-dmv-sample-java
クラス内のチュートリアルコードGetDigestvehicle-registration
サンプル台帳からダイジェストをリクエストする例を示しています。
保存したダイジェストを使用してドキュメントリビジョンを検証するには、「ステップ 2: でデータを検証する QLDB」に進みます。