Fase 5: Visualizzare la cronologia delle revisioni di un documento

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 Amazon QLDB Ledger ad Amazon Aurora Postgre. SQL

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 file integrato. Funzione di cronologia

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 QLDB console Amazon all'indirizzo https://console.aws.amazon.com/qldb.

2. Nel pannello di navigazione, scegli Editor PartiQl.

3. Scegli il vehicle-registration libro mastro.

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

   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'

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

   NelQLDB, ogni SELECT richiesta viene elaborata in una transazione ed è soggetta a un limite di timeout della transazione. Le interrogazioni cronologiche che includono l'ora di inizio e l'ora di fine traggono vantaggio dalla qualificazione dell'intervallo di date. Per ulteriori informazioni, consulta Funzione di cronologia.

   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:

   VIN	City	Proprietari
   "1N4AL11D75C109151"	"Seattle"	{PrimaryOwner:{PersonId:""},SecondaryOwners:[]}
   "1N4AL11D75C109151"	"Seattle"	{PrimaryOwner:{PersonId:"294jJ3YUoH1IEEm8GSabOs"}, SecondaryOwners:[]}
   "1N4AL11D75C109151"	"Everett"	{PrimaryOwner:{PersonId:"7NmE8YLPbXc0IqesJy1rpR"}, SecondaryOwners:[]}
   "1N4AL11D75C109151"	"Everett"	{PrimaryOwner:{PersonId:"7NmE8YLPbXc0IqesJy1rpR"}, SecondaryOwners:[{PersonId:"5Ufgdlnj06gF5CWcOIu64s"}]}

   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

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

   version	id	txTime	txId
   0	"ADR2LQq48kB9neZDupQrMm"	2019-05-23T19:20:360d-3Z	"FMoVdWuPxJg3k466Iz4i75"
   1	"ADR2LQq48kB9neZDupQrMm"	2019-05-23T21:40:199d-3Z	"KWByxe842Xw8DNHcvARPOt"
   2	"ADR2LQq48kB9neZDupQrMm"	2019-05-23T21:44:432d-3Z	"EKwDOJRwbHpFvmAyJ2Kdh9"
   3	"ADR2LQq48kB9neZDupQrMm"	2019-05-23T21:49:254d-3Z	"96EiZd7vCmJ6RAvOvTZ4YA"

   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 universalmente univoco (UUID) rappresentato in una stringa con codifica Base62.

   • txTimeMostra 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 documentoid, 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