Le kit de développement logiciel (SDK) Python de Tablestore gère les erreurs via des exceptions. Cette rubrique décrit les méthodes de gestion des erreurs de Tablestore, les informations relatives aux exceptions ainsi que les politiques de nouvelle tentative.
Méthode
Le SDK Python de Tablestore utilise des exceptions pour gérer les erreurs. Un appel d'API aboutit s'il ne lève aucune exception. En cas de levée d'exception, l'opération a échoué.
Pour les opérations par lot, telles que BatchGetRow et BatchWriteRow, vérifiez la présence d'exceptions et le statut de chaque ligne. L'appel d'API n'est considéré comme réussi que si toutes les lignes ont été traitées avec succès.
Exceptions
Le SDK Python de Tablestore définit deux types d'exceptions : OTSClientError et OTSServiceError. Toutes deux héritent de la classe Exception.
OTSClientError : indique une exception survenue au sein du SDK, telle qu'une configuration incorrecte des paramètres ou une erreur lors de l'analyse du résultat renvoyé.
-
OTSServiceError : indique une erreur côté serveur, extraite de la réponse du serveur. OTSServiceError contient les membres suivants :
get_http_status : le code de retour HTTP, tel que 200 ou 404.
get_error_code : la chaîne de type d'erreur renvoyée par Tablestore.
get_error_message : le message d'erreur renvoyé par Tablestore.
get_request_id : l'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 une opération en cas d'erreur. Par défaut, le nombre maximal de nouvelles tentatives est de 20 et l'intervalle maximal entre les tentatives est de 3 000 ms. Le SDK effectue de nouvelles tentatives pour les erreurs de limitation de débit et les erreurs internes du serveur lors des opérations de lecture. Pour plus d'informations, consultez tablestore/retry.py.
Pour créer une politique de nouvelle tentative personnalisée, héritez de la classe RetryPolicy. Lors de l'initialisation d'un objet OTSClient, transmettez la politique de nouvelle tentative personnalisée en tant que paramètre.
Le SDK fournit les politiques de nouvelle tentative suivantes.
DefaultRetryPolicy : il s'agit de la politique de nouvelle tentative par défaut. Elle ne concerne que les opérations de lecture. Le nombre maximal de nouvelles tentatives est de 20 et l'intervalle maximal entre les tentatives est de 3 000 ms.
NoRetryPolicy : aucune nouvelle tentative n'est effectuée.
NoDelayRetryPolicy : politique de nouvelle tentative sans délai. Utilisez cette politique avec prudence.
WriteRetryPolicy : basée sur la politique de nouvelle tentative par défaut, cette politique inclut également les nouvelles tentatives pour les opérations d'écriture.