Fase 2: Verifica dei dati in QLDB - Database Amazon Quantum Ledger (Amazon QLDB)
AWS Management ConsoleAPI QLDB

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 2: Verifica dei dati in QLDB

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.

Amazon QLDB fornisce un'API per richiedere una prova per un ID documento specifico e il blocco associato. È inoltre necessario fornire l'indirizzo tip di un digest salvato in precedenza, come descritto in. Fase 1: Richiedere un digest in QLDB Puoi usare il AWS Management Console, un AWS SDK o il AWS CLI per ottenere una prova.

Quindi, puoi utilizzare la bozza restituita da QLDB per verificare la revisione del documento rispetto al digest salvato, utilizzando un'API lato client. Questo metodo consente di controllare l'algoritmo che utilizzi per verificare i dati.

AWS Management Console

Questa sezione descrive i passaggi per verificare una revisione del documento rispetto a un digest salvato in precedenza utilizzando la console Amazon QLDB.

Prima di iniziare, verifica di seguire le fasi inFase 1: Richiedere un digest in QLDB. La verifica richiede un digest precedentemente salvato che includa la revisione da verificare.

Per verificare la revisione di un documento (console)

  1. Apri la console Amazon QLDB in /qldb. https://console.aws.amazon.com

  2. Per prima cosa, interroga il registro per verificare la fine id blockAddress della revisione che desideri verificare. Questi campi sono inclusi nei metadati del documento, sui quali è possibile interrogare nella visualizzazione confermata.

    Il documento id è una stringa ID univoca assegnata dal sistema. blockAddressÈ una struttura ionica che specifica la posizione del blocco in cui è stata eseguita la revisione.

    Nel riquadro di navigazione scegliere Editor PartiQL.

  3. Scegliete il nome del libro mastro in cui desiderate verificare una revisione.

  4. Nella finestra dell'editor di query, inserisci un'SELECTistruzione con la seguente sintassi, quindi scegli Esegui.

    SELECT metadata.id, blockAddress FROM _ql_committed_table_name
WHERE criteria

    Ad esempio, la seguente query restituisce un documento dalla VehicleRegistration tabella del libro mastro di esempio creato in. Guida introduttiva alla console Amazon QLDB

    SELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r 
WHERE r.data.VIN = 'KM8SRDHF6EU074761'

  5. Copia e salva i blockAddress valori id and restituiti dalla tua query. Assicurati di omettere le virgolette doppie per il id campo. In Amazon Ion, i tipi di dati stringa sono delimitati da virgolette doppie. Ad esempio, devi copiare solo il testo alfanumerico nel frammento seguente.

    "LtMNJYNjSwzBLgf7sLifrG"

  6. Ora che avete selezionato una revisione del documento, potete iniziare il processo di verifica.

    Nel riquadro di navigazione, scegli Verifica.

  7. Nel modulo Verifica documento, in Specificare il documento che desideri verificare, inserisci i seguenti parametri di input:

    • Libro contabile: il libro mastro in cui si desidera verificare una revisione.

    • Indirizzo di blocco: il blockAddress valore restituito dalla query nel passaggio 4.

    • ID documento: il id valore restituito dalla query nel passaggio 4.

  8. In Specificare il digest da utilizzare per la verifica, seleziona il digest salvato in precedenza scegliendo Scegli digest. Se il file è valido, compila automaticamente tutti i campi digest sulla console. In alternativa, puoi copiare e incollare manualmente i seguenti valori direttamente dal tuo file digest:

    • Digest: il digest valore del file digest.

    • Indirizzo del suggerimento digest: il digestTipAddress valore del file digest.

  9. Esamina i parametri di input del documento e digest, quindi scegli Verifica.

    La console automatizza due passaggi per te:

    1. Richiedi una bozza a QLDB per il documento specificato.

    2. Utilizza la bozza restituita da QLDB per chiamare un'API lato client, che verifica la revisione del documento rispetto al digest fornito. Per esaminare questo algoritmo di verifica, consulta la sezione seguente per scaricare l'esempio di codice. API QLDB

    La console visualizza i risultati della richiesta nella scheda dei risultati della verifica. Per ulteriori informazioni, consulta Risultati della verifica.

API QLDB

Puoi anche verificare la revisione di un documento utilizzando l'API Amazon QLDB con AWS un SDK o il. AWS CLI L'API QLDB fornisce le operazioni seguenti, che possono essere usate dai programmi applicativi:

  • GetDigest— Restituisce il riassunto di un libro mastro all'ultimo blocco commesso nel diario. La risposta include un valore hash a 256 bit e un indirizzo di blocco.

  • GetBlock— Restituisce un oggetto blocco a un indirizzo specificato in un diario. Restituisce inoltre una prova del blocco specificato per la verifica, se DigestTipAddress fornita.

  • GetRevision— Restituisce un oggetto di dati di revisione per un ID di documento e un indirizzo di blocco specificati. Restituisce inoltre una prova della revisione specificata per la verifica, se DigestTipAddress fornita.

Per la descrizione completa di queste operazioni API, consultaRiferimento all'API Amazon QLDB.

Per informazioni sulla verifica dei dati utilizzando il AWS CLI, consulta il AWS CLI Command Reference.

Applicazione di esempio

Per esempi di codice Java, consulta il GitHub repository amazon-qldb-dmv-sampleaws-samples/ -java. Per istruzioni su come scaricare e installare questa applicazione di esempio, consultaInstallazione dell'applicazione di esempio Amazon QLDB Java. Prima di effettuare una verifica, assicurati di seguire i passaggi da 1 a 3 Tutorial su Java per creare un registro di esempio e caricarlo con dati di esempio.

Il codice del tutorial in classe GetRevisionfornisce un esempio di richiesta di bozza per la revisione di un documento e quindi di verifica di tale revisione. Questa classe esegue i seguenti passaggi:

  1. Richiede un nuovo digest dal registro vehicle-registration di esempio.

  2. Richiede una bozza per un esempio di revisione di un documento dalla VehicleRegistration tabella del libro mastro. vehicle-registration

  3. Verifica la revisione del campione utilizzando il digest e la bozza restituiti.