Solución de problemas de Amazon 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.

En las siguientes secciones se proporciona una lista global de los errores más comunes que puedes encontrar al utilizar AmazonQLDB, así como una guía sobre cómo solucionarlos.

Para obtener una guía de solución de problemas específica sobre el IAM acceso, consulteSolución de problemas de QLDB identidad y acceso a Amazon.

Para conocer las prácticas recomendadas para ajustar las instrucciones PartiQL, consulte Optimización del rendimiento de las consultas.

Ejecutar transacciones con el QLDB controlador

En esta sección se enumeran las excepciones más comunes que el QLDB controlador de Amazon puede devolver cuando lo utilizas para ejecutar transacciones PartiQL en un libro mayor. Para obtener más información acerca de esta característica, consulte Introducción al controlador. Para obtener información sobre las prácticas recomendadas para configurar y usar el controlador, consulte Recomendaciones de controladores.

Cada excepción incluye el mensaje de error específico, seguido de una breve descripción y sugerencias de posibles soluciones.

CapacityExceededException

Mensaje: Capacity exceeded

Amazon QLDB rechazó la solicitud porque superaba la capacidad de procesamiento del libro mayor. QLDBimpone un límite de escalado interno por libro mayor para mantener el buen estado y el rendimiento del servicio. Este límite varía según el tamaño de la carga de trabajo de cada solicitud individual. Por ejemplo, una solicitud puede tener una mayor carga de trabajo si realiza transacciones de datos ineficientes, como los escaneos de tablas que resultan de una consulta no apta para indexar.

Le recomendamos que espere antes de volver a intentar la solicitud. Si su solicitud encuentra esta excepción de forma constante, optimice sus instrucciones y reduzca la frecuencia y el volumen de las solicitudes que envía al libro mayor. Algunos ejemplos de optimización de instrucciones incluyen ejecutar menos instrucciones por transacción y ajustar los índices de las tablas. Para obtener información sobre cómo optimizar las instrucciones y evitar el escaneo de tablas, consulte Optimización del rendimiento de las consultas.

También recomendamos utilizar la última versión del QLDB controlador. El controlador tiene una política de reintentos predeterminada que utiliza el Retroceso exponencial y la fluctuación de fase para volver a intentarlo automáticamente en excepciones como esta. El concepto de retroceso exponencial se basa en utilizar tiempos de espera progresivamente más largos entre reintentos para las respuestas a errores consecutivos.

InvalidSessionException

Mensaje: Transacción transactionId ha caducado

Una transacción ha superado su vida útil máxima. Una transacción puede ejecutarse durante un máximo de 30 segundos antes de confirmarse. Tras este límite de tiempo de espera, se rechaza cualquier trabajo realizado en la transacción y se QLDB descarta la sesión. Este límite evita que el cliente pierda sesiones al iniciar transacciones y no confirmarlas ni cancelarlas.

Si se trata de una excepción habitual en su aplicación, es probable que las transacciones simplemente estén tardando demasiado en ejecutarse. Si el tiempo de ejecución de la transacción supera los 30 segundos, optimice sus instrucciones para acelerar las transacciones. Algunos ejemplos de optimización de instrucciones incluyen ejecutar menos instrucciones por transacción y ajustar los índices de las tablas. Para obtener más información, consulte Optimización del rendimiento de las consultas.

InvalidSessionException

Mensaje: Sesión sessionId ha caducado

QLDBdescartó la sesión porque superó su vida útil total máxima. QLDBdescarta las sesiones transcurridos entre 13 y 17 minutos, independientemente de si hay una transacción activa. Las sesiones se pueden perder o dañar por distintos motivos, como fallos de hardware, fallos de red o reinicio de las aplicaciones. Por lo tanto, QLDB impone una vida útil máxima a las sesiones para garantizar que el software del cliente sea resistente a los errores de sesión.

Si se produce esta excepción, le recomendamos que inicie una sesión nueva y vuelva a intentar la transacción. También recomendamos utilizar la última versión del QLDB controlador, que gestiona el grupo de sesiones y su estado en nombre de la aplicación.

InvalidSessionException

Mensaje: No such session

El cliente intentó realizar la transacción QLDB con una sesión que no existe. Suponiendo que el cliente esté utilizando una sesión que existía anteriormente, es posible que la sesión ya no exista debido a uno de los siguientes motivos:

