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 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)
Öffnen Sie die QLDB Amazon-Konsole unter https://console.aws.amazon.com/qldb
. -
Führen Sie zunächst eine Abfrage Ihres Ledgers für die
id
und dieblockAddress
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. DasblockAddress
ist eine Ionen-Struktur, die den Blockspeicherort angibt, an dem die Revision übertragen wurde.Wählen Sie im Navigationsbereich PartiQL-Editor aus.
-
Wählen Sie den Namen des Ledgers, in dem Sie eine Revision überprüfen möchten.
-
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
WHEREcriteria
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-KonsoleSELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r WHERE r.data.VIN = 'KM8SRDHF6EU074761'
-
Kopieren und speichern Sie die
id
- undblockAddress
-Werte, die Ihre Abfrage zurückgibt. Achten Sie darauf, dass Sie die doppelten Anführungszeichen für dasid
-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
" -
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.
-
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.
-
-
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.
-
-
Ü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:
-
Fordern Sie ein Formular für einen Nachweis QLDB für das von Ihnen angegebene Dokument an.
-
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, wennDigestTipAddress
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, fallsDigestTipAddress
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/
Der Tutorial-Code in der Klasse GetRevision
-
Fordert einen neuen Digest aus dem Beispiel-Ledger
vehicle-registration
an. -
Fordert einen Nachweis für eine Beispiel-Dokumentrevision aus der Tabelle
VehicleRegistration
im Ledgervehicle-registration
an. -
Überprüft die Beispiel-Revision mithilfe des zurückgegebenen Digests und des Nachweises.