Solicita la exportación de un diario en QLDB - Base de datos Amazon Quantum Ledger (AmazonQLDB)
AWS Management ConsoleQLDB APICaducidad del trabajo de exportación

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.

Solicita la exportación de un diario en QLDB

importante

Aviso de fin de soporte: los clientes actuales podrán usar 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 solicitud de exportación de sus bloques de diario para un intervalo de fechas y horas específico y un destino de bucket de Amazon S3 específico. Un trabajo de exportación de revistas puede escribir los objetos de datos en texto o representación binaria del formato Amazon Ion, o en formato de texto JSONLines. Puede utilizar el AWS Management Console, y AWS SDK, o el AWS Command Line Interface (AWS CLI) para crear un puesto de trabajo de exportación.

AWS Management Console

Siga estos pasos para enviar una solicitud de exportación de una revista QLDB desde la QLDB consola.

Solicitud de una exportación (consola)

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

  2. En el panel de navegación, elija Exportar.

  3. Elija Crear trabajo de exportación.

  4. En la página Crear trabajo de exportación, introduzca los siguientes ajustes de exportación:

    • Libro mayor: el libro mayor cuyos bloques de diario desea exportar.

    • Fecha y hora de inicio: la marca de tiempo de inicio incluida en la Hora Universal Coordinada (UTC) del rango de bloques de diario que se va a exportar. Esta marca de tiempo debe ser anterior a la Fecha y hora de finalización. Si proporciona una marca de tiempo de inicio anterior a la del libro mayorCreationDateTime, el QLDB valor predeterminado será el del libro mayor. CreationDateTime

    • Fecha y hora de finalización: la marca de tiempo de finalización exclusiva (UTC) del rango de bloques de diario que se va a exportar. Estas fecha y hora no pueden estar en el futuro.

    • Destino de los bloques de diario: el nombre del prefijo y el bucket de Amazon S3 en los que el trabajo de exportación escribe los objetos de datos. Utilice el siguiente URI formato de Amazon S3.

      s3://amzn-s3-demo-bucket/prefix/

      Debe especificar un nombre de bucket de S3 y un nombre de prefijo opcional para los objetos de salida. A continuación, se muestra un ejemplo.

      s3://amzn-s3-demo-bucket/journalExport/

      Tanto el nombre como el prefijo del bucket deben cumplir con las normas y convenciones de nomenclatura de Amazon S3. Para obtener más información sobre la nomenclatura de buckets, consulte Restricciones y limitaciones de los buckets en la Guía para desarrolladores de Amazon S3. Para obtener más información sobre prefijos de nombre de clave, consulte Clave y metadatos de objetos.

      nota

      No se admiten exportaciones entre regiones. El bucket de Amazon S3 especificado debe estar en el mismo Región de AWS como su libro mayor.

    • Cifrado S3: la configuración de cifrado que utiliza su trabajo de exportación para escribir datos en un bucket de Amazon S3. Para obtener más información sobre opciones de cifrado del servidor en Amazon S3, consulte Protección de datos mediante cifrado del servidor en la Guía para desarrolladores de Amazon S3.

      • Cifrado predeterminado del bucket: utilice la configuración de cifrado predeterminada del bucket de Amazon S3 especificado.

      • AES-256: utilice el cifrado del lado del servidor con las claves gestionadas de Amazon S3 (SSE-S3).

      • AWS- — Utilice el cifrado del lado del KMS servidor con AWS KMS claves administradas (SSE-KMS).

        Si eliges este tipo junto con la opción Elige una diferente AWS KMS keyopción, también debe especificar una KMS clave de cifrado simétrica en el siguiente formato de Amazon Resource Name (ARN).

        arn:aws:kms:aws-region:account-id:key/key-id

    • Acceso al servicio: el IAM rol que otorga los permisos de QLDB escritura en su bucket de Amazon S3. Si corresponde, el IAM rol también debe conceder QLDB permisos para usar su KMS clave.

      Para transferir un rol QLDB al solicitar la exportación de un diario, debe tener permisos para realizar la iam:PassRole acción en el recurso del IAM rol.

      • Crear y utilizar un nuevo rol de servicio: deje que la consola cree un nuevo rol para usted con los permisos necesarios para el bucket de Amazon S3 especificado.

      • Utilizar un rol de servicio existente: para obtener información sobre cómo crear este rol de forma manual enIAM, consultePermisos de exportación.

    • Formato de salida: el formato de salida de los datos de su diario exportados

      • Ion en texto: representación textual (predeterminada) de Amazon Ion

      • Ion binario: representación binaria de Amazon Ion

      • JSON— Formato de texto delimitado por líneas nuevas JSON

        Si lo deseaJSON, QLDB convierte los datos del diario de Ion a los objetos de datos JSON exportados. Para obtener más información, consulte Convertir descendentemente a JSON.

  5. Cuando esté conforme con los ajustes, elija Crear.

    El tiempo que tarda en finalizar el trabajo de exportación varía según el tamaño de los datos. Si la solicitud se envía correctamente, la consola vuelve a la página principal de Exportación y muestra los trabajos de exportación con su estado actual.

  6. Puede ver los objetos de exportación en la consola de Amazon S3.

    Abra la consola Amazon S3 en https://console.aws.amazon.com/s3/.

    Para obtener más información sobre el formato de estos objetos de salida, consulte El resultado de exportación del diario en QLDB.