• Si una sesión está relacionada con un fallo interno del servidor (es decir, un error con el código de HTTP respuesta 500), QLDB puede optar por descartarla por completo, en lugar de permitir que el cliente realice la transacción con una sesión en estado incierto. En ese caso, cualquier intento de reintento en esa sesión fallará y se generará este error.

• Con el tiempo, las sesiones caducadas se olvidan. QLDB De ahí que cualquier intento de continuar usando la sesión produzca este error, en lugar del InvalidSessionException inicial.

Si se produce esta excepción, le recomendamos que inicie una sesión nueva y vuelva a intentar la transacción. También recomendamos utilizar la última versión del QLDB controlador, que gestiona el grupo de sesiones y su estado en nombre de la aplicación.

RateExceededException

Mensaje: The rate was exceeded

QLDBestranguló a un cliente en función de la identidad de la persona que llamaba. QLDBimpone la limitación por región y por cuenta mediante un algoritmo de regulación por grupos simbólicos. QLDBlo hace para mejorar el rendimiento del servicio y garantizar un uso justo para todos los clientes. QLDB Por ejemplo, intentar adquirir una gran cantidad de sesiones simultáneas mediante la operación StartSessionRequest podría provocar una limitación.

Para mantener el buen estado de la aplicación y reducir aún más las limitaciones, puede volver a intentarlo con esta excepción mediante el Retroceso exponencial y la fluctuación de fase. El concepto de retroceso exponencial se basa en utilizar tiempos de espera progresivamente más largos entre reintentos para las respuestas a errores consecutivos. Recomendamos utilizar la última versión del QLDB controlador. El controlador tiene una política de reintentos predeterminada que utiliza el Retroceso exponencial y la fluctuación de fase para volver a intentarlo automáticamente en excepciones como esta.

La última versión del QLDB controlador también puede ser útil si tu aplicación recibe llamadas constantemente limitadasQLDB. StartSessionRequest El controlador mantiene un conjunto de sesiones que se reutilizan en todas las transacciones, lo que puede ayudar a reducir el número de llamadas StartSessionRequest que realiza su aplicación. Para solicitar un aumento de los límites de API estrangulamiento, ponte en contacto con el Centro.AWS Support

LimitExceededException

Mensaje: Exceeded the session limit

Un libro mayor ha superado su cuota (también conocida como límite) en cuanto al número de sesiones activas. Esta cuota se define en Cuotas y límites en Amazon QLDB. Con el tiempo, el recuento de sesiones activas de un libro mayor es uniforme, y los libros que se acerquen constantemente a la cuota podrían ver esta excepción periódicamente.

Para mantener el buen estado de la aplicación, le recomendamos que vuelva a intentarlo con esta excepción. Para evitar esta excepción, asegúrese de no haber configurado más de 1500 sesiones simultáneas para utilizarlas en un solo libro mayor en todos los clientes. Por ejemplo, puede usar el maxConcurrentTransactionsmétodo del QLDBcontrolador Amazon para Java para configurar el número máximo de sesiones disponibles en una instancia de controlador.

QldbClientException

Mensaje: A streamed result is only valid when the parent transaction is open

La transacción está cerrada y no se puede usar para recuperar los resultadosQLDB. Una transacción se cierra cuando se confirma o se cancela.

Esta excepción se produce cuando el cliente trabaja directamente con el Transaction objeto e intenta recuperar los resultados QLDB tras confirmar o cancelar una transacción. Para mitigar este problema, el cliente debe leer los datos antes de cerrar la transacción.

Exportación de datos de diarios

En esta sección se enumeran las excepciones más comunes que se QLDB pueden devolver al exportar datos de un diario de un libro mayor a un bucket de Amazon S3. Para obtener más información acerca de esta característica, consulte Exportación de datos de revistas desde Amazon QLDB.

Cada excepción incluye el mensaje de error específico, seguido de una breve descripción y sugerencias de posibles soluciones.

AccessDeniedException

Mensaje: Usuario: userARN no está autorizado a realizar: iam: PassRole on resource: roleARN

No tienes permisos para transferir un IAM rol al QLDB servicio. QLDBrequiere un rol para todas las solicitudes de exportación del diario y debe tener permisos para transferirlo aQLDB. El rol QLDB proporciona permisos de escritura en el bucket de Amazon S3 especificado.

Compruebe que ha definido una IAM política que conceda permiso para realizar la PassRole API operación en el recurso de IAM rol especificado para el QLDB servicio (qldb.amazonaws.com). Para ver una política de ejemplo, consulte Ejemplos de políticas basadas en identidad para Amazon QLDB.

