El kit de desarrollo de software (SDK) de PHP para Tablestore gestiona los errores mediante excepciones. Este tema describe el manejo de errores en Tablestore, la información de las excepciones y las políticas de reintentos.
Método
El SDK de PHP para Tablestore controla los errores al lanzar excepciones. Si una llamada a la API finaliza sin excepciones, la operación se completó correctamente; de lo contrario, finalizó con errores.
Para operaciones por lotes, como BatchGetRow y BatchWriteRow, debe comprobar si hay excepciones y verificar el estado de cada fila. La llamada a la API se considera exitosa únicamente si todas las filas se procesan correctamente.
Excepciones
El SDK de PHP para Tablestore define dos tipos de excepciones: OTSClientException y OTSServerException. Ambas heredan de la clase base Exception.
OTSClientException: excepción que ocurre dentro del SDK; por ejemplo, si un parámetro se establece incorrectamente.
-
OTSServerException: error del lado del servidor que se analiza sintácticamente a partir del mensaje de error devuelto. Un objeto OTSServerException contiene los siguientes miembros:
getHttpStatus(): código de respuesta HTTP, como 200 o 404.
getOTSErrorCode(): cadena con el tipo de error que devuelve Tablestore.
getOTSErrorMessage(): descripción detallada del error que devuelve Tablestore.
getRequestId(): identificador único universal (UUID) que identifica la solicitud de manera única. Si no logra resolver un problema, registre este RequestId y envíe un ticket.
Reintentos
El SDK reintenta automáticamente las operaciones cuando ocurre un error. La política predeterminada reintenta hasta 3 veces con un intervalo máximo de 2000 ms entre intentos. Para obtener más información, consulte Retry.
También puede personalizar la política de reintentos si modifica RetryPolicy en OTSClientConfig.
El SDK implementa las siguientes políticas de reintentos:
DefaultRetryPolicy: política de reintentos predeterminada. Esta política reintenta una operación hasta 3 veces con un intervalo máximo de 2000 ms. Se aplica a errores relacionados con limitación de velocidad y a errores internos del servidor en operaciones de lectura.
NoRetryPolicy: no se realizan reintentos.