Paso 1: Solicitar un resumen en QLDB

importante

Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte Migración de un Amazon QLDB Ledger a Amazon Aurora SQL Postgre.

Amazon QLDB proporciona un resumen API para solicitar un resumen que incluya la punta actual del diario de tu libro mayor. La punta del diario hace referencia al último bloque comprometido en el momento en que se QLDB recibe tu solicitud. Puedes usar las AWS Management Console letras AWS SDK, an o AWS Command Line Interface (AWS CLI) para obtener un resumen.

AWS Management Console

Sigue estos pasos para solicitar un resumen mediante la QLDB consola.

Solicitud de un resumen (consola)

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

2. En el panel de navegación, elija Libros mayores.

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

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

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

   • Dirección del tip del resumen: la última ubicación de 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 del diario que contiene el bloque.

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

   • Libro mayor: nombre del libro mayor para el que ha solicitado un resumen.

   • Fecha: fecha y hora en que solicitó el resumen.

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

   nota

   Puede que note que los valores de las direcciones hash y sugerencia del resumen cambian incluso cuando no modifica ningún dato del 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 registra en el diario y provoca el cambio de la última dirección de bloque.

   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 de .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 extracto de ejemplo del contenido de un archivo de resumen. El orden de los campos puede variar en función del navegador.

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

6. Guarde este archivo donde pueda acceder a él en el futuro. Más adelante, puede usar este archivo para comparar la revisión de un documento.

   importante

   La revisión del documento que verifique más adelante debe estar incluida en el resumen que guardó. Es decir, el número de secuencia de la dirección del documento debe ser menor o igual que el número de secuencia de la Dirección del tip del resumen.

QLDB API

También puede solicitar un resumen de su libro mayor utilizando Amazon QLDB API con un AWS SDK o el AWS CLI. QLDBAPIProporciona 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 comprometido del diario. La respuesta incluye un valor hash de 256 bits y una dirección de bloque.

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

Aplicación de muestra

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

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

Para verificar la revisión de un documento utilizando el resumen que ha guardado, continúe con Paso 2: Verificar los datos en QLDB.