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 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).