nota

Los trabajos de exportación caducan siete días después de completarse. Para obtener más información, consulte Caducidad del trabajo de exportación.

QLDB API

También puede solicitar la exportación de una revista utilizando Amazon QLDB API con un AWS SDKo el AWS CLI. QLDBAPIProporciona las siguientes operaciones para que las utilicen los programas de aplicación:

  • ExportJournalToS3: exporta el contenido del diario dentro de un intervalo de fechas y horas de un libro mayor determinado a un bucket de Amazon S3 específico. Un trabajo de exportación puede escribir los datos como objetos en la representación de texto o binaria del formato Amazon Ion o en el formato de texto JSON Lines.

  • DescribeJournalS3Export: devuelve información detallada sobre un trabajo de exportación de diario. El resultado incluye su estado actual, la hora de creación y los parámetros de la solicitud de exportación original.

  • ListJournalS3Exports— Devuelve una lista de las descripciones de los trabajos de exportación de revistas para todos los libros de contabilidad asociados al registro actual Cuenta de AWS y región. El resultado de cada descripción del trabajo de exportación incluye los mismos detalles que devuelve DescribeJournalS3Export.

  • ListJournalS3ExportsForLedger: devuelve una lista de las descripciones de los trabajos de exportación de diarios de un libro mayor determinado. El resultado de cada descripción del trabajo de exportación incluye los mismos detalles que devuelve DescribeJournalS3Export.

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

Para obtener información sobre la exportación de datos del diario mediante el AWS CLI, consulte la AWS CLI Referencia de comandos.

Aplicación de ejemplo (Java)

Para ver ejemplos de operaciones de exportación básicas en 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 una exportació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 las siguientes clases proporciona ejemplos de cómo crear una exportación, comprobar el estado de una exportación y procesar el resultado de una exportación.

Clase Descripción
ExportJournal Exporta los bloques de diario del libro mayor de ejemplo vehicle-registration para un intervalo de fechas que va desde hace 10 minutos hasta ahora. Escribe los objetos de salida en un bucket de S3 específico o crea un bucket único si no se proporciona ninguno.
DescribeJournalExport Describe un trabajo de exportación de diarios de una exportId específica en el libro mayor vehicle-registration de ejemplo.
ListJournalExports Devuelve una lista de las descripciones de los trabajos de exportación de diarios del libro mayor vehicle-registration de ejemplo.
ValidateQldbHashChain Valida la cadena de hash del libro mayor vehicle-registration de ejemplo utilizando una exportId dada. Si no se proporciona, solicita una nueva exportación para utilizarla en la validación de la cadena de hash.

Caducidad del trabajo de exportación

Los trabajos de exportación de diarios finalizados están sujetos a un período de retención de 7 días. Una vez transcurrido este límite, se eliminan automáticamente de forma permanente. Este período de caducidad es un límite codificado y no se puede cambiar.

Tras eliminar un trabajo de exportación finalizado, ya no podrá utilizar la QLDB consola ni las siguientes API operaciones para recuperar los metadatos del trabajo:

  • DescribeJournalS3Export

  • ListJournalS3Exports

  • ListJournalS3ExportsForLedger

Sin embargo, esta caducidad no afecta a los datos exportados en sí mismos. Todos los metadatos se conservan en los archivos de manifiesto que se escriben en las exportaciones. Esta caducidad está diseñada para proporcionar una experiencia más fluida a las API operaciones que enumeran los trabajos de exportación de diarios. QLDBelimina los trabajos de exportación antiguos para garantizar que solo se vean las exportaciones recientes sin tener que analizar varias páginas de trabajos.