IllegalArgumentException

Mensaje: QLDB se detectó un error al validar la configuración de S3: errorCode errorMessage

Una posible causa de este error es que el bucket de Amazon S3 proporcionado no existe en Amazon S3. O bien, QLDB no tiene permisos suficientes para escribir objetos en el bucket de Amazon S3 especificado.

Compruebe que el nombre del bucket de S3 que proporcionó en su solicitud de trabajo de exportación es correcto. Para obtener información sobre la nomenclatura de buckets, consulte Restricciones y limitaciones de los buckets en la Guía del usuario de Amazon Simple Storage Service.

Además, compruebe que ha definido una política para el bucket especificado que conceda PutObject PutObjectAcl permisos al QLDB servicio (qldb.amazonaws.com). Para obtener más información, consulte Permisos de exportación.

IllegalArgumentException

Mensaje: Respuesta inesperada de Amazon S3 al validar la configuración de S3. Respuesta de S3: errorCode errorMessage

El intento de escribir los datos de exportación del diario en el bucket de S3 proporcionado falló con la respuesta de error de Amazon S3 proporcionada. Para obtener más información acerca de las posibles causas, consulte Solución de problemas de Amazon S3 en la Guía de usuario de Amazon Simple Storage Service.

IllegalArgumentException

Mensaje: Amazon S3 bucket prefix must not exceed 128 characters

El prefijo proporcionado en la solicitud de exportación del diario contiene más de 128 caracteres.

IllegalArgumentException

Mensaje: Start date must not be greater than end date

Ambos InclusiveStartTime ExclusiveEndTime deben estar en el formato de fecha y hora ISO8601 y en hora universal coordinada (UTC).

IllegalArgumentException

Mensaje: End date cannot be in the future

Ambos InclusiveStartTime y ExclusiveEndTime deben estar en formato de ISO 8601 fecha y hora y enUTC.

IllegalArgumentException

Mensaje: La configuración de cifrado de objetos (S3EncryptionConfiguration) proporcionada no es compatible con una clave AWS Key Management Service (AWS KMS)

Ha proporcionado un KMSKeyArn con un ObjectEncryptionType de NO_ENCRYPTION o SSE_S3. Solo puede proporcionar una AWS KMS key administrada por el cliente para un tipo de cifrado de objeto SSE_KMS. 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.

LimitExceededException

Mensaje: Exceeded the limit of 2 concurrently running Journal export jobs

QLDBimpone un límite predeterminado de dos trabajos de exportación de diarios simultáneos.

Transmisión de datos del diario

En esta sección se enumeran las excepciones más comunes que se QLDB pueden obtener al transmitir datos de un diario desde un libro mayor a Amazon Kinesis Data Streams. Para obtener más información acerca de esta característica, consulte Transmisión de datos de revistas desde Amazon QLDB.

Cada excepción incluye el mensaje de error específico, seguido de una breve descripción y sugerencias de posibles soluciones.

AccessDeniedException

Mensaje: Usuario: userARN no está autorizado a realizar: iam: PassRole on resource: roleARN

No tienes permisos para transferir un IAM rol al QLDB servicio. QLDBrequiere un rol para todas las solicitudes de transmisión del diario y debe tener permisos para transferirlo aQLDB. El rol proporciona permisos QLDB de escritura en el recurso de Amazon Kinesis Data Streams especificado.

Compruebe que ha definido una IAM política que conceda permiso para realizar la PassRole API operación en el recurso de IAM rol especificado para el QLDB servicio (qldb.amazonaws.com). Para ver una política de ejemplo, consulte Ejemplos de políticas basadas en identidad para Amazon QLDB.

IllegalArgumentException

Mensaje: QLDB se produjo un error al validar Kinesis Data Streams: Respuesta de Kinesis: errorCode errorMessage

Una posible causa de este error es que el recurso de Kinesis Data Streams proporcionado no existe. O bien, QLDB no tiene permisos suficientes para escribir registros de datos en la transmisión de datos de Kinesis especificada.

Compruebe que el flujo de datos de Kinesis que proporciona en su solicitud de transmisión es correcto. Para obtener más información, consulte Creación y actualización de flujos de datos en la Guía para desarrolladores de Amazon Kinesis Data Streams.

Además, compruebe que ha definido una política para la transmisión de datos de Kinesis especificada que conceda al QLDB servicio (qldb.amazonaws.com) permisos para las siguientes acciones. Para obtener más información, consulte Permisos de secuencia.

