Etapa 1: Solicitar um resumo 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 um API formulário para solicitar um resumo que cubra a ponta atual do diário em seu livro contábil. A dica do diário se refere ao último bloco confirmado no momento em que QLDB recebe sua solicitação. Você pode usar o AWS Management Console, um AWS SDK, ou o AWS Command Line Interface (AWS CLI) para obter um resumo.

AWS Management Console

Siga estas etapas para solicitar um resumo usando o QLDB console.

Para solicitar um resumo (console)

1. Faça login no AWS Management Console e abra o QLDB console da Amazon em https://console.aws.amazon.com/qldb.

2. No painel de navegação, escolha Ledgers.

3. Na lista de ledgers, selecione o nome do ledger para o qual você deseja solicitar um resumo.

4. Escolha Obter resumo. A caixa de diálogo Obter resumo exibe os seguintes detalhes do resumo:

   • Digest — O valor de hash SHA -256 do resumo que você solicitou.

   • Endereço da dica de resumo: a última localização do bloco no diário coberto pelo resumo que você solicitou. Um endereço tem os dois campos a seguir:

     • strandId: o ID exclusivo da cadeia do diário que contém o bloco.

     • sequenceNo: o número do índice que especifica a localização do bloco dentro da cadeia.

   • ledger: o nome do ledger para o qual você solicitou um resumo.

   • Data: a data e hora em que você solicitou o resumo.

5. Analise as informações do resumo. Em seguida, escolha Salvar. Você pode manter o nome do arquivo padrão ou inserir um novo nome.

   nota

   Você pode notar que seus valores de hash de resumo e endereço de dica mudam mesmo quando você não modifica nenhum dado em seu ledger. Isso ocorre porque o console recupera o catálogo do sistema do ledger toda vez que você executa uma consulta no editor partiQL. Essa é uma transação de leitura que é confirmada no diário e faz com que o endereço do bloco mais recente seja alterado.

   Essa etapa salva um arquivo de texto simples com conteúdo no formato Amazon Ion. O arquivo tem uma extensão de nome de arquivo .ion.txt e contém todas as informações resumidas listadas na caixa de diálogo anterior. Este é um exemplo do conteúdo de um arquivo de resumo: A ordem dos campos pode variar dependendo do seu navegador.

   {
     "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",
     "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",
     "ledger": "my-ledger",
     "date": "2019-04-17T16:57:26.749Z"
   }

6. Salve esse arquivo onde você possa acessá-lo futuramente. Posteriormente, você pode usar esse arquivo para verificar a revisão de um documento.

   Importante

   A revisão do documento que você verifica posteriormente deve ser coberta pelo resumo que você salvou. Ou seja, o número de sequência do endereço do documento deve ser menor ou igual ao número de sequência do endereço da dica de resumo.

QLDB API

Você também pode solicitar um resumo do seu livro contábil usando a Amazon QLDB API com um AWS SDKou o AWS CLI. O QLDB API fornece a seguinte operação para uso por programas aplicativos:

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

Para obter informações sobre como solicitar um resumo usando o AWS CLI, veja o comando get-digest no AWS CLI Referência de comando.

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 solicitar um resumo, siga as etapas 1 a 3 do Tutorial de Java para criar um livro de amostras e carregá-lo com dados de amostra.

O código do tutorial na aula GetDigestfornece um exemplo de solicitação de um resumo do livro de vehicle-registration amostra.

Para verificar a revisão de um documento usando o resumo que você salvou, vá para Etapa 2: Verificar seus dados em QLDB.