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

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

Amazon QLDB fornisce la possibilità API di richiedere una prova per un ID di documento specifico e il blocco associato. È inoltre necessario fornire l'indirizzo IP di un digest salvato in precedenza, come descritto inFase 1: Richiedere un digest QLDB. Puoi utilizzare il plugin AWS Management Console, un AWS SDK, o AWS CLI per averne una prova.

Quindi, puoi utilizzare la bozza restituita da QLDB per verificare la revisione del documento rispetto al digest salvato, utilizzando un lato client. API In questo modo puoi controllare l'algoritmo che utilizzi per verificare i tuoi 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 AmazonQLDB.

Prima di iniziare, assicurati di seguire i passaggi indicati. Fase 1: Richiedere un digest QLDB La verifica richiede un digest salvato in precedenza che copra la revisione che desideri verificare.

Per verificare la revisione di un documento (console)

  1. Apri la QLDB console Amazon all'indirizzo https://console.aws.amazon.com/qldb.

  2. Per prima cosa, interroga il registro per verificare id la fine 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 pannello di navigazione, scegli 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 QLDB console Amazon

    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 un modulo di prova QLDB per il documento specificato.

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

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

QLDB API

Puoi anche verificare la revisione di un documento utilizzando Amazon QLDB API con un AWS SDKo il AWS CLI. QLDBAPIFornisce le seguenti operazioni per l'utilizzo da parte dei programmi applicativi:

  • GetDigest— Restituisce il riassunto di un libro contabile nell'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 una descrizione completa di queste API operazioni, vedere. QLDBAPIRiferimento Amazon

Per informazioni sulla verifica dei dati utilizzando il AWS CLI, vedi il AWS CLI Riferimento ai comandi.

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, consulta. Installazione 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.