Paso 2: Verificar los datos 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 una API para solicitar una prueba de un ID de documento específico y su bloque asociado. También debe facilitar la dirección de sugerencia de un resumen que haya guardado anteriormente, tal y como se describe en Paso 1: Solicitar un resumen en QLDB. Puedes usar el AWS Management Console AWS SDK, an o el AWS CLI para obtener una prueba.

Luego, puedes usar la prueba devuelta QLDB para verificar la revisión del documento con el resumen guardado, utilizando el lado del clienteAPI. Esto le otorga el control sobre el algoritmo que utiliza para verificar los datos.

AWS Management Console

En esta sección se describen los pasos para verificar la revisión de un documento con un resumen guardado anteriormente mediante la QLDB consola de Amazon.

Antes de comenzar, asegúrese de que ha realizado los pasos que se detallan en Paso 1: Solicitar un resumen en QLDB. La verificación requiere un resumen previamente guardado que incluya la revisión que desea verificar.

Verificación de la revisión de un documento (consola)

1. Abre la QLDB consola de Amazon en https://console.aws.amazon.com/qldb.

2. En primer lugar, consulte en el libro mayor para la id y la blockAddress de la revisión que desee comprobar. Estos campos se incluyen en los metadatos del documento, que puede consultar en la vista confirmada.

   El documento id es una cadena de identificación única asignada por el sistema. blockAddress es una estructura de Ion que especifica la ubicación del bloque en la que se efectuó la revisión.

   En el panel de navegación, elija Editor PartiQL.

3. Elija el nombre del libro mayor en el que desee verificar una revisión.

4. En el editor de consultas, introduzca una instrucción SELECT en la siguiente sintaxis, y elija Ejecutar.

   SELECT metadata.id, blockAddress FROM _ql_committed_table_name
   WHERE criteria

   Por ejemplo, la siguiente consulta devuelve un documento de la tabla VehicleRegistration del ejemplo de libro mayor creado en Primeros pasos con la QLDB consola de Amazon.

   SELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r 
   WHERE r.data.VIN = 'KM8SRDHF6EU074761'

5. Copie y guarde los valores id y blockAddress que devuelve la consulta. Asegúrese de omitir las comillas dobles del campo id. En Amazon Ion, los tipos de datos de cadena se delimitan con comillas dobles. Por ejemplo, debe copiar únicamente el texto alfanumérico del siguiente fragmento.

   "LtMNJYNjSwzBLgf7sLifrG"

6. Ahora que ha seleccionado una revisión del documento, puede iniciar el proceso de verificación.

   En el panel de navegación izquierdo, elija Verificaciones.

7. En el formulario Verificar documento, en Especifique el documento que desea verificar, introduzca los siguientes parámetros de entrada:

   • Libro mayor: el libro mayor en el que desee verificar una revisión.

   • Dirección del bloque: el valor blockAddress devuelto por la consulta en el paso 4.

   • ID del documento: el valor id devuelto por la consulta en el paso 4.

8. En Especificar el resumen que se va a usar para la verificación, seleccione el resumen que guardó anteriormente; para ello, seleccione Elegir resumen. Si el archivo es válido, se rellenan automáticamente todos los campos de resumen de la consola. O bien, puede copiar y pegar manualmente los siguientes valores directamente desde el archivo de resumen:

   • Resumen: el valor digest del archivo de resumen.

   • Dirección del tip del resumen: el valor digestTipAddress del archivo de resumen.

9. Revise los parámetros de entrada del documento y del resumen y, a continuación, seleccione Verificar.

   La consola automatiza dos pasos:

   1. Solicita un formulario de prueba QLDB para el documento especificado.

   2. Utilice la prueba devuelta QLDB para llamar a un clienteAPI, que verificará la revisión de su documento con el resumen proporcionado. Para examinar este algoritmo de verificación, consulte la siguiente sección QLDB API para descargar el ejemplo de código.

   La consola muestra los resultados de su solicitud en la tarjeta de Resultados de la verificación. Para obtener más información, consulte Resultados de verificación.

QLDB API

También puedes verificar la revisión de un documento utilizando Amazon QLDB API con un AWS SDK o el AWS CLI. QLDBAPIProporciona las siguientes operaciones para que las 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.

• GetBlock: devuelve un objeto de bloque en una dirección específica de un diario. También devuelve una prueba del bloque especificado para su verificación, si DigestTipAddress se proporciona.

• GetRevision: devuelve un objeto de datos de revisión para un identificador de documento y una dirección de bloque específicos. También devuelve una prueba de la revisión especificada para su verificación, si se proporciona DigestTipAddress.

Para obtener una descripción completa de estas API operaciones, consulte laQLDBAPIReferencia de Amazon.

Para obtener información sobre la verificación de datos mediante el AWS CLI, consulte la Referencia de AWS CLI 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 realizar una verificación, siga 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 GetRevisionproporciona un ejemplo de cómo solicitar una prueba para la revisión de un documento y, a continuación, verificar esa revisión. Esta clase ejecuta los siguientes pasos:

1. Solicite un nuevo resumen del libro mayor de muestras vehicle-registration.

2. Solicite una prueba de revisión de un documento de muestra de la tabla VehicleRegistration del libro mayor vehicle-registration.

3. Verifique la revisión de la muestra utilizando el resumen y la prueba devueltos.