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.
Errores comunes del QLDB controlador de Amazon
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 esta sección se describen los errores de tiempo de ejecución que puede generar el QLDB controlador de Amazon al interactuar con la QLDBsesión API.
La siguiente es una lista de excepciones comunes devueltas por el controlador. Cada excepción incluye el mensaje de error específico, seguido de una breve descripción y sugerencias de posibles soluciones.
- CapacityExceededException
-
Mensaje:
Capacity exceededAmazon 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óntransactionIdha caducadoUna 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
sessionIdha caducadoQLDBdescartó 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 sessionEl 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
InvalidSessionExceptioninicial.
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 exceededQLDBestranguló 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 StartSessionRequestpodrí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.
StartSessionRequestEl controlador mantiene un conjunto de sesiones que se reutilizan en todas las transacciones, lo que puede ayudar a reducir el número de llamadasStartSessionRequestque 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 limitUn 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 maxConcurrentTransactions
mé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 openLa 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
Transactionobjeto 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.
