Paso 1: Solicitar un resumen en QLDB

Amazon QLDB proporciona una API para solicitar un resumen que incluya la información actual del diario que figura en su libro mayor. La sugerencia del diario hace referencia al último bloque confirmado en el momento en que QLDB recibe su solicitud. Puedes usar elAWS Management Console, un AWS SDK o el AWS Command Line Interface (AWS CLI) para obtener un resumen.

AWS Management Console

Siga estos pasos para solicitar un resumen mediante la consola de QLDB.

Para solicitar un resumen (consola)

1. Inicie sesión en y abra la AWS Management Console consola de Amazon QLDB en https://console.aws.amazon.com/qldb.

2. En el panel de navegación, seleccione Ledgers.

3. En la lista de libros de contabilidad, seleccione el nombre del libro mayor para el que desea solicitar un resumen.

4. Selecciona Obtener resumen. El cuadro de diálogo Obtener resumen muestra los siguientes detalles del resumen:

   • Resumen: el valor de hash SHA-256 del resumen que ha solicitado.

   • Dirección del resumen: la última ubicación del bloque del diario incluida en el resumen que ha solicitado. Una dirección tiene los dos campos siguientes:

     • strandId— El identificador único de la cadena de revista que contiene el bloque.

     • sequenceNo— El número de índice que especifica la ubicación del bloque dentro de la cadena.

   • Libro mayor: el nombre del libro mayor para el que solicitó un resumen.

   • Fecha: marca de tiempo en la que solicitó el resumen.

5. Revise la información del resumen. A continuación, elija Save. Puede conservar el nombre de archivo predeterminado o introducir uno nuevo.

   nota

   Te darás cuenta de que los valores del hash del resumen y de las direcciones de propina cambian incluso cuando no modificas ningún dato de tu libro mayor. Esto se debe a que la consola recupera el catálogo del sistema del libro mayor cada vez que ejecuta una consulta en el editor PartiQL. Se trata de una transacción de lectura que se confirma en el diario y hace que la última dirección de bloque cambie.

   Este paso guarda un archivo de texto sin formato con el contenido en formato Amazon Ion. El archivo tiene una extensión de nombre de archivo .ion.txt y contiene toda la información resumida que aparecía en el cuadro de diálogo anterior. A continuación se muestra un ejemplo del contenido de un archivo de resumen. El orden de los campos puede variar según el navegador.

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

6. Guarde este archivo para poder acceder a él en el futuro. Más adelante, puede utilizar este archivo para comprobar la revisión de un documento.

   importante

   La revisión del documento que verifique más adelante debe incluirse en el resumen que guardó. Es decir, el número de secuencia de la dirección del documento debe ser inferior o igual al número de secuencia de la dirección del resumen.

API QLDB

También puede solicitar un resumen de su libro mayor mediante la API Amazon QLDB con un AWS SDK o el. AWS CLI La API de QLDB proporciona la siguiente operación para que la utilicen los programas de aplicación:

• GetDigest— Devuelve el resumen de un libro mayor en el último bloque confirmado del diario. La respuesta incluye un valor de hash de 256 bits y una dirección de bloque.

Para obtener información sobre cómo solicitar un resumen mediante elAWS CLI, consulte el comando get-digest en la Referencia de AWS CLIcomandos.

Aplicación de muestra

Para ver ejemplos de código Java, consulte el GitHub repositorio amazon-qldb-dmv-sampleaws-samples/ -java. Para obtener instrucciones sobre cómo descargar e instalar esta aplicación de ejemplo, consulteInstalación de la aplicación de ejemplo Java de Amazon QLDB. Antes de solicitar un resumen, asegúrese de seguir los pasos 1 a 3 del Tutorial de Java para crear un registro de muestras y cargarlo con datos de muestra.

El código del tutorial de la clase GetDigestproporciona un ejemplo de cómo solicitar un resumen del registro de vehicle-registration muestras.

Para comprobar la revisión de un documento mediante el resumen que ha guardado, proceda aPaso 2: Verificar sus datos en QLDB.