Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Fase 4: Modificare i documenti in un libro mastro
<a name="getting-started-step-4"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Ora che hai dei dati su cui lavorare, puoi iniziare a modificare i documenti nel `vehicle-registration` registro di Amazon QLDB. Prendiamo ad esempio l'Audi A5 con VIN. `1N4AL11D75C109151` Questa vettura è inizialmente di proprietà di un autista di nome Raul Lewis a Seattle, WA.

Supponiamo che Raul venda l'auto a un residente di Everett, WA di nome Brent Logan. Quindi, Brent e Alexis Pena decidono di sposarsi. Brent vuole aggiungere Alexis come proprietario secondario alla registrazione. In questa fase, le seguenti istruzioni DML (Data Manipulation Language) mostrano come apportare le modifiche appropriate nel registro per riflettere questi eventi.

**Suggerimento**  
Come procedura ottimale, utilizzate un documento assegnato dal sistema come chiave esterna`id`. Sebbene sia possibile definire campi destinati a essere identificatori univoci (ad esempio, il VIN di un veicolo), il vero identificatore univoco di un documento è il suo. `id` Questo campo è incluso nei metadati del documento, a cui è possibile eseguire una query nella visualizzazione confermata (*la vista* di una tabella definita dal sistema).  
Per ulteriori informazioni sulle viste in QLDB, vedere. [Concetti principali](ledger-structure.md) Per ulteriori informazioni sui metadati, consulta. [Interrogazione dei metadati dei documenti](working.metadata.md)

**Per modificare i documenti**

1. [Apri la console Amazon QLDB in /qldb. https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)

1. Nel pannello di navigazione, scegli Editor **PartiQl**.

1. Scegli il `vehicle-registration` libro mastro.
**Nota**  
Se configuri il registro utilizzando la funzione automatica **Carica dati di esempio** della console, vai avanti al passaggio 6.

1. Se hai eseguito manualmente `INSERT` delle istruzioni per caricare i dati di esempio, continua con questi passaggi.

   Per registrare inizialmente Raul come proprietario di questo veicolo, inizia cercando `id` nella tabella il documento assegnato dal sistema. `Person` *Questo campo è incluso nei metadati del documento, a cui è possibile eseguire una query nella visualizzazione della tabella definita dal sistema, chiamata visualizzazione commessa.*

   **Nella finestra dell'editor di query, immettete la seguente istruzione, quindi scegliete Esegui.**

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

   Il prefisso `_ql_committed_` è un prefisso riservato che indica che desiderate interrogare la visualizzazione salvata della tabella. `Person` In questa visualizzazione, i dati sono annidati nel `data` campo e i metadati sono annidati nel campo. `metadata`

1. Utilizzateli ora `id` in un'`UPDATE`istruzione per modificare il documento appropriato nella tabella. `VehicleRegistration` Immettete la seguente istruzione, quindi scegliete **Esegui**.

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

   Conferma di aver modificato il `Owners` campo emettendo questa dichiarazione.

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

1. Per trasferire la proprietà del veicolo a Brent, nella città di Everett, cerca innanzitutto la sua `id` dalla `Person` tabella con la seguente dichiarazione.

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

   Quindi, usala `id` per aggiornare la `PrimaryOwner` e la `City` nella `VehicleRegistration` tabella.

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

   Conferma di aver modificato i `City` campi `PrimaryOwner` and emettendo questa dichiarazione.

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

1. Per aggiungere Alexis come proprietaria secondaria dell'auto, trovala. `Person id`

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

   Quindi, inseriscilo `id` nell'`SecondaryOwners`elenco con la seguente istruzione DML [FROM-INSERT](ql-reference.from.md).

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

   Conferma di aver apportato la modifica `SecondaryOwners` emettendo questa dichiarazione.

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

Per esaminare queste modifiche nel `vehicle-registration` libro mastro, vedere. [Fase 5: Visualizzare la cronologia delle revisioni di un documento](getting-started-step-5.md)