Le kit de développement logiciel (SDK) PHP de Tablestore gère les erreurs en levant des exceptions. Cette rubrique décrit la gestion des erreurs dans Tablestore, les informations relatives aux exceptions et les politiques de nouvelle tentative.
Méthode
Le SDK PHP de Tablestore gère les erreurs en levant des exceptions. Si un appel d'API se termine sans lever d'exception, l'opération a réussi. Dans le cas contraire, elle a échoué.
Pour les opérations par lot, telles que BatchGetRow et BatchWriteRow, vous devez vérifier la présence d'exceptions ainsi que l'état de chaque ligne. L'appel d'API entier est considéré comme réussi uniquement si toutes les lignes ont été traitées avec succès.
Exceptions
Le SDK PHP de Tablestore définit deux types d'exceptions : OTSClientException et OTSServerException. Ces deux exceptions héritent de la classe de base Exception.
OTSClientException : exception qui se produit au sein du SDK, par exemple si un paramètre est défini incorrectement.
-
OTSServerException : erreur côté serveur analysée à partir du message d'erreur renvoyé par le serveur. Un objet OTSServerException contient les membres suivants :
getHttpStatus() : code de retour HTTP, tel que 200 ou 404.
getOTSErrorCode() : chaîne de type d'erreur renvoyée par Tablestore.
getOTSErrorMessage() : description détaillée de l'erreur renvoyée par Tablestore.
getRequestId() : identifiant universel unique (UUID) qui identifie la requête de manière unique. Si vous ne parvenez pas à résoudre un problème, notez cet ID de requête et soumettez un ticket.
Nouvelles tentatives
Le SDK relance automatiquement les opérations lorsqu'une erreur se produit. La politique par défaut consiste à effectuer un maximum de 3 nouvelles tentatives avec un intervalle maximal de 2 000 ms entre chaque tentative. Pour plus d'informations, consultez Retry.
Vous pouvez également personnaliser la politique de nouvelle tentative en modifiant RetryPolicy dans OTSClientConfig.
Le SDK met en œuvre les politiques de nouvelle tentative suivantes :
DefaultRetryPolicy : politique de nouvelle tentative par défaut. Cette politique relance une opération jusqu'à 3 fois avec un intervalle maximal de 2 000 ms. Elle s'applique aux erreurs liées à la limitation de débit et aux erreurs internes du serveur pour les opérations de lecture.
NoRetryPolicy : aucune nouvelle tentative n'est effectuée.