ステップ 1: でダイジェストをリクエストする QLDB - Amazon Quantum 台帳データベース (Amazon QLDB）
AWS Management ConsoleQLDB API

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ステップ 1: でダイジェストをリクエストする QLDB

重要

サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon Ledger QLDB を Amazon Aurora Postgre に移行するSQL」を参照してください。

Amazon QLDBは、台帳内のジャーナルの現在のヒントをカバーするダイジェストをリクエストAPIするための を提供しています。ジャーナルのヒントは、 がリクエストQLDBを受信したときの最新のコミット済みブロックを参照します。 AWS Management Console、、または AWS Command Line Interface （AWS CLI) を使用して AWS SDKダイジェストを取得できます。

AWS Management Console

QLDB コンソールを使用してダイジェストをリクエストするには、次の手順に従います。

ダイジェストをリクエストするには (コンソール)

  1. にサインインし AWS Management Console、https://console.aws.amazon.com/qldb で Amazon QLDBコンソールを開きます。

  2. ナビゲーションペイン内で [Ledgers (台帳)] を選択します。

  3. 台帳のリストで、ダイジェストをリクエストする台帳名を選択します。

  4. [Get digest (ダイジェストの取得)] を選択します。[Get digest (ダイジェストの取得)] ダイアログボックスに、以下のようなダイジェスト詳細が表示されます。

    • Digest – リクエストしたダイジェストの SHA-256 ハッシュ値。

    • [Digest tip address] (ダイジェストティップアドレス) - リクエストしたダイジェストの対象となっているジャーナル内の最新のブロック位置。アドレスには以下の 2 つのフィールドがあります。

      • strandId - ブロックを含むジャーナルストランドの一意の ID。

      • sequenceNo - ストランド内のブロックの位置を指定するインデックス番号。

    • [Ledger] (台帳) - ダイジェストをリクエストした台長名。

    • [Date] (日付) - ダイジェストをリクエストしたときのタイムスタンプ。

  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. 後でアクセスできるよう、このファイルを保存しておきます。このファイルは、後でドキュメントリビジョンを検証する際に使用します。

    重要

    後に検証するドキュメントリビジョンは、保存したダイジェストによりカバーされているものでなければなりません。つまり、ドキュメントのアドレスのシーケンス番号は、[Digest tip address (ダイジェストティップアドレス)] のシーケンス番号以下であることが必要です。

QLDB API

QLDB API AWS SDK または で Amazon を使用して台帳からダイジェストをリクエストすることもできます AWS CLI。QLDB API では、アプリケーションプログラムで使用できるように、次のオペレーションが用意されています。

  • GetDigest – ジャーナル内の最後にコミットされたブロックにある台帳のダイジェストを返します。応答には、256 ビットのハッシュ値とブロックアドレスが含まれます。

を使用してダイジェストをリクエストする方法については AWS CLI、 AWS CLI コマンドリファレンス の get-digest コマンドを参照してください。

サンプルアプリケーション

Java コードの例については、 GitHub リポジトリ aws-samples/amazon-qldb-dmv-sample-java を参照してください。このサンプルアプリケーションをダウンロードしてインストールする方法については、「Amazon QLDBJava サンプルアプリケーションのインストール」を参照してください。ダイジェストをリクエストする前に、「Java チュートリアル」のステップ 1～3 を実行し、サンプル台帳を作成して、サンプルデータを使用してロードしてください。

クラス のチュートリアルコードGetDigestは、vehicle-registrationサンプル台帳からダイジェストをリクエストする例を示しています。

保存したダイジェストを使用してドキュメントリビジョンを検証するには、「ステップ 2: でデータを検証する QLDB」に進みます。