Étape 2 : Vérification de vos données dans QLDB

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

Amazon QLDB fournit un document API permettant de demander une preuve pour un identifiant de document spécifié et le bloc associé. Vous devez également fournir l'adresse du conseil d'un résumé que vous avez précédemment enregistré, comme décrit dansÉtape 1 : Demande d'un résumé dans QLDB. Vous pouvez utiliser le AWS Management Console AWS SDK, un ou le AWS CLI pour obtenir une preuve.

Vous pouvez ensuite utiliser la preuve renvoyée par QLDB pour vérifier la révision du document par rapport au résumé enregistré, en utilisant un système côté clientAPI. Cela vous permet de contrôler l'algorithme que vous utilisez pour vérifier vos données.

AWS Management Console

Cette section décrit les étapes à suivre pour vérifier la révision d'un document par rapport à un résumé enregistré précédemment à l'aide de la QLDB console Amazon.

Avant de commencer, assurez-vous de suivre les étapes décrites dansÉtape 1 : Demande d'un résumé dans QLDB. La vérification nécessite un résumé préalablement enregistré qui couvre la révision que vous souhaitez vérifier.

Pour vérifier la révision d'un document (console)

1. Ouvrez la QLDB console Amazon à l'adresse https://console.aws.amazon.com/qldb.

2. Tout d'abord, recherchez dans votre registre blockAddress la id et la révision que vous souhaitez vérifier. Ces champs sont inclus dans les métadonnées du document, que vous pouvez interroger dans la vue validée.

   Le document id est une chaîne d'identification unique attribuée par le système. blockAddressIl s'agit d'une structure ionique qui indique l'emplacement du bloc où la révision a été validée.

   Dans le volet de navigation, choisissez l'éditeur PartiQL.

3. Choisissez le nom du registre sous lequel vous souhaitez vérifier une révision.

4. Dans la fenêtre de l'éditeur de requêtes, entrez une SELECT instruction dans la syntaxe suivante, puis choisissez Exécuter.

   SELECT metadata.id, blockAddress FROM _ql_committed_table_name
   WHERE criteria

   Par exemple, la requête suivante renvoie un document à partir de la VehicleRegistration table du registre d'exemple créé dansCommencer à utiliser la QLDB console Amazon.

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

5. Copiez et enregistrez les blockAddress valeurs id et renvoyées par votre requête. Veillez à omettre les guillemets pour le id champ. Dans Amazon Ion, les types de données sous forme de chaîne sont délimités par des guillemets doubles. Par exemple, vous devez uniquement copier le texte alphanumérique dans l'extrait de code suivant.

   "LtMNJYNjSwzBLgf7sLifrG"

6. Maintenant qu'une révision de document est sélectionnée, vous pouvez commencer le processus de vérification.

   Dans le volet de navigation, choisissez Verification.

7. Sur le formulaire Vérifier le document, sous Spécifiez le document que vous souhaitez vérifier, entrez les paramètres d'entrée suivants :

   • Ledger — Le registre dans lequel vous souhaitez vérifier une révision.

   • Adresse du bloc : blockAddress valeur renvoyée par votre requête à l'étape 4.

   • ID du document : id valeur renvoyée par votre requête à l'étape 4.

8. Sous Spécifier le résumé à utiliser pour la vérification, sélectionnez le résumé que vous avez enregistré précédemment en choisissant Choisir le résumé. Si le fichier est valide, tous les champs du résumé sont automatiquement remplis sur votre console. Vous pouvez également copier et coller manuellement les valeurs suivantes directement à partir de votre fichier condensé :

   • Digest — La digest valeur de votre fichier de résumé.

   • Adresse du conseil de synthèse : digestTipAddress valeur de votre fichier de résumé.

9. Passez en revue les paramètres d'entrée de votre document et résumez, puis choisissez Vérifier.

   La console automatise deux étapes pour vous :

   1. Demandez un justificatif QLDB pour le document que vous avez spécifié.

   2. Utilisez la preuve renvoyée QLDB pour appeler un clientAPI, qui vérifiera la révision de votre document par rapport au résumé fourni. Pour examiner cet algorithme de vérification, consultez la section suivante QLDB API pour télécharger l'exemple de code.

   La console affiche les résultats de votre demande dans la fiche de résultats de vérification. Pour plus d’informations, consultez Résultats de vérification.

QLDB API

Vous pouvez également vérifier la révision d'un document en utilisant Amazon QLDB API avec un AWS SDK ou le AWS CLI. QLDBAPIfournit les opérations suivantes destinées à être utilisées par les programmes d'application :

• GetDigest— Renvoie le résumé d'un registre au dernier bloc validé du journal. La réponse inclut une valeur de hachage de 256 bits et une adresse de bloc.

• GetBlock— Renvoie un objet de type bloc à une adresse spécifiée dans un journal. Renvoie également une preuve du bloc spécifié pour vérification si elle DigestTipAddress est fournie.

• GetRevision— Renvoie un objet de données de révision pour un ID de document et une adresse de bloc spécifiés. Renvoie également une preuve de la révision spécifiée pour vérification si elle DigestTipAddress est fournie.

Pour une description complète de ces API opérations, consultez leQLDBAPIRéférence Amazon.

Pour plus d'informations sur la vérification des données à l'aide du AWS CLI, consultez la référence des AWS CLI commandes.

Exemple d'application

Pour des exemples de code Java, consultez le GitHub référentiel amazon-qldb-dmv-sampleaws-samples/ -java. Pour obtenir des instructions sur le téléchargement et l'installation de cet exemple d'application, consultezInstallation de l'exemple d'application Amazon QLDB Java. Avant de procéder à une vérification, assurez-vous de suivre les étapes 1 à 3 Tutoriel Java pour créer un registre d'échantillons et le charger avec des exemples de données.

Le code du didacticiel présenté en classe GetRevisionfournit un exemple de demande de preuve pour une révision de document, puis de vérification de cette révision. Cette classe exécute les étapes suivantes :

1. Demande un nouveau résumé à partir du registre vehicle-registration d'échantillons.

2. Demande une preuve pour un exemple de révision de document à partir du VehicleRegistration tableau du vehicle-registration registre.

3. Vérifie la révision de l'échantillon à l'aide du résumé et de la preuve renvoyés.