• kinesis:PutRecord

• kinesis:PutRecords

• kinesis:DescribeStream

• kinesis:ListShards

IllegalArgumentException

Mensaje: Respuesta inesperada de Kinesis Data Streams al validar la configuración de Kinesis. Respuesta de Kinesis: errorCode errorMessage

El intento de escribir los registros de datos en el flujo de datos de Kinesis proporcionado falló con la respuesta de error de Kinesis proporcionada. Para obtener más información sobre las posibles causas, consulte Solución de problemas de los productores de Amazon Kinesis Data Streams en la Guía para desarrolladores de Amazon Kinesis Data Streams.

IllegalArgumentException

Mensaje: Start date must not be greater than end date.

Ambos InclusiveStartTime ExclusiveEndTime deben estar en el formato de fecha y hora ISO8601 y en hora universal coordinada ()UTC.

IllegalArgumentException

Mensaje: Start date cannot be in the future.

Ambos InclusiveStartTime y ExclusiveEndTime deben estar en formato de ISO 8601 fecha y hora y enUTC.

LimitExceededException

Mensaje: Exceeded the limit of 5 concurrently running Journal streams to Kinesis Data Streams

QLDBimpone un límite predeterminado de cinco secuencias de diario simultáneas.

Verificación de los datos del diario

En esta sección se enumeran las excepciones más comunes que QLDB se pueden obtener al verificar los datos del diario en un libro mayor. Para obtener más información acerca de esta característica, consulte Verificación de datos en Amazon QLDB.

Cada excepción incluye el mensaje de error específico, seguido de las API operaciones que pueden generarlo, una breve descripción y sugerencias de posibles soluciones.

IllegalArgumentException

Mensaje: The provided Ion value is not valid and cannot be parsed.

APIoperaciones: GetDigest, GetBlock, GetRevision

Asegúrese de proporcionar un valor de Amazon Ion válido antes de volver a intentar la solicitud.

IllegalArgumentException

Mensaje: The provided block address is not valid.

APIoperaciones: GetDigest, GetBlock, GetRevision

Asegúrese de proporcionar una dirección de bloque válida antes de volver a intentar la solicitud. Una dirección de bloque es una estructura de Amazon Ion que consta de dos campos: strandId y sequenceNo.

Por ejemplo: {strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}

IllegalArgumentException

Mensaje: The sequence number of the provided digest tip address is beyond the strand's latest committed record.

APIoperaciones: GetDigest, GetBlock, GetRevision

La dirección del tip del resumen que proporcione debe tener un número de secuencia inferior o igual al número de secuencia del último registro confirmado de la cadena del diario. Antes de volver a intentar realizar la solicitud, asegúrese de proporcionar una dirección de tip del resumen con un número de secuencia válido.

IllegalArgumentException

Mensaje: The Strand ID of the provided block address is not valid.

APIoperaciones: GetDigest, GetBlock, GetRevision

La dirección de bloque que proporcione debe tener un identificador de cadena que coincida con el identificador de cadena del diario. Antes de volver a intentar realizar la solicitud, asegúrate de proporcionar una dirección de bloque con un ID de cadena válido.

IllegalArgumentException

Mensaje: The sequence number of the provided block address is beyond the strand's latest committed record.

APIoperaciones: GetBlock, GetRevision

La dirección de bloque que proporcione debe tener un número de secuencia inferior o igual al número de secuencia del último registro confirmado de la cadena. Antes de volver a intentar realizar la solicitud, asegúrese de proporcionar una dirección de bloque con un número de secuencia válido.

IllegalArgumentException

Mensaje: The Strand ID of the provided block address must match the Strand ID of the provided digest tip address.

APIoperaciones: GetBlock, GetRevision

Solo puede verificar la revisión o el bloque de un documento si existe en la misma cadena del diario que el resumen que ha proporcionado.

IllegalArgumentException

Mensaje: The sequence number of the provided block address must not be greater than the sequence number of the provided digest tip address.

APIoperaciones: GetBlock, GetRevision

Solo puede verificar la revisión o el bloqueo de un documento si está incluido en el resumen que proporcione. Esto significa que se registró en el diario antes que la dirección del tip del resumen.

IllegalArgumentException

Mensaje: The provided Document ID was not found in the block at the specified block address.

APIoperación: GetRevision

El identificador de documento que proporcione debe estar en la dirección de bloque que proporcione. Antes de volver a intentar realizar la solicitud, asegúrese de que estos dos parámetros sean coherentes.