

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 5: Visualizzare la cronologia delle revisioni di un documento
<a name="getting-started-step-5"></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/).

Dopo aver modificato i dati di immatricolazione dell'auto con VIN` 1N4AL11D75C109151`, puoi consultare la cronologia di tutti i proprietari registrati e qualsiasi altro campo aggiornato. Puoi vedere tutte le revisioni di un documento che hai inserito, aggiornato ed eliminato interrogando il pannello integrato. [Funzione di cronologia](working.history.md#working.history.function)

La funzione history restituisce le revisioni dalla *visualizzazione salvata* della tabella, che include sia i dati dell'applicazione che i metadati associati. I metadati mostrano esattamente quando è stata effettuata ogni revisione, in quale ordine e con quale transazione le ha eseguite.

In questo passaggio, si esegue una query sulla cronologia delle revisioni di un documento nella `VehicleRegistration` tabella del registro. `vehicle-registration`

**Per visualizzare la cronologia delle revisioni**

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.

1. Per interrogare la cronologia di un documento, inizia a trovarne l'unicità`id`. Oltre a interrogare la visualizzazione confermata, un altro modo per ottenere un documento `id` consiste nell'utilizzare la `BY` parola chiave nella visualizzazione utente predefinita della tabella. Per ulteriori informazioni, consulta [Utilizzo della clausola BY per interrogare l'ID del documento](working.metadata.by-clause.md).

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

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

1. Successivamente, puoi utilizzare questo `id` valore per interrogare la funzione di cronologia. Immettete la seguente istruzione, quindi scegliete **Esegui**. Assicurati di sostituire il `id` valore con il tuo ID del documento, a seconda dei casi.

   ```
   SELECT h.data.VIN, h.data.City, h.data.Owners
   FROM history(VehicleRegistration) AS h
   WHERE h.metadata.id = 'ADR2LQq48kB9neZDupQrMm' --replace with your id
   ```
**Nota**  
Ai fini di questo tutorial, questa query di cronologia restituisce tutte le revisioni dell'ID `ADR2LQq48kB9neZDupQrMm` del documento. Come buona pratica, tuttavia, qualifica una query cronologica con un ID del documento e un intervallo di date (ora di inizio e ora di fine).  
In QLDB, `SELECT` ogni richiesta viene elaborata in una transazione ed è soggetta a [un](limits.md#limits.fixed) limite di timeout della transazione. Le interrogazioni cronologiche che includono l'ora di inizio e l'ora di fine ottengono il vantaggio della qualificazione per intervalli di date. Per ulteriori informazioni, consulta [Funzione di cronologia](working.history.md#working.history.function).

   La funzione history restituisce i documenti nello stesso schema della visualizzazione confermata. Questo esempio proietta i dati di immatricolazione del veicolo modificati. L'output visualizzato dovrebbe essere simile al seguente:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/qldb/latest/developerguide/getting-started-step-5.html)
**Nota**  
La query sulla cronologia potrebbe non restituire sempre le revisioni dei documenti in ordine sequenziale.

   Esamina l'output e conferma che le modifiche riflettano ciò che hai fatto in. [Fase 4: Modificare i documenti in un libro mastro](getting-started-step-4.md)

1. Quindi, puoi controllare i metadati del documento di ogni revisione. **Immettete la seguente istruzione, quindi scegliete Esegui.** Ancora una volta, assicuratevi di sostituire il `id` valore con il vostro ID di documento, a seconda dei casi.

   ```
   SELECT VALUE h.metadata
   FROM history(VehicleRegistration) AS h
   WHERE h.metadata.id = 'ADR2LQq48kB9neZDupQrMm' --replace with your id
   ```

   L'output visualizzato dovrebbe essere simile al seguente:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/qldb/latest/developerguide/getting-started-step-5.html)

   Questi campi di metadati forniscono dettagli su quando ogni articolo è stato modificato e con quale transazione. Da questi dati è possibile dedurre quanto segue:
   + Il documento è identificato in modo univoco grazie al sistema `id` assegnato:. `ADR2LQq48kB9neZDupQrMm` Si tratta di un identificatore univoco universale (UUID) rappresentato in una stringa con codifica Base62.
   + `txTime`Mostra che la revisione iniziale del documento (versione) è stata creata in. `0` `2019-05-23T19:20:360d-3Z`
   + Ogni transazione successiva crea una nuova revisione con lo stesso documento`id`, un numero di versione incrementato e un numero di versione aggiornato. `txId` `txTime`

Per verificare crittograficamente una revisione del documento nel registro, procedi a. `vehicle-registration` [Fase 6: Verificare un documento in un libro mastro](getting-started-step-6.md)