Etapa 2: Verificar seus dados no QLDB

O Amazon QLDB fornece uma API para solicitar uma prova para uma ID de documento especificada e seu bloco associado. Você também deve fornecer o endereço da dica de um resumo que você salvou anteriormente, conforme descrito em Etapa 1: Solicitar um resumo no QLDB. Você pode usar o AWS Management Console, um AWS SDK ou o AWS CLI para obter uma prova.

Em seguida, você pode usar a prova devolvida pelo QLDB para verificar a revisão do documento em relação ao resumo salvo, usando uma API do lado do cliente. Isso permite que você controle o algoritmo usado para verificar seus dados.

AWS Management Console

Esta seção descreve as etapas para verificar uma revisão de documento em relação a um resumo salvo anteriormente usando o console do Amazon QLDB.

Antes de começar, certifique-se de seguir as etapas em Etapa 1: Solicitar um resumo no QLDB. A verificação requer um resumo salvo anteriormente que cubra a revisão que você deseja verificar.

Para verificar a revisão de um documento (console)

1. Abra o console do Amazon QLDB em https://console.aws.amazon.com/qldb.

2. Primeiro, consulte seu ledger para o id e blockAddress da revisão que você deseja verificar. Esses campos estão incluídos nos metadados do documento, que você pode consultar na visualização confirmada.

   O documento id é uma sequência de caracteres de identificação exclusiva atribuída pelo sistema. blockAddress é uma estrutura Ion que especifica a localização do bloco onde a revisão foi confirmada.

   No painel de navegação, selecione Editor PartiQL.

3. Escolha o nome do livro no qual você deseja verificar uma revisão.

4. Na janela do editor de consultas insira uma instrução SELECT na sintaxe abaixo e escolha Executar.

   SELECT metadata.id, blockAddress FROM _ql_committed_table_name
   WHERE criteria

   Por exemplo, a consulta a seguir retorna um documento da VehicleRegistration tabela no ledger de amostra criado em Conceitos básicos do console do Amazon QLDB.

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

5. Copie e salve os valores id e blockAddress que sua consulta devolve. Certifique-se de omitir as aspas duplas do campo id. No Amazon Ion, os tipos de dados de string são delimitados com aspas duplas. Por exemplo, você deve copiar somente o texto alfanumérico no trecho a seguir.

   "LtMNJYNjSwzBLgf7sLifrG"

6. Agora que você selecionou uma revisão do documento, pode iniciar o processo de verificação.

   No painel de navegação, escolha Verificação.

7. No formulário Verificar documento, em Especificar o documento que deseja verificar, insira os seguintes parâmetros de entrada:

   • ledger — O ledger no qual você deseja verificar uma revisão.

   • Endereço do bloco — O valor blockAddress devolvido por sua consulta na etapa 4.

   • ID do documento — O valor id devolvido por sua consulta na etapa 4.

8. Em Especificar o resumo a ser usado para verificação, selecione o resumo que você salvou anteriormente escolhendo Escolher resumo. Se o arquivo for válido, isso preencherá automaticamente todos os campos de resumo no console. Ou você pode copiar e colar manualmente os seguintes valores diretamente do seu arquivo de resumo:

   • Resumo — O valor digest do seu arquivo de resumo.

   • Endereço dica de resumo — O valor digestTipAddress do seu arquivo de resumo.

9. Revise os parâmetros de entrada do documento e do resumo e escolha Verificar.

   O console automatiza duas etapas para você:

   1. Solicite uma prova do QLDB para o documento especificado.

   2. Use a prova retornada pelo QLDB para chamar uma API do lado do cliente, que verifica a revisão do documento em relação ao resumo fornecido. Para examinar esse algoritmo de verificação, consulte a seção a seguir API QLDB para baixar o exemplo de código.

   O console exibe os resultados da sua solicitação no cartão Resultados da verificação. Para ter mais informações, consulte Resultados da verificação.

API QLDB

Você também pode verificar a revisão de um documento usando a API Amazon QLDB com um SDK AWS ou o AWS CLI. A API do QLDB fornece as seguintes operações para uso por programas aplicativos:

• GetDigest— Devolve o resumo de um ledger no último bloco confirmado no diário. A resposta inclui um valor de hash de 256 bits e um endereço do bloco.

• GetBlock— Devolve um objeto de bloco em um endereço especificado em um diário. Também devolve uma prova do bloco especificado para verificação, se DigestTipAddress for fornecida.

• GetRevision— Devolve um objeto de dados de revisão para um ID de documento e endereço de bloco especificados. Também devolve uma prova da revisão especificada para verificação, se DigestTipAddress for fornecida.

Para uma descrição completa dessas operações de API, consulte o Referência da API do Amazon QLDB

Para obter informações sobre a verificação de dados usando o AWS CLI, consulte a Referência deAWS CLI Comandos.

Aplicação de exemplo

Para exemplos de código Java, consulte o GitHub repositório amazon-qldb-dmv-sampleaws-samples/ -java. Para obter instruções sobre como baixar e instalar esse aplicativo de amostra, consulte Instalando o aplicativo de amostra Java do Amazon QLDB. Antes de fazer uma verificação, siga as etapas de 1 a 3 no Tutorial de Java para criar um livro de amostras e carregá-lo com dados de amostra.

O código do tutorial na aula GetRevisionfornece um exemplo de solicitação de uma prova para uma revisão de documento e, em seguida, verificação dessa revisão. Essa classe executa as seguintes etapas:

1. Solicita um novo resumo do ledger vehicle-registration de amostra.

2. Solicita uma prova para uma amostra de revisão de documento da tabela VehicleRegistration no ledger vehicle-registration.

3. Verifica a revisão da amostra usando o resumo e a prova devolvidos.