

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 5 : Afficher l'historique des révisions d'un document
<a name="getting-started-step-5"></a>

**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 registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Après avoir modifié les données d'immatriculation de la voiture avec le VIN` 1N4AL11D75C109151`, vous pouvez consulter l'historique de tous ses propriétaires enregistrés et tout autre champ mis à jour. Vous pouvez voir toutes les révisions d'un document que vous avez insérées, mises à jour et supprimées en interrogeant le module intégré[Fonction d'historique](working.history.md#working.history.function).

La fonction d'historique renvoie les révisions à partir de la *vue validée* de votre table, qui inclut à la fois les données de votre application et les métadonnées associées. Les métadonnées indiquent exactement quand chaque révision a été effectuée, dans quel ordre et quelle transaction les a validées.

Au cours de cette étape, vous recherchez l'historique des révisions d'un document dans le `VehicleRegistration` tableau du `vehicle-registration` grand livre.

**Pour consulter l'historique des révisions**

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

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

1. Choisissez le `vehicle-registration` registre.

1. Pour consulter l'historique d'un document, commencez par rechercher son caractère unique`id`. 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](working.metadata.by-clause.md).

   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'
   ```

1. 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 document`ADR2LQq48kB9neZDupQrMm`. 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).  
Dans QLDB, `SELECT` chaque requête est traitée dans le cadre d'une transaction et est soumise à un délai [d'](limits.md#limits.fixed)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](working.history.md#working.history.function).

   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 :  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/qldb/latest/developerguide/getting-started-step-5.html)
**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](getting-started-step-4.md).

1. 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 :  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/qldb/latest/developerguide/getting-started-step-5.html)

   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 (version`0`) a été créée à`2019-05-23T19:20:360d-3Z`.
   + Chaque transaction suivante crée une nouvelle révision avec le même document`id`, un numéro de version incrémenté et un `txId` et `txTime` mis à jour.

Pour vérifier une révision cryptographique d'un document dans le `vehicle-registration` registre, passez à. [Étape 6 : Vérifier un document dans un registre](getting-started-step-6.md)