

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.

# Commencer à utiliser la console Amazon QLDB
<a name="getting-started"></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/).

Ce didacticiel vous explique les étapes à suivre pour créer votre premier registre Amazon QLDB et le remplir avec des tables et des exemples de données. L'exemple de registre que vous créez dans ce scénario est une base de données pour une application du département des véhicules automobiles (DMV) qui permet de suivre les informations historiques complètes sur les immatriculations de véhicules.

L'historique d'un actif est un cas d'utilisation courant pour QLDB car il implique une variété de scénarios et d'opérations qui mettent en évidence l'utilité d'une base de données de registre. Avec QLDB, vous pouvez accéder, interroger et vérifier directement l'historique complet des modifications apportées à vos données dans une base de données orientée document qui prend en charge les fonctionnalités de requête de type SQL.

Au cours de ce didacticiel, les rubriques suivantes expliquent comment ajouter des immatriculations de véhicules, les modifier et consulter l'historique des modifications apportées à ces immatriculations. Ce guide explique également comment vérifier un document d'enregistrement de manière cryptographique et conclut en nettoyant les ressources et en supprimant le registre d'échantillons.

Chaque étape du didacticiel contient des instructions d'utilisation du AWS Management Console.

**Topics**
+ [

# Conditions préalables et considérations relatives au didacticiel
](getting-started.prereqs.md)
+ [

# Étape 1 : Création d'un nouveau registre
](getting-started-step-1.md)
+ [

# Étape 2 : créer des tables, des index et des exemples de données dans un registre
](getting-started-step-2.md)
+ [

# Étape 3 : interroger les tables d'un registre
](getting-started-step-3.md)
+ [

# Étape 4 : Modifier les documents d'un registre
](getting-started-step-4.md)
+ [

# Étape 5 : Afficher l'historique des révisions d'un document
](getting-started-step-5.md)
+ [

# Étape 6 : Vérifier un document dans un registre
](getting-started-step-6.md)
+ [

# Étape 7 (optionnelle) : Nettoyer les ressources
](getting-started-step-7.md)
+ [

# Démarrage avec Amazon QLDB : prochaines étapes
](getting-started-next-steps.md)

# Conditions préalables et considérations relatives au didacticiel
<a name="getting-started.prereqs"></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/).

Avant de commencer ce didacticiel Amazon QLDB, assurez-vous de remplir les conditions préalables suivantes :

1. Suivez les instructions de AWS configuration [Accès à Amazon QLDB](accessing.md) indiquées dans, si ce n'est déjà fait. Ces étapes incluent l'inscription AWS et la création d'un utilisateur administratif.

1. Suivez les instructions ci-dessous [Configurer les autorisations](#getting-started.prereqs.permissions) pour configurer les autorisations IAM pour vos ressources QLDB. Pour effectuer toutes les étapes de ce didacticiel, vous devez disposer d'un accès administratif complet aux ressources de votre registre via le AWS Management Console.
**Note**  
Si vous êtes déjà connecté en tant qu'utilisateur disposant de toutes les autorisations AWS administratives, vous pouvez ignorer cette étape.

1. (Facultatif) QLDB chiffre les données au repos à l'aide d'une clé dans (). AWS Key Management Service AWS KMS Vous pouvez choisir l'un des types suivants AWS KMS keys :
   + **AWS clé KMS détenue** — Utilisez une clé KMS détenue et gérée par AWS vous. Il s'agit de l'option par défaut qui ne nécessite aucune configuration supplémentaire.
   + **Clé KMS gérée par le client** : utilisez une clé KMS de chiffrement symétrique dans le compte que vous créez, possédez et gérez. [QLDB ne prend pas en charge les clés asymétriques.](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html)

     Cette option vous oblige à créer une clé KMS ou à utiliser une clé existante dans votre compte. Pour obtenir des instructions sur la création d'une clé gérée par le client, consultez la section [Création de clés KMS de chiffrement symétriques](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html#create-symmetric-cmk) dans le *guide du AWS Key Management Service développeur*.

     Vous pouvez spécifier une clé KMS gérée par le client à l'aide d'un ID, d'un alias ou d'un Amazon Resource Name (ARN). Pour en savoir plus, consultez la section [Identifiants clés (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id) dans le *guide du AWS Key Management Service développeur*.
**Note**  
Les clés inter-régions ne sont pas prises en charge. La clé KMS spécifiée doit être identique Région AWS à celle de votre registre.

## Configurer les autorisations
<a name="getting-started.prereqs.permissions"></a>

Au cours de cette étape, vous configurez des autorisations d'accès complètes via la console pour toutes les ressources QLDB de votre. Compte AWS Pour accorder ces autorisations rapidement, utilisez la politique AWS gérée [Amazon QLDBConsole FullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonQLDBConsoleFullAccess).

Pour activer l’accès, ajoutez des autorisations à vos utilisateurs, groupes ou rôles :
+ Utilisateurs et groupes dans AWS IAM Identity Center :

  Créez un jeu d’autorisations. Suivez les instructions de la rubrique [Création d’un jeu d’autorisations](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtocreatepermissionset.html) du *Guide de l’utilisateur AWS IAM Identity Center *.
+ Utilisateurs gérés dans IAM par un fournisseur d’identité :

  Créez un rôle pour la fédération d’identité. Suivez les instructions de la rubrique [Création d’un rôle pour un fournisseur d’identité tiers (fédération)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp.html) dans le *Guide de l’utilisateur IAM*.
+ Utilisateurs IAM :
  + Créez un rôle que votre utilisateur peut assumer. Suivez les instructions de la rubrique [Création d’un rôle pour un utilisateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html) dans le *Guide de l’utilisateur IAM*.
  + (Non recommandé) Attachez une politique directement à un utilisateur ou ajoutez un utilisateur à un groupe d’utilisateurs. Suivez les instructions de la rubrique [Ajout d’autorisations à un utilisateur (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) du *Guide de l’utilisateur IAM*.

**Important**  
Dans le cadre de ce didacticiel, vous vous accordez un accès administratif complet à toutes les ressources QLDB. Toutefois, pour les cas d'utilisation en production, suivez les meilleures pratiques de sécurité qui consistent à [accorder le moindre privilège](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) ou à n'accorder que les autorisations requises pour effectuer une tâche. Pour obtenir des exemples, consultez [Exemples de politiques basées sur l'identité pour Amazon QLDB](security_iam_id-based-policy-examples.md).

Pour créer un registre nommé`vehicle-registration`, passez à[Étape 1 : Création d'un nouveau registre](getting-started-step-1.md).

# Étape 1 : Création d'un nouveau registre
<a name="getting-started-step-1"></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/).

Au cours de cette étape, vous allez créer un nouveau registre Amazon QLDB nommé. `vehicle-registration` Ensuite, vous confirmez que le statut du registre est **Actif**. Vous pouvez également vérifier les balises que vous avez ajoutées au registre.

Lorsque vous créez un registre, la *protection contre les suppressions* est activée par défaut. La protection contre la suppression est une fonctionnalité de QLDB qui empêche les registres d'être supprimés par un utilisateur. Vous pouvez désactiver la protection contre la suppression lorsque vous créez un registre à l'aide de l'API QLDB ou du (). AWS Command Line Interface AWS CLI

**Pour créer un nouveau registre**

1. [Connectez-vous à la AWS Management Console console Amazon QLDB et ouvrez-la à l'adresse /qldb. https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)

1. Dans le volet de navigation, choisissez **Getting started**.

1. Sur la page **Créer votre première carte de registre**, choisissez **Créer un registre**.

1. Sur la page **Créer un registre**, procédez comme suit :
   + **Informations sur le registre** — Le **nom du registre** doit être prérempli avec. **vehicle-registration**
   + **Mode autorisations** : mode d'autorisations à attribuer au registre. Choisissez l’une des options suivantes :
     + **Tout autoriser** : ancien mode d'autorisation qui permet le contrôle d'accès avec une granularité au niveau de l'API pour les registres.

       Ce mode permet aux utilisateurs qui possèdent l'autorisation d'API `SendCommand` pour ce registre d'exécuter toutes les commandes PartiQL (par conséquent, `ALLOW_ALL`) sur toutes les tables du registre spécifié. Ce mode ignore les politiques d'autorisations IAM au niveau de la table ou de la commande que vous créez pour le registre.
     + **Standard** — (*recommandé*) Mode d'autorisation qui permet le contrôle d'accès avec une granularité plus fine pour les registres, les tables et les commandes partiQL. Nous vous recommandons vivement d'utiliser ce mode d'autorisation afin de maximiser la sécurité des données de votre registre.

       Par défaut, ce mode refuse toutes les demandes d'exécution de commandes partiQL sur les tables de ce registre. Pour autoriser les commandes partiQL, vous devez créer des politiques d'autorisation IAM pour des ressources de table et des actions partiQL spécifiques, en plus de l'autorisation d'`SendCommand`API pour le registre. Pour plus d’informations, veuillez consulter [Commencer à utiliser le mode d'autorisation standard dans Amazon QLDB](getting-started-standard-mode.md).
   + **Chiffrer les données au repos** : clé in AWS Key Management Service (AWS KMS) à utiliser pour le chiffrement des données au repos. Choisissez l’une des options suivantes :
     + **Utiliser AWS une clé** KMS détenue et gérée par AWS vous. Il s'agit de l'option par défaut qui ne nécessite aucune configuration supplémentaire.
     + **Choisissez une autre AWS KMS clé** : utilisez une clé KMS de chiffrement symétrique dans le compte que vous créez, possédez et gérez.

       Pour créer une nouvelle clé à l'aide de la AWS KMS console, choisissez **Créer une AWS KMS clé**. Pour plus d'informations, consultez [Création de clés KMS de chiffrement symétriques](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html#create-symmetric-cmk) dans le *Guide du développeur AWS Key Management Service *.

       Pour utiliser une clé KMS existante, choisissez-en une dans la liste déroulante ou spécifiez un ARN de clé KMS.
   + **Balises** — (Facultatif) Ajoutez des métadonnées au registre en attachant des balises sous forme de paires clé-valeur. Vous pouvez ajouter des balises à votre registre pour mieux les organiser et les identifier. Pour de plus amples informations, veuillez consulter [Balisage des ressources Amazon QLDB](tagging.md).

     Choisissez **Ajouter une balise**, puis entrez les paires clé-valeur appropriées.

1. Lorsque les paramètres sont tels que vous le souhaitez, choisissez **Create ledger**.
**Note**  
**Vous pouvez accéder à votre registre QLDB lorsque son statut devient Actif.** Cela peut prendre plusieurs minutes.

1. **Dans la liste des **registres**, recherchez `vehicle-registration` et confirmez que le statut du registre est Actif.**

1. (Facultatif) Choisissez le nom du `vehicle-registration` registre. **Sur la page des détails du registre **d'immatriculation des véhicules**, vérifiez que toutes les étiquettes que vous avez ajoutées au registre apparaissent sur la carte Tags.** Vous pouvez également modifier vos balises de registre à l'aide de cette page de console.

Pour créer des tables dans le `vehicle-registration` registre, passez à[Étape 2 : créer des tables, des index et des exemples de données dans un registre](getting-started-step-2.md).

# Étape 2 : créer des tables, des index et des exemples de données dans un registre
<a name="getting-started-step-2"></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/).

Lorsque votre registre Amazon QLDB est actif, vous pouvez commencer à créer des tableaux contenant les données relatives aux véhicules, à leurs propriétaires et à leurs informations d'enregistrement. Après avoir créé les tables et les index, vous pouvez les charger avec des données.

Au cours de cette étape, vous créez quatre tables dans le `vehicle-registration` registre :
+ `VehicleRegistration`
+ `Vehicle`
+ `Person`
+ `DriversLicense`

Vous créez également les index suivants.


****  

| Nom de la table | Champ | 
| --- | --- | 
| VehicleRegistration | VIN | 
| VehicleRegistration | LicensePlateNumber | 
| Vehicle | VIN | 
| Person | GovId | 
| DriversLicense | LicensePlateNumber | 
| DriversLicense | PersonId | 

Vous pouvez utiliser la console QLDB pour créer automatiquement ces tables avec des index et les charger avec des exemples de données. [Vous pouvez également utiliser l'**éditeur partiQL** de la console pour exécuter manuellement chaque instruction partiQL.](ql-reference.md) step-by-step

## Option automatique
<a name="getting-started-step-2.con-auto"></a>

**Pour créer des tables, des index et des exemples de données**

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 **Getting started**.

1. Sous l'**option Automatique** sur la carte de **données de l'application Sample**, choisissez `vehicle-registration` dans la liste des registres.

1. Choisissez **Charger un échantillon de données**.

   Si l'opération aboutit, la console affiche le message **Sample data loaded**.

   Ce script exécute toutes les instructions en une seule transaction. Si une partie de la transaction échoue, chaque instruction est annulée et un message d'erreur approprié s'affiche. Vous pouvez recommencer l'opération une fois le problème résolu.
**Note**  
L'une des causes possibles de l'échec d'une transaction est la tentative de création de tables dupliquées. Votre demande de chargement d'échantillons de données échouera si l'un des noms de table suivants existe déjà dans votre registre :`VehicleRegistration`, `Vehicle``Person`, et`DriversLicense`.  
Essayez plutôt de charger ces exemples de données dans un registre vide.
Ce script exécute des instructions paramétrées. `INSERT` Ces instructions partiQL sont donc enregistrées dans vos blocs de journal avec des paramètres de liaison au lieu des données littérales. Par exemple, vous pouvez voir l'instruction suivante dans un bloc de journal, où le point d'interrogation (`?`) est un espace réservé variable pour le contenu du document.  

     ```
     INSERT INTO Vehicle ?
     ```

## Option manuelle
<a name="getting-started-step-2.con"></a>

Vous insérez des documents dans `VehicleRegistration` un `PrimaryOwner` champ vide et dans `DriversLicense` un `PersonId` champ vide. Ensuite, vous renseignez ces champs avec le document attribué par le système à `id` partir du tableau. `Person`

**Astuce**  
Il est recommandé d'utiliser ce champ de `id` métadonnées du document comme clé étrangère. Pour de plus amples informations, veuillez consulter [Interrogation des métadonnées d'un document](working.metadata.md).

**Pour créer des tables, des index et des exemples de données**

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. Commencez par créer quatre tables. QLDB prend en charge le contenu ouvert et n'applique pas le schéma. Vous ne spécifiez donc pas d'attributs ou de types de données.

   Dans la fenêtre de l'éditeur de requêtes, entrez l'instruction suivante, puis choisissez **Exécuter**. Pour exécuter l'instruction, vous pouvez également utiliser le raccourci clavier Ctrl \$1 Enter pour Windows ou Cmd \$1 Return pour macOS. Pour plus de raccourcis clavier, voir[Raccourcis clavier de l'éditeur PartiQL](console_QLDB.md#console_QLDB.partiql-editor-shortcuts).

   ```
   CREATE TABLE VehicleRegistration
   ```

   Répétez cette étape pour chacune des opérations suivantes.

   ```
   CREATE TABLE Vehicle
   ```

   ```
   CREATE TABLE Person
   ```

   ```
   CREATE TABLE DriversLicense
   ```

1. Créez ensuite des index qui optimisent les performances des requêtes pour chaque table.
**Important**  
QLDB a besoin d'un index pour rechercher efficacement un document. Sans index, QLDB doit effectuer une analyse complète de la table lors de la lecture de documents. Cela peut entraîner des problèmes de performances sur de grandes tables, notamment des conflits de simultanéité et des délais d'expiration des transactions.  
Pour éviter de scanner des tables, vous devez exécuter des instructions contenant une clause de `WHERE` prédicat à l'aide d'un opérateur d'*égalité* (`=`ou`IN`) sur un champ indexé ou un identifiant de document. Pour de plus amples informations, veuillez consulter [Optimisation des performances des requêtes](working.optimize.md).

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

   ```
   CREATE INDEX ON VehicleRegistration (VIN)
   ```

   Répétez cette étape pour les opérations suivantes.

   ```
   CREATE INDEX ON VehicleRegistration (LicensePlateNumber)
   ```

   ```
   CREATE INDEX ON Vehicle (VIN)
   ```

   ```
   CREATE INDEX ON Person (GovId)
   ```

   ```
   CREATE INDEX ON DriversLicense (LicensePlateNumber)
   ```

   ```
   CREATE INDEX ON DriversLicense (PersonId)
   ```

1. Après avoir créé vos index, vous pouvez commencer à charger des données dans vos tables. Au cours de cette étape, insérez dans le `Person` tableau des documents contenant des informations personnelles sur les propriétaires des véhicules suivis par le registre.

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

   ```
   INSERT INTO Person
   << {
       'FirstName' : 'Raul',
       'LastName' : 'Lewis',
       'DOB' : `1963-08-19T`,
       'GovId' : 'LEWISR261LL',
       'GovIdType' : 'Driver License',
       'Address' : '1719 University Street, Seattle, WA, 98109'
   },
   {
       'FirstName' : 'Brent',
       'LastName' : 'Logan',
       'DOB' : `1967-07-03T`,
       'GovId' : 'LOGANB486CG',
       'GovIdType' : 'Driver License',
       'Address' : '43 Stockert Hollow Road, Everett, WA, 98203'
   },
   {
       'FirstName' : 'Alexis',
       'LastName' : 'Pena',
       'DOB' : `1974-02-10T`,
       'GovId' : '744 849 301',
       'GovIdType' : 'SSN',
       'Address' : '4058 Melrose Street, Spokane Valley, WA, 99206'
   },
   {
       'FirstName' : 'Melvin',
       'LastName' : 'Parker',
       'DOB' : `1976-05-22T`,
       'GovId' : 'P626-168-229-765',
       'GovIdType' : 'Passport',
       'Address' : '4362 Ryder Avenue, Seattle, WA, 98101'
   },
   {
       'FirstName' : 'Salvatore',
       'LastName' : 'Spencer',
       'DOB' : `1997-11-15T`,
       'GovId' : 'S152-780-97-415-0',
       'GovIdType' : 'Passport',
       'Address' : '4450 Honeysuckle Lane, Seattle, WA, 98101'
   } >>
   ```

1. Remplissez ensuite le `DriversLicense` tableau avec des documents contenant les informations du permis de conduire de chaque propriétaire de véhicule.

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

   ```
   INSERT INTO DriversLicense
   << {
       'LicensePlateNumber' : 'LEWISR261LL',
       'LicenseType' : 'Learner',
       'ValidFromDate' : `2016-12-20T`,
       'ValidToDate' : `2020-11-15T`,
       'PersonId' : ''
   },
   {
       'LicensePlateNumber' : 'LOGANB486CG',
       'LicenseType' : 'Probationary',
       'ValidFromDate' : `2016-04-06T`,
       'ValidToDate' : `2020-11-15T`,
       'PersonId' : ''
   },
   {
       'LicensePlateNumber' : '744 849 301',
       'LicenseType' : 'Full',
       'ValidFromDate' : `2017-12-06T`,
       'ValidToDate' : `2022-10-15T`,
       'PersonId' : ''
   },
   {
       'LicensePlateNumber' : 'P626-168-229-765',
       'LicenseType' : 'Learner',
       'ValidFromDate' : `2017-08-16T`,
       'ValidToDate' : `2021-11-15T`,
       'PersonId' : ''
   },
   {
       'LicensePlateNumber' : 'S152-780-97-415-0',
       'LicenseType' : 'Probationary',
       'ValidFromDate' : `2015-08-15T`,
       'ValidToDate' : `2021-08-21T`,
       'PersonId' : ''
   } >>
   ```

1. Maintenant, remplissez le `VehicleRegistration` tableau avec les documents d'immatriculation du véhicule. Ces documents incluent une `Owners` structure imbriquée qui stocke les propriétaires principaux et secondaires.

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

   ```
   INSERT INTO VehicleRegistration
   << {
       'VIN' : '1N4AL11D75C109151',
       'LicensePlateNumber' : 'LEWISR261LL',
       'State' : 'WA',
       'City' : 'Seattle',
       'PendingPenaltyTicketAmount' : 90.25,
       'ValidFromDate' : `2017-08-21T`,
       'ValidToDate' : `2020-05-11T`,
       'Owners' : {
           'PrimaryOwner' : { 'PersonId': '' },
           'SecondaryOwners' : []
       }
   },
   {
       'VIN' : 'KM8SRDHF6EU074761',
       'LicensePlateNumber' : 'CA762X',
       'State' : 'WA',
       'City' : 'Kent',
       'PendingPenaltyTicketAmount' : 130.75,
       'ValidFromDate' : `2017-09-14T`,
       'ValidToDate' : `2020-06-25T`,
       'Owners' : {
           'PrimaryOwner' : { 'PersonId': '' },
           'SecondaryOwners' : []
       }
   },
   {
       'VIN' : '3HGGK5G53FM761765',
       'LicensePlateNumber' : 'CD820Z',
       'State' : 'WA',
       'City' : 'Everett',
       'PendingPenaltyTicketAmount' : 442.30,
       'ValidFromDate' : `2011-03-17T`,
       'ValidToDate' : `2021-03-24T`,
       'Owners' : {
           'PrimaryOwner' : { 'PersonId': '' },
           'SecondaryOwners' : []
       }
   },
   {
       'VIN' : '1HVBBAANXWH544237',
       'LicensePlateNumber' : 'LS477D',
       'State' : 'WA',
       'City' : 'Tacoma',
       'PendingPenaltyTicketAmount' : 42.20,
       'ValidFromDate' : `2011-10-26T`,
       'ValidToDate' : `2023-09-25T`,
       'Owners' : {
           'PrimaryOwner' : { 'PersonId': '' },
           'SecondaryOwners' : []
       }
   },
   {
       'VIN' : '1C4RJFAG0FC625797',
       'LicensePlateNumber' : 'TH393F',
       'State' : 'WA',
       'City' : 'Olympia',
       'PendingPenaltyTicketAmount' : 30.45,
       'ValidFromDate' : `2013-09-02T`,
       'ValidToDate' : `2024-03-19T`,
       'Owners' : {
           'PrimaryOwner' : { 'PersonId': '' },
           'SecondaryOwners' : []
       }
   } >>
   ```

1. Enfin, complétez le `Vehicle` tableau avec des documents décrivant les véhicules enregistrés dans votre registre.

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

   ```
   INSERT INTO Vehicle
   << {
       'VIN' : '1N4AL11D75C109151',
       'Type' : 'Sedan',
       'Year' : 2011,
       'Make' : 'Audi',
       'Model' : 'A5',
       'Color' : 'Silver'
   },
   {
       'VIN' : 'KM8SRDHF6EU074761',
       'Type' : 'Sedan',
       'Year' : 2015,
       'Make' : 'Tesla',
       'Model' : 'Model S',
       'Color' : 'Blue'
   },
   {
       'VIN' : '3HGGK5G53FM761765',
       'Type' : 'Motorcycle',
       'Year' : 2011,
       'Make' : 'Ducati',
       'Model' : 'Monster 1200',
       'Color' : 'Yellow'
   },
   {
       'VIN' : '1HVBBAANXWH544237',
       'Type' : 'Semi',
       'Year' : 2009,
       'Make' : 'Ford',
       'Model' : 'F 150',
       'Color' : 'Black'
   },
   {
       'VIN' : '1C4RJFAG0FC625797',
       'Type' : 'Sedan',
       'Year' : 2019,
       'Make' : 'Mercedes',
       'Model' : 'CLK 350',
       'Color' : 'White'
   } >>
   ```

Vous pouvez ensuite utiliser `SELECT` des instructions pour lire les données des tables du `vehicle-registration` registre. Passez à [Étape 3 : interroger les tables d'un registre](getting-started-step-3.md).

# Étape 3 : interroger les tables d'un registre
<a name="getting-started-step-3"></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 créé des tables dans un registre Amazon QLDB et les avoir chargées avec des données, vous pouvez exécuter des requêtes pour vérifier les données d'immatriculation du véhicule que vous venez d'insérer. QLDB utilise partiQL comme langage de requête et Amazon Ion comme modèle de données orienté document.

partiQL est un langage de requête open source compatible avec SQL qui a été étendu pour fonctionner avec Ion. Avec partiQL, vous pouvez insérer, interroger et gérer vos données à l'aide d'opérateurs SQL courants. Amazon Ion est un sur-ensemble de JSON. Ion est un format de données open source basé sur des documents qui vous donne la flexibilité de stocker et de traiter des données structurées, semi-structurées et imbriquées.

Au cours de cette étape, vous utilisez `SELECT` des instructions pour lire les données des tables du `vehicle-registration` registre.

**Avertissement**  
Lorsque vous exécutez une requête dans QLDB sans recherche indexée, une analyse complète de la table est déclenchée. partiQL prend en charge ces requêtes car il est compatible avec SQL. Cependant, *n'exécutez pas* d'analyses de tables pour les cas d'utilisation en production dans QLDB. L'analyse des tables peut entraîner des problèmes de performance sur les tables de grande taille, notamment des conflits de simultanéité et des délais d'expiration des transactions.  
Pour éviter de scanner des tables, vous devez exécuter des instructions contenant une clause de `WHERE` prédicat à l'aide d'un opérateur d'*égalité* sur un champ indexé ou un identifiant de document ; par exemple, `WHERE indexedField = 123` ou. `WHERE indexedField IN (456, 789)` Pour de plus amples informations, veuillez consulter [Optimisation des performances des requêtes](working.optimize.md).

**Pour interroger les tables**

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. Dans la fenêtre de l'éditeur de requêtes, entrez l'instruction suivante pour rechercher dans le `Vehicle` tableau un numéro d'identification de véhicule (VIN) spécifique que vous avez ajouté au registre, puis choisissez **Exécuter**.

   Pour exécuter l'instruction, vous pouvez également utiliser le raccourci clavier Ctrl \$1 Enter pour Windows ou Cmd \$1 Return pour macOS. Pour plus de raccourcis clavier, voir[Raccourcis clavier de l'éditeur PartiQL](console_QLDB.md#console_QLDB.partiql-editor-shortcuts).

   ```
   SELECT * FROM Vehicle AS v
   WHERE v.VIN = '1N4AL11D75C109151'
   ```

1. Vous pouvez écrire des requêtes de jointure internes. Cet exemple de requête `Vehicle` joint `VehicleRegistration` et renvoie les informations d'immatriculation ainsi que les attributs du véhicule immatriculé pour un véhicule spécifié`VIN`.

   Entrez l'instruction suivante, puis choisissez **Exécuter**.

   ```
   SELECT v.VIN, r.LicensePlateNumber, r.State, r.City, r.Owners
   FROM Vehicle AS v, VehicleRegistration AS r
   WHERE v.VIN = '1N4AL11D75C109151'
   AND v.VIN = r.VIN
   ```

   Vous pouvez également joindre les `DriversLicense` tables `Person` et pour voir les attributs relatifs aux inducteurs ajoutés au registre.

   Répétez cette étape pour les opérations suivantes.

   ```
   SELECT * FROM Person AS p, DriversLicense AS l
   WHERE p.GovId = l.LicensePlateNumber
   ```

Pour en savoir plus sur la modification de documents dans les tables du `vehicle-registration` grand livre, voir[Étape 4 : Modifier les documents d'un registre](getting-started-step-4.md).

# Étape 4 : Modifier les documents d'un registre
<a name="getting-started-step-4"></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/).

Maintenant que vous disposez de données sur lesquelles travailler, vous pouvez commencer à apporter des modifications aux documents du `vehicle-registration` registre dans Amazon QLDB. Prenons l'exemple de l'Audi A5 avec VIN`1N4AL11D75C109151`. Cette voiture appartient initialement à un chauffeur nommé Raul Lewis à Seattle, dans l'État de Washington.

Supposons que Raul vende la voiture à un résident d'Everett, dans l'État de Washington, nommé Brent Logan. Puis, Brent et Alexis Pena décident de se marier. Brent souhaite ajouter Alexis en tant que propriétaire secondaire sur l'enregistrement. Au cours de cette étape, les instructions du langage de manipulation des données (DML) suivantes montrent comment apporter les modifications appropriées à votre registre pour refléter ces événements.

**Astuce**  
Il est recommandé d'utiliser le système attribué à un document en `id` tant que clé étrangère. Bien que vous puissiez définir des champs destinés à être des identifiants uniques (par exemple, le VIN d'un véhicule), le véritable identifiant unique d'un document est le sien`id`. Ce champ est inclus dans les métadonnées du document, que vous pouvez interroger dans la vue *validée (la vue* définie par le système d'une table).  
Pour plus d'informations sur les vues dans QLDB, consultez. [Concepts de base](ledger-structure.md) Pour en savoir plus sur les métadonnées, consultez[Interrogation des métadonnées d'un document](working.metadata.md).

**Pour modifier des documents**

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.
**Note**  
Si vous configurez votre registre à l'aide de la fonction automatique **Charger des échantillons de données** de la console, passez à l'étape 6.

1. Si vous avez exécuté manuellement `INSERT` des instructions pour charger les exemples de données, poursuivez ces étapes.

   Pour enregistrer initialement Raul en tant que propriétaire de ce véhicule, commencez par rechercher le document qui lui a été attribué par le système `id` dans le tableau. `Person` Ce champ est inclus dans les métadonnées du document, que vous pouvez interroger dans la vue définie par le système de la table, appelée vue *validée*.

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

   ```
   SELECT metadata.id FROM _ql_committed_Person AS p
   WHERE p.data.FirstName = 'Raul' and p.data.LastName = 'Lewis'
   ```

   Le préfixe `_ql_committed_` est un préfixe réservé indiquant que vous souhaitez interroger la vue validée de la table. `Person` Dans cette vue, vos données sont imbriquées dans le `data` champ et les métadonnées sont imbriquées dans le `metadata` champ.

1. À présent, `id` utilisez-le dans une `UPDATE` instruction pour modifier le document approprié dans le `VehicleRegistration` tableau. Entrez l'instruction suivante, puis choisissez **Exécuter**.

   ```
   UPDATE VehicleRegistration AS r
   SET r.Owners.PrimaryOwner.PersonId = '294jJ3YUoH1IEEm8GSabOs' --replace with your id
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

   Confirmez que vous avez modifié le `Owners` champ en émettant cette déclaration.

   ```
   SELECT r.Owners FROM VehicleRegistration AS r
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

1. Pour transférer la propriété du véhicule à Brent dans la ville d'Everett, trouvez `id` d'abord le sien dans le `Person` tableau avec la déclaration suivante.

   ```
   SELECT metadata.id FROM _ql_committed_Person AS p
   WHERE p.data.FirstName = 'Brent' and p.data.LastName = 'Logan'
   ```

   Ensuite, utilisez-le `id` pour mettre à jour le `PrimaryOwner` et le `City` dans le `VehicleRegistration` tableau.

   ```
   UPDATE VehicleRegistration AS r
   SET r.Owners.PrimaryOwner.PersonId = '7NmE8YLPbXc0IqesJy1rpR', --replace with your id
       r.City = 'Everett'
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

   Confirmez que vous avez modifié les `City` champs `PrimaryOwner` et en émettant cette déclaration.

   ```
   SELECT r.Owners.PrimaryOwner, r.City
   FROM VehicleRegistration AS r
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

1. Pour ajouter Alexis en tant que propriétaire secondaire de la voiture, trouvez-la`Person id`.

   ```
   SELECT metadata.id FROM _ql_committed_Person AS p
   WHERE p.data.FirstName = 'Alexis' and p.data.LastName = 'Pena'
   ```

   Ensuite, insérez-le `id` dans la `SecondaryOwners` liste avec l'instruction DML [FROM-INSERT](ql-reference.from.md) suivante.

   ```
   FROM VehicleRegistration AS r 
   WHERE r.VIN = '1N4AL11D75C109151'
   INSERT INTO r.Owners.SecondaryOwners
       VALUE { 'PersonId' : '5Ufgdlnj06gF5CWcOIu64s' } --replace with your id
   ```

   Confirmez que vous avez effectué `SecondaryOwners` les modifications en émettant cette déclaration.

   ```
   SELECT r.Owners.SecondaryOwners FROM VehicleRegistration AS r
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

Pour consulter ces modifications dans le `vehicle-registration` registre, voir[Étape 5 : Afficher l'historique des révisions d'un document](getting-started-step-5.md).

# É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)

# Étape 6 : Vérifier un document dans un registre
<a name="getting-started-step-6"></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/).

Avec Amazon QLDB, vous pouvez vérifier efficacement l'intégrité d'un document dans le journal de votre grand livre en utilisant le hachage cryptographique avec SHA-256. Dans cet exemple, Alexis et Brent décident de passer à un nouveau modèle en échangeant le véhicule avec le VIN `1N4AL11D75C109151` chez un concessionnaire automobile. Le concessionnaire entame le processus en vérifiant la propriété du véhicule auprès du bureau d'immatriculation.

Pour en savoir plus sur le fonctionnement de la vérification et du hachage cryptographique dans QLDB, consultez. [Vérification des données dans Amazon QLDB](verification.md)

Au cours de cette étape, vous devez vérifier une révision de document dans le `vehicle-registration` registre. Tout d'abord, vous demandez un résumé, qui est renvoyé sous forme de fichier de sortie et sert de signature à l'historique complet des modifications de votre registre. Ensuite, vous demandez une preuve pour la révision relative à ce condensé. À l'aide de cette preuve, l'intégrité de votre révision est vérifiée si tous les contrôles de validation sont réussis.

## Pour demander un résumé
<a name="getting-started-step-6.digest"></a>

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 **Ledgers**.

1. Dans la liste des registres, sélectionnez`vehicle-registration`.

1. Choisissez **Get digest**. La boîte de dialogue **Obtenir** le résumé affiche les détails suivants :
   + **Résumé** — La valeur de hachage SHA-256 du résumé que vous avez demandé.
   + **Adresse du résumé** : emplacement du dernier [bloc](verification.md#verification.structure) dans le journal concerné par le résumé que vous avez demandé. Une adresse comporte les deux champs suivants :
     + `strandId`— L'identifiant unique du volet du journal qui contient le bloc.
     + `sequenceNo`— Le numéro d'index qui indique l'emplacement du bloc dans le fil.
   + **Grand livre** : nom du registre pour lequel vous avez demandé un résumé.
   + **Date** — Horodatage auquel vous avez demandé le résumé.

1. Passez en revue les informations du résumé. Ensuite, choisissez **Save** (Enregistrer). Vous pouvez conserver le nom de fichier par défaut ou en saisir un nouveau.

   Cette étape enregistre un fichier texte brut dont le contenu est au format [Amazon Ion](ion.md). Le fichier porte l'extension de nom de fichier `.ion.txt` et contient toutes les informations de synthèse répertoriées dans la boîte de dialogue précédente. Voici un exemple du contenu d'un fichier de synthèse. L'ordre des champs peut varier en fonction de votre navigateur.

   ```
   {
     "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",
     "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",
     "ledger": "vehicle-registration",
     "date": "2019-04-17T16:57:26.749Z"
   }
   ```

1. Enregistrez ce fichier pour pouvoir y accéder ultérieurement. Dans les étapes suivantes, vous allez utiliser ce fichier pour vérifier une révision de document par rapport à.

Après avoir enregistré un résumé de registre, vous pouvez commencer le processus de vérification d'une révision de document par rapport à ce résumé.

**Note**  
Dans un cas d'utilisation en production à des fins de vérification, vous utilisez un résumé précédemment enregistré plutôt que d'effectuer les deux tâches consécutivement. Il est recommandé de demander et d'enregistrer le résumé dès qu'une révision que vous souhaitez vérifier ultérieurement est écrite dans la revue.

## Pour vérifier la révision d'un document
<a name="getting-started-step-6.verify"></a>

1. Tout d'abord, recherchez dans votre registre la version `id` et la révision `blockAddress` du document 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 de la console QLDB, sélectionnez PartiQL editor.**

1. Choisissez le `vehicle-registration` registre.

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

   ```
   SELECT r.metadata.id, r.blockAddress
   FROM _ql_committed_VehicleRegistration AS r 
   WHERE r.data.VIN = '1N4AL11D75C109151'
   ```

1. 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 de chaîne sont délimités par des guillemets doubles.

1. 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**.

1. 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** — Choisissez`vehicle-registration`.
   + **Adresse du bloc** : `blockAddress` valeur renvoyée par votre requête à l'étape 3.
   + **ID du document** : `id` valeur renvoyée par votre requête à l'étape 3.

1. 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é.

1. 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 une preuve à QLDB pour le document que vous avez spécifié.

   1. Utilisez la preuve renvoyée par QLDB pour appeler une API côté client, qui vérifie la révision de votre document par rapport au résumé fourni.

   La console affiche les résultats de votre demande dans la fiche de **résultats de vérification**. Pour de plus amples informations, veuillez consulter [Résultats de vérification](verification.results.md).

1. Pour tester la logique de vérification, répétez les étapes 6 à 8 de la section **Pour vérifier une révision de document**, mais modifiez un seul caractère dans la chaîne d'entrée du **Digest**. Cela devrait entraîner l'échec de votre demande de **vérification** avec un message d'erreur approprié.

Si vous n'avez plus besoin d'utiliser le `vehicle-registration` registre, passez à[Étape 7 (optionnelle) : Nettoyer les ressources](getting-started-step-7.md).

# Étape 7 (optionnelle) : Nettoyer les ressources
<a name="getting-started-step-7"></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/).

Vous pouvez continuer à utiliser le `vehicle-registration` registre. Toutefois, si vous n'en avez plus besoin, vous devez le supprimer.

Si la protection contre la suppression est activée pour votre registre, vous devez d'abord la désactiver avant de pouvoir le supprimer à l'aide de l'API QLDB, ( AWS Command Line Interface )AWS CLI ou de la console QLDB.

**Pour supprimer le registre**

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 **Ledgers**.

1. Si la protection contre la suppression est activée pour ce registre, vous devez d'abord la désactiver.

   Dans la liste des livres, sélectionnez`vehicle-registration`, puis choisissez **Modifier le registre**.

1. Sur la page **Modifier le registre**, **désactivez la protection contre la suppression**, puis choisissez **Confirmer les modifications**.

1. Dans la liste des registres, sélectionnez `vehicle-registration` à nouveau, puis choisissez **Supprimer**.

1. Confirmez cela en entrant **delete vehicle-registration** dans le champ prévu à cet effet.

Pour en savoir plus sur l'utilisation des registres dans QLDB, consultez. [Démarrage avec Amazon QLDB : prochaines étapes](getting-started-next-steps.md)

# Démarrage avec Amazon QLDB : prochaines étapes
<a name="getting-started-next-steps"></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/).

Pour plus d'informations sur l'utilisation d'Amazon QLDB, consultez les rubriques suivantes :
+ [Utilisation des données et de l'historique dans Amazon QLDB](working-with-data.md)
+ [Commencer à utiliser le pilote Amazon QLDB](getting-started-driver.md)
+ [Modèle de simultanéité Amazon QLDB](concurrency.md)
+ [Exportation de données de journal depuis Amazon QLDB](export-journal.md)
+ [Diffusion en continu de données de journaux depuis Amazon QLDB](streams.md)
+ [Vérification des données dans Amazon QLDB](verification.md)
+ [Référence Amazon QLDB PartiQL](ql-reference.md)