Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
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)
Abre la QLDB consola de Amazon en https://console.aws.amazon.com/qldb
. -
En primer lugar, consulte en el libro mayor para la
id
y lablockAddress
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.
-
Elija el nombre del libro mayor en el que desee verificar una revisión.
-
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
WHEREcriteria
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'
-
Copie y guarde los valores
id
yblockAddress
que devuelve la consulta. Asegúrese de omitir las comillas dobles del campoid
. 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
" -
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.
-
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.
-
-
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.
-
-
Revise los parámetros de entrada del documento y del resumen y, a continuación, seleccione Verificar.
La consola automatiza dos pasos:
-
Solicita un formulario de prueba QLDB para el documento especificado.
-
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, siDigestTipAddress
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 proporcionaDigestTipAddress
.
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/
El código del tutorial de la clase GetRevision
-
Solicite un nuevo resumen del libro mayor de muestras
vehicle-registration
. -
Solicite una prueba de revisión de un documento de muestra de la tabla
VehicleRegistration
del libro mayorvehicle-registration
. -
Verifique la revisión de la muestra utilizando el resumen y la prueba devueltos.