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 no QLDB
Importante
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon
O Amazon QLDB fornece uma API para solicitar uma prova 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 no QLDB. Você pode usar o Console de gerenciamento da AWS, 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.
Console de gerenciamento da AWS
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)
Abra o console do Amazon QLDB em /qldb. https://console.aws.amazon.com
-
Primeiro, consulte seu ledger para o
ideblockAddressda 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.
-
Escolha o nome do livro no qual você deseja verificar uma revisão.
-
Na janela do editor de consultas insira uma instrução
SELECTna sintaxe abaixo e escolha Executar.SELECT metadata.id, blockAddress FROM _ql_committed_table_nameWHEREcriteriaPor exemplo, a consulta a seguir retorna um documento da tabela
VehicleRegistrationno 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' -
Copie e salve os valores
ideblockAddressque sua consulta devolve. Certifique-se de omitir as aspas duplas do campoid. 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" -
Agora que você selecionou uma revisão do documento, pode iniciar o processo de verificação.
No painel de navegação, escolha Verificação.
-
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
blockAddressdevolvido por sua consulta na etapa 4. -
ID do documento: o valor
iddevolvido por sua consulta na etapa 4.
-
-
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
digestdo seu arquivo de resumo. -
Endereço dica de resumo: o valor
digestTipAddressdo seu arquivo de resumo.
-
-
Revise os parâmetros de entrada do documento e do resumo e escolha Verificar.
O console automatiza duas etapas para você:
-
Solicite uma prova do QLDB para o documento especificado.
-
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 obter 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 da AWS ou a 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, seDigestTipAddressfor 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, seDigestTipAddressfor 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 de AWS CLI Comandos.
Aplicação de exemplo
Para exemplos de código Java, consulte o GitHub repositório amazon-qldb-dmv-sampleaws-samples/
O código do tutorial na aula GetRevision
-
Solicita um novo resumo do ledger
vehicle-registrationde amostra. -
Solicita uma prova para uma amostra de revisão de documento da tabela
VehicleRegistrationno ledgervehicle-registration. -
Verifica a revisão da amostra usando o resumo e a prova devolvidos.