Schritt 1: Einen Digest in QLDB anfordern - Amazon Quantum Ledger Database (Amazon QLDB)
AWS Management ConsoleQLDB-API

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Schritt 1: Einen Digest in QLDB anfordern

Amazon QLDB bietet eine API, mit der Sie eine Zusammenfassung anfordern können, die den aktuellen Tipp des Journals in Ihrem Hauptbuch abdeckt. Der Tipp des Journals bezieht sich auf den letzten festgeschriebenen Block zu dem Zeitpunkt, zu dem QLDB Ihre Anfrage erhält. Sie können das AWS Management Console, ein AWS SDK oder das AWS Command Line Interface (AWS CLI) verwenden, um eine Zusammenfassung zu erhalten.

AWS Management Console

Gehen Sie wie folgt vor, um über die QLDB-Konsole einen Digest anzufordern.

So fordern Sie einen Digest an (Konsole)

  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon QLDB-Konsole unter https://console.aws.amazon.com/qldb.

  2. Wählen Sie im Navigationsbereich Ledgers aus.

  3. Wählen Sie in der Liste der Ledgers den Ledger-Namen, für den Sie einen Digest anfordern möchten.

  4. Wählen Sie Get digest (Digest abrufen). Dasm Dialogfeld Get digest (Digest abrufen) zeigt die folgenden Digest-Details:

    • Digest — Der SHA-256-Hashwert des Digests, den Sie angefordert haben.

    • Adresse des Digest-Tipps — Die letzte Blockposition im Journal, auf die sich der von Ihnen angeforderte Digest bezieht. Eine Adresse hat die folgenden zwei Felder:

      • strandId— Die eindeutige ID des Journalstrangs, der den Block enthält.

      • sequenceNo— Die Indexnummer, die die Position des Blocks innerhalb des Strangs angibt.

    • Ledger — Der Ledger-Name, für den Sie einen Digest angefordert haben.

    • Datum — Der Zeitstempel, zu dem Sie den Digest angefordert haben.

  5. Überprüfen Sie die Digest-Informationen. Wählen Sie dann Speichern. Sie können den Standard-Dateinamen behalten oder einen neuen Namen eingeben.

    Anmerkung

    Möglicherweise stellen Sie fest, dass sich Ihre Digest-Hash-Adresswerte ändern, auch wenn Sie keine Daten in Ihrem Ledger ändern. Dies liegt daran, dass die Konsole den Systemkatalog des Ledgers jedes Mal abruft, wenn Sie eine Abfrage im PartiQL-Editor ausführen. Hierbei handelt es sich um eine Read-Transaktion, die an das Journal übertragen wird. Dies führt dazu, dass sich die neueste Block-Adresse ändert.

    Dieser Schritt speichert eine Klartext-Datei mit Inhalten im Amazon Ion-Format. Die Datei verfügt über die Dateinamenerweiterung .ion.txt und enthält alle Digest-Informationen, die im vorherigen Dialogfeld aufgelistet wurden. Im Folgenden finden Sie ein Beispiel für die Inhalte einer Digest-Datei. Die Reihenfolge der Felder kann je nach Browser variieren.

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

  6. Speichern Sie diese Datei an einem Ort, an dem Sie später darauf zugreifen können. Später können Sie diese Datei verwenden, um die Revision eines Dokuments anhand dieser Datei zu überprüfen.

    Wichtig

    Die Dokumentrevision, die Sie zu einem späteren Zeitpunkt überprüfen, muss von dem von Ihnen gespeicherten Digest abgedeckt werden. Das bedeutet, dass die Sequenznummer der Adresse des Dokuments kleiner oder gleich der Sequenznummer der Digest tip address (Digest-Tip-Adresse) sein muss.

QLDB-API

Sie können auch einen Digest aus Ihrem Ledger anfordern, indem Sie die Amazon QLDB-API mit einem AWS SDK oder dem verwenden. AWS CLI Die QLDB-API bietet den folgenden Vorgang für die Verwendung durch Anwendungsprogramme:

  • GetDigest— Gibt den Digest eines Ledgers für den letzten festgeschriebenen Block im Journal zurück. Die Antwort enthält einen 256-Bit-Hashwert und eine Blockadresse.

Informationen zum Anfordern eines Digests mithilfe von finden Sie in der AWS CLI Befehlsreferenz unter dem Befehl get-digest.AWS CLI

Beispielanwendung

Java-Codebeispiele finden Sie im GitHub Repository aws-samples/ -java. amazon-qldb-dmv-sample Anweisungen zum Herunterladen und Installieren dieser Beispielanwendung finden Sie unter Installation der Amazon QLDB Java-Beispielanwendung. Bevor Sie eine Zusammenfassung anfordern, stellen Sie sicher, dass Sie die Schritte 1—3 unter So erstellen Sie ein Musterbuch und laden Java-Anleitung es mit Beispieldaten.

Der Tutorial-Code in der Klasse GetDigestbietet ein Beispiel für das Anfordern eines Digest aus dem Beispiel-Ledger. vehicle-registration

Zum Überprüfen einer Dokumentrevision mithilfe des gespeicherten Digests fahren Sie mit Schritt 2: Verifizierung Ihrer Daten in QLDB fort.