O Tablestore SDK for PHP trata erros como exceções. Este tópico descreve os métodos de tratamento de erros, as exceções e as políticas de nova tentativa do Tablestore SDK for PHP.
Métodos
O Tablestore SDK for PHP trata erros como exceções. Se o sistema não retornar nenhuma exceção, a operação será bem-sucedida. Caso contrário, a operação falhará.
Operações em lote, como BatchGetRow e BatchWriteRow, só serão bem-sucedidas se o sistema verificar a ausência de exceções e o status de sucesso de cada linha.
Exceções
OTSClientException e OTSServerException são exceções comuns ao usar o Tablestore SDK for PHP. Ambas herdam da classe Exception.
OTSClientException: exceção interna do SDK, como valor de parâmetro inválido.
-
OTSServerException: erro de servidor extraído de uma mensagem de erro. A OTSServerException fornece as seguintes informações:
getHttpStatus(): código de status HTTP, como 200 ou 404.
getOTSErrorCode(): string com o tipo de erro retornado pelo Tablestore.
getOTSErrorMessage(): descrição detalhada do erro retornada pelo Tablestore.
getRequestId(): UUID que identifica a solicitação. Se o problema persistir, anote o valor do parâmetro RequestId e abra um ticket.
Novas tentativas
O Tablestore SDK for PHP repete operações automaticamente quando ocorre um erro. Na política padrão, o número máximo de tentativas é 3 e o intervalo máximo entre elas é de 2.000 milissegundos. Para mais informações, consulte Retry.
Você também pode definir uma política personalizada configurando RetryPolicy em OTSClientConfig.
O Tablestore SDK for PHP oferece as seguintes políticas de nova tentativa:
DefaultRetryPolicy: política padrão. Permite até 3 tentativas com intervalo máximo de 2.000 milissegundos. As repetições ocorrem em casos de limitação de taxa (throttling) e erros internos do servidor relacionados a operações de leitura.
NoRetryPolicy: não executa novas tentativas.