Étape 5 : Afficher l'historique des révisions d'un document

Pour consulter l'historique des révisions

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

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

3. Choisissez le vehicle-registration registre.

4. Pour consulter l'historique d'un document, commencez par rechercher son caractère uniqueid. Outre l'interrogation de la vue validée, une autre méthode pour obtenir un document id consiste à utiliser le BY mot clé dans la vue utilisateur par défaut de la table. Pour en savoir plus, consultez Utilisation de la clause BY pour demander l'ID du document.

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

   SELECT r_id FROM VehicleRegistration AS r BY r_id
   WHERE r.VIN = '1N4AL11D75C109151'

5. Vous pouvez ensuite utiliser cette id valeur pour interroger la fonction d'historique. Entrez l'instruction suivante, puis choisissez Exécuter. Assurez-vous de remplacer la id valeur par votre propre identifiant de document, le cas échéant.

   SELECT h.data.VIN, h.data.City, h.data.Owners
   FROM history(VehicleRegistration) AS h
   WHERE h.metadata.id = 'ADR2LQq48kB9neZDupQrMm' --replace with your id

   Note

   Dans le cadre de ce didacticiel, cette requête d'historique renvoie toutes les révisions de l'identifiant du documentADR2LQq48kB9neZDupQrMm. Il est toutefois recommandé de qualifier une requête d'historique à la fois avec un identifiant de document et une plage de dates (heure de début et heure de fin).

   DansQLDB, chaque SELECT requête est traitée dans le cadre d'une transaction et est soumise à un délai d'expiration de transaction. Les requêtes d'historique qui incluent une heure de début et une heure de fin bénéficient de la qualification par plage de dates. Pour de plus amples informations, veuillez consulter Fonction d'historique.

   La fonction d'historique renvoie les documents dans le même schéma que la vue validée. Cet exemple projette les données d'immatriculation modifiées de votre véhicule. La sortie doit ressembler à ce qui suit :

   VIN	Ville	Propriétaires
   "1N4AL11D75C109151"	"Seattle"	{PrimaryOwner:{PersonId:""},SecondaryOwners:[]}
   "1N4AL11D75C109151"	"Seattle"	{PrimaryOwner:{PersonId:"294jJ3YUoH1IEEm8GSabOs"}, SecondaryOwners:[]}
   "1N4AL11D75C109151"	"Everett"	{PrimaryOwner:{PersonId:"7NmE8YLPbXc0IqesJy1rpR"}, SecondaryOwners:[]}
   "1N4AL11D75C109151"	"Everett"	{PrimaryOwner:{PersonId:"7NmE8YLPbXc0IqesJy1rpR"}, SecondaryOwners:[{PersonId:"5Ufgdlnj06gF5CWcOIu64s"}]}

   Note

   La requête d'historique peut ne pas toujours renvoyer les révisions des documents dans un ordre séquentiel.

   Passez en revue le résultat et vérifiez que les modifications reflètent ce que vous avez fait dansÉtape 4 : Modifier les documents d'un registre.

6. Vous pouvez ensuite inspecter les métadonnées du document pour chaque révision. Entrez l'instruction suivante, puis choisissez Exécuter. Encore une fois, veillez à remplacer la id valeur par votre propre identifiant de document, le cas échéant.

   SELECT VALUE h.metadata
   FROM history(VehicleRegistration) AS h
   WHERE h.metadata.id = 'ADR2LQq48kB9neZDupQrMm' --replace with your id

   La sortie doit ressembler à ce qui suit :

   version	id	txTime	txId
   0	"ADR2LQq48kB9neZDupQrMm"	2019-05-23T19:20:360d-3Z	"FMoVdWuPxJg3k466Iz4i75"
   1	"ADR2LQq48kB9neZDupQrMm"	2019-05-23T21:40:199d-3Z	"KWByxe842Xw8DNHcvARPOt"
   2	"ADR2LQq48kB9neZDupQrMm"	2019-05-23T21:44:432d-3Z	"EKwDOJRwbHpFvmAyJ2Kdh9"
   3	"ADR2LQq48kB9neZDupQrMm"	2019-05-23T21:49:254d-3Z	"96EiZd7vCmJ6RAvOvTZ4YA"

   Ces champs de métadonnées fournissent des détails sur le moment où chaque élément a été modifié et par quelle transaction. À partir de ces données, vous pouvez déduire ce qui suit :

   • Le document est identifié de manière unique par son assigné par le système id :. ADR2LQq48kB9neZDupQrMm Il s'agit d'un identifiant unique universel (UUID) représenté dans une chaîne codée en Base62.

   • Cela txTime indique que la révision initiale du document (version0) a été créée à2019-05-23T19:20:360d-3Z.

   • Chaque transaction suivante crée une nouvelle révision avec le même documentid, un numéro de version incrémenté et un txId et txTime mis à jour.