Schritt 2: Verifizieren Ihrer Daten in QLDB

Wichtig

Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter Migrieren eines Amazon QLDB Ledgers zu Amazon Aurora SQL Postgre.

Amazon QLDB bietet eine API Möglichkeit, einen Nachweis für eine bestimmte Dokument-ID und den zugehörigen Block anzufordern. Sie müssen zudem die Tip-Adresse eines zuvor gespeicherten Digests angeben, wie in Schritt 1: Einen Digest anfordern in QLDB beschrieben. Sie können das AWS Management Console, ein oder das verwenden AWS SDK, AWS CLI um einen Nachweis zu erhalten.

Anschließend können Sie den von zurückgesandten Nachweis verwendenQLDB, um die Revision des Dokuments anhand der gespeicherten Zusammenfassung auf einer API Clientseite zu überprüfen. Dadurch haben Sie die Kontrolle über den zum Überprüfen der Daten verwendeten Algorithmus.

AWS Management Console

In diesem Abschnitt werden die Schritte zur Überprüfung einer Dokumentrevision anhand einer zuvor gespeicherten Zusammenfassung mithilfe der QLDB Amazon-Konsole beschrieben.

Stellen Sie vor dem Starten sicher, dass Sie die Schritte in Schritt 1: Einen Digest anfordern in QLDB befolgen. Die Überprüfung erfordert einen zuvor gespeicherten Digest, der die Revision abdeckt, die Sie überprüfen möchten.

So überprüfen Sie eine Dokumentrevision (Konsole)

1. Öffnen Sie die QLDB Amazon-Konsole unter https://console.aws.amazon.com/qldb.

2. Führen Sie zunächst eine Abfrage Ihres Ledgers für die id und die blockAddress der Revision durch, die Sie verifizieren möchten. Diese Felder sind in den Metadaten des Dokuments enthalten. Sie können diese Abfrage in der bestätigten Ansicht vornehmen.

   Das Dokument id ist eine vom System zugewiesene eindeutige ID-Zeichenfolge. Das blockAddress ist eine Ionen-Struktur, die den Blockspeicherort angibt, an dem die Revision übertragen wurde.

   Wählen Sie im Navigationsbereich PartiQL-Editor aus.

3. Wählen Sie den Namen des Ledgers, in dem Sie eine Revision überprüfen möchten.

4. Geben Sie im Abfrage-Editor-Fenster eine SELECT-Anweisung in der folgenden Syntax ein und wählen Sie dann Run (Ausführen).

   SELECT metadata.id, blockAddress FROM _ql_committed_table_name
   WHERE criteria

   Die folgende Abfrage gibt beispielsweise ein Dokument aus der VehicleRegistration Tabelle im Beispielbuch zurück, das in erstellt wurde. Erste Schritte mit der QLDB Amazon-Konsole

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

5. Kopieren und speichern Sie die id- und blockAddress-Werte, die Ihre Abfrage zurückgibt. Achten Sie darauf, dass Sie die doppelten Anführungszeichen für das id-Feld auslassen. In Amazon Ion werden Zeichenfolge-Datentypen in doppelte Anführungszeichen gesetzt. Beispielsweise müssen Sie nur den alphanumerischen Text im folgenden Codeausschnitt kopieren.

   "LtMNJYNjSwzBLgf7sLifrG"

6. Nachdem Sie eine Dokumentrevision ausgewählt haben, können Sie damit beginnen, sie zu überprüfen.

   Wählen Sie im Navigationsbereich die Option Verification (Überprüfung) aus.

7. Geben Sie auf dem Formular Verify document (Dokument überprüfen) unter Specify the document that you want to verify (Das Dokument angeben, das Sie überprüfen möchten) die folgenden Eingabeparameter ein:

   • Ledger — Das Ledger, in dem Sie eine Revision verifizieren möchten.

   • Blockadresse — Der von Ihrer Abfrage in Schritt 4 zurückgegebene blockAddress Wert.

   • Dokument-ID — Der von Ihrer Abfrage in Schritt 4 zurückgegebene id Wert.

8. Wählen Sie unter Specify the document that you want to verify (Das Dokument angeben, das Sie überprüfen möchten) den Digest aus, den Sie zuvor gespeichert haben, indem Sie Choose digest (Digest auswählen) auswählen. Wenn die Datei gültig ist, werden alle Digest-Felder auf Ihrer Konsole automatisch gefüllt. Sie können die folgenden Werte auch manuell direkt aus Ihrer Digest-Datei kopieren und einfügen:

   • Digest — Der digest Wert aus Ihrer Digest-Datei.

   • Adresse des Digest-Tipps — Der digestTipAddress Wert aus Ihrer Digest-Datei.

9. Überprüfen Sie Ihre Dokument- und Digest-Eingabeparameter und wählen Sie anschließend Verify (Überprüfen) aus.

   Die Konsole automatisiert zwei Schritte für Sie:

   1. Fordern Sie ein Formular für einen Nachweis QLDB für das von Ihnen angegebene Dokument an.

   2. Verwenden Sie den von zurückgesandten Nachweis, QLDB um einen Kunden anzurufenAPI, der die Überarbeitung Ihres Dokuments anhand der bereitgestellten Zusammenfassung überprüft. Um diesen Überprüfungsalgorithmus zu untersuchen, laden Sie das Codebeispiel im folgenden Abschnitt QLDB API herunter.

   Die Konsole zeigt die Ergebnisse Ihrer Anforderung in der Karte Verification results (Überprüfungsergebnisse) an. Weitere Informationen finden Sie unter Ergebnisse der Überprüfung.

QLDB API

Sie können eine Dokumentrevision auch überprüfen, indem Sie Amazon QLDB API mit einem AWS SDK oder dem verwenden AWS CLI. Das QLDB API bietet die folgenden Operationen zur 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.

• GetBlock— Gibt ein Blockobjekt an einer angegebenen Adresse in einem Journal zurück. Gibt auch einen Nachweis für den angegebenen Block zur Überprüfung zurück, wenn DigestTipAddress bereitgestellt wird.

• GetRevision— Gibt ein Revisionsdatenobjekt für eine angegebene Dokument-ID und Blockadresse zurück. Gibt auch einen Nachweis der angegebenen Revision zur Überprüfung zurück, falls DigestTipAddress bereitgestellt wird.

Eine vollständige Beschreibung dieser API Operationen finden Sie imQLDBAPIAmazon-Referenz.

Informationen zur Überprüfung von Daten mit dem AWS CLI finden Sie in der AWS CLI Befehlsreferenz.

Beispielanwendung

Java-Codebeispiele finden Sie im GitHub Repository amazon-qldb-dmv-sampleaws-samples/ -java. Anweisungen zum Herunterladen und Installieren dieser Beispielanwendung finden Sie unter Installation der Amazon QLDB Java-Beispielanwendung. Bevor Sie eine Überprüfung durchführen, stellen Sie sicher, dass Sie die Schritte 1—3 unter So erstellen Sie ein Beispiel-Ledger und laden es mit Beispieldaten. Java-Lernprogramm

Der Tutorial-Code in der Klasse GetRevisionbietet ein Beispiel dafür, wie ein Nachweis für eine Dokumentenrevision angefordert und diese Revision anschließend überprüft wird. Diese Klasse führt die folgenden Schritte aus:

1. Fordert einen neuen Digest aus dem Beispiel-Ledger vehicle-registration an.

2. Fordert einen Nachweis für eine Beispiel-Dokumentrevision aus der Tabelle VehicleRegistration im Ledger vehicle-registration an.

3. Überprüft die Beispiel-Revision mithilfe des zurückgegebenen Digests und des Nachweises.