Étape 4 : Modifier les documents d'un registre

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.

Maintenant que vous disposez de données sur lesquelles travailler, vous pouvez commencer à apporter des modifications aux documents du vehicle-registration grand livre sur AmazonQLDB. Prenons l'exemple de l'Audi A5 avec VIN1N4AL11D75C109151. 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, ceux d'un véhiculeVIN), le véritable identifiant unique d'un document est le sienid. 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 dansQLDB, voirConcepts de base. Pour en savoir plus sur les métadonnées, consultezInterrogation des métadonnées d'un document.

Pour modifier des documents

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.

   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.

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

5. À 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'

6. 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'

7. Pour ajouter Alexis en tant que propriétaire secondaire de la voiture, trouvez-laPerson 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'INSERTDMLinstruction suivante FROM:

   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.