This topic describes the error handling methods and retry policies of Tablestore SDK for Python.
Tablestore SDK for Python handles errors as exceptions. If the operation succeeds, the called operation does not return an exception. If the operation fails, an exception is returned.
Tablestore SDK for Python has two types of exceptions: OTSClientError and OTSServiceError. Both are inherited from Exception.
- OTSClientError: an internal SDK exception, such as an invalid parameter value or a failure to parse the results returned by the server.
- OTSServiceError: a server error. When a server error occurs, the server parses and
returns the error message to the client. OTSServiceError has the following components:
- get_http_status: an HTTP status code such as 200 and 404.
- get_error_code: an error type string returned by Tablestore.
- get_error_message: an error message string returned by Tablestore.
- get_request_id: the UUID that identifies a request. If a problem persists, record the request ID and submit a ticket.
- Tablestore SDK for Python automatically retries operations in which an error occurs. In the default retry policy, the maximum retry attempts is 20, and the maximum retry interval is 3,000 ms. For more information about the retry policies for throttling errors and internal server errors related to write operations, see tablestore/retry.py.
- You can also customize a retry policy by inheriting the RetryPolicy class, and pass in the custom retry policy when you construct an OTSClient object.
- DefaultRetryPolicy: the default retry policy. Only read operations are retried. The maximum number of retry attempts is 20, and the maximum retry interval is 3,000 ms.
- NoRetryPolicy: No operation is retried.
- NoDelayRetryPolicy: a retry policy without delay. Exercise caution when you configure this policy.
- WriteRetryPolicy: The write operations are retried based on the default retry policy.