Paso 1: Solicitar un resumen 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 1: Solicitar un resumen en QLDB

Amazon QLDB proporciona una API para solicitar un resumen que cubra latipdel diario en su libro mayor. La sugerencia del diario se refiere al último bloque comprometido en el momento en que QLDB recibe su solicitud. Puede utilizar elAWS Management Console, unAWSSDK o elAWS 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 en.AWS Management Consoley abra la consola de Amazon QLDB enhttps://console.aws.amazon.com/qldb.

  2. En el panel de navegación, seleccioneLibros de contabilidad.

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

  4. ElegirObtenga resumen. LaObtenga resumenen el cuadro de diálogo se muestran los siguientes detalles del resumen:

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

    • Dirección de la sugerencia de resumen: la última ubicación de bloque en la revista cubierta por el resumen que solicitó. Una dirección de tiene los siguientes dos campos:

      • strandId: el identificador único de la cadena de diario que contiene el bloque.

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

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

    • Fecha: la 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 escribir uno nuevo.

    nota

    Es posible que observe que los valores de hash de resumen y dirección de propina cambian incluso cuando no modifica ningún dato de su libro mayor. Esto se debe a que la consola recupera el catálogo del sistema del libro mayor cada vez que se ejecuta una consulta en elEditor de PartiQL. Se trata de una transacción de lectura que se confirma en el diario y provoca que cambie la dirección de bloque más reciente.

    Este paso guarda un archivo de texto sin formato con contenido enAmazon Ionformato. El archivo tiene una extensión de nombre de archivo de.ion.txty contiene toda la información de resumen 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 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 para poder acceder a él en el future. Más adelante, puede usar este archivo para comprobar la revisión de un documento.

    importante

    La revisión del documento que verifique más adelante debe estar cubierta por 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 delDirección de la sugerencia de resumen.

API DE QLDB

También puede solicitar un resumen de su libro mayor mediante la API de Amazon QLDB con unAWSSDK de.AWS CLI. La API de QLDB ofrece la siguiente operación 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.

Para obtener información sobre cómo solicitar un resumen mediante elAWS CLI, consulte elget-digesten laAWS 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 solicitar un resumen, 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 claseGetDigestproporciona un ejemplo de cómo solicitar un resumen a lavehicle-registrationEjemplo de de.

Para comprobar la revisión de un documento mediante el resumen que guardó, vaya aPaso 2: Verificación de sus datos en QLDB.