Etapa 2: Verificar seus dados em QLDB - Banco de dados Amazon Quantum Ledger (AmazonQLDB)
AWS Management ConsoleQLDB API

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Etapa 2: Verificar seus dados em QLDB

Importante

Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre. SQL

QLDBA Amazon fornece uma API para solicitar um comprovante para um ID de documento especificado 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 em QLDB. Você pode usar o AWS Management Console AWS SDK, an ou o AWS CLI para obter uma prova.

Em seguida, você pode usar a prova retornada por QLDB para verificar a revisão do documento em relação ao resumo salvo, usando o lado do clienteAPI. 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 QLDB console da Amazon.

Antes de começar, certifique-se de seguir as etapas em Etapa 1: Solicitar um resumo em 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 QLDB console da Amazon 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 tabela VehicleRegistration no ledger de amostra criado em Começando a usar o QLDB console da Amazon.

    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 um formulário de prova QLDB para o documento especificado.

    2. Use o comprovante retornado por QLDB para ligar para um clienteAPI, 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 QLDB API 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.

QLDB API

Você também pode verificar uma revisão de documento usando a Amazon QLDB API com um AWS SDK ou AWS CLI o. O QLDB API 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 obter descrições completas dessas API operações, consulte QLDBAPIReferência da Amazon o.

Para obter informações sobre a verificação de dados usando o AWS CLI, consulte a Referência de AWS 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 Amazon QLDB Java. 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.