Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
É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.
Rubriques
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)
Ouvrez la QLDB console Amazon à l'adresse https://console.aws.amazon.com/qldb
. -
Tout d'abord, recherchez dans votre registre
blockAddress
laid
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.blockAddress
Il 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.
-
Choisissez le nom du registre sous lequel vous souhaitez vérifier une révision.
-
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
WHEREcriteria
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'
-
Copiez et enregistrez les
blockAddress
valeursid
et renvoyées par votre requête. Veillez à omettre les guillemets pour leid
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
" -
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.
-
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.
-
-
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é.
-
-
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 :
-
Demandez un justificatif QLDB pour le document que vous avez spécifié.
-
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 elleDigestTipAddress
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 elleDigestTipAddress
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/
Le code du didacticiel présenté en classe GetRevision
-
Demande un nouveau résumé à partir du registre
vehicle-registration
d'échantillons. -
Demande une preuve pour un exemple de révision de document à partir du
VehicleRegistration
tableau duvehicle-registration
registre. -
Vérifie la révision de l'échantillon à l'aide du résumé et de la preuve renvoyés.