Paso 2: Verificación de sus datos en QLDB - Amazon Quantum Ledger Database (Amazon QLDB)

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: Verificación de sus datos en QLDB

Amazon QLDB proporciona una API para solicitar una prueba para un identificador de documento específico y su bloque asociado. También debes proporcionar la dirección de propina de un resumen que hayas guardado previamente, como se describe enPaso 1: Solicitar un resumen en QLDB. Puede utilizar elAWS Management Console, unAWSSDK o elAWS CLIpara obtener una prueba.

A continuación, puede usar la prueba devuelta por QLDB para verificar la revisión del documento con el resumen guardado, mediante una API del lado del cliente. De este modo, tendrá 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 previamente mediante la consola de Amazon QLDB.

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

Para verificar la revisión de un documento (consola)

  1. Abrir la consola de Amazon QLDB enhttps://console.aws.amazon.com/qldb.

  2. En primer lugar, consulte en su libro mayor elidyblockAddressde la revisión que desea verificar. Estos campos se incluyen en los metadatos del documento, que puede consultar en lavista comprometida.

    El documentoides una cadena de ID única asignada por el sistema. LablockAddresses una estructura Ion que especifica la ubicación del bloque en la que se comprometió la revisión.

    En el panel de navegación, seleccioneEditor de PartiQL.

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

  4. En la ventana del editor de consultas, escriba unSELECTen la siguiente sintaxis y, a continuación, seleccioneEjecución de.

    SELECT metadata.id, blockAddress FROM _ql_committed_table_name WHERE criteria

    Por ejemplo, la siguiente consulta devuelve un documento de laVehicleRegistrationtabla en el libro mayor de muestra creado enIntroducción a la consola de Amazon QLDB.

    SELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r WHERE r.data.VIN = 'KM8SRDHF6EU074761'
  5. Copie y guarde laidyblockAddressvalores que devuelve la consulta. Asegúrese de omitir las comillas dobles para elid. EnAmazon Ion, los tipos de datos de cadena se delimitan con comillas dobles. Por ejemplo, debe copiar solo el texto alfanumérico del siguiente fragmento.

    "LtMNJYNjSwzBLgf7sLifrG"

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

    En el panel de navegación, seleccioneVerificación.

  7. En la páginaVerificar el documentoformulario, enEspecifique el documento que desea verificar, escriba los siguientes parámetros de entrada:

    • Registro: el libro mayor en el que desea verificar una revisión.

    • Bloquear dirección— ElblockAddressvalor devuelto por la consulta en el paso 4.

    • ID de documento— Elidvalor devuelto por la consulta en el paso 4.

  8. UnderEspecificar el resumen que se va a usar para la verificación, selecciona el resumen que guardaste anteriormente seleccionandoElija resumen. Si el archivo es válido, se rellenan automáticamente todos los campos de resumen de la consola. O bien, puedes copiar y pegar manualmente los siguientes valores directamente desde el archivo de resumen:

    • Digerir— Eldigestvalor de su archivo de resumen.

    • Dirección de la sugerencia de resumen— EldigestTipAddressvalor de su archivo de resumen.

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

    La consola automatiza dos pasos para usted:

    1. Solicite una prueba a QLDB para el documento especificado.

    2. Usa la prueba devuelta por QLDB para llamar a una API del lado del cliente, que verifica la revisión de tu documento con el resumen proporcionado. Para examinar este algoritmo de verificación, consulte la siguiente sección:API DE QLDBpara descargar el ejemplo de código.

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

API DE QLDB

También puede verificar la revisión de un documento mediante la API de Amazon QLDB con unAWSSDK de.AWS CLI. La API de QLDB ofrece las siguientes operaciones para usarlas en 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 especificada de un diario. También devuelve una prueba del bloque especificado para su verificación siDigestTipAddressse encuentra.

  • GetRevision— devuelve un objeto de datos de revisión para un ID de documento y una dirección de bloque especificados. También devuelve una prueba de la revisión especificada para su verificación siDigestTipAddressse encuentra.

Para obtener descripciones completas de estas operaciones de la API, consulte laReferencia de la API de Amazon QLDB.

Para obtener información acerca de la verificación de datos mediante laAWS CLI, consulte elAWS CLIReferencia de los comandos.

Aplicación de muestra

Para ver ejemplos de código Java, consulte la GitHub repositoryaws-muestras/amazon-qldb-dmv-samplejava: Jjava. Para obtener instrucciones acerca de cómo descargar e instalar esta aplicación de ejemplo, consulteInstalación de la aplicación de ejemplo Java de Amazon QLDB. Antes de realizar una verificación, asegúrate de seguir los pasos 1 a 3 de laTutorial de Javapara crear un libro mayor de muestras y cargarlo con datos de muestra.

El código del tutorial en claseGetRevisionproporciona 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. Solicita un nuevo resumen del libro mayor de muestrasvehicle-registration.

  2. Solicita una prueba para la revisión de un documento de muestra alVehicleRegistrationmesa en elvehicle-registrationlibro mayor.

  3. Verifica la revisión de muestra mediante el resumen y la prueba devueltos.