Todos os produtos
Search
Central de documentação

Tablestore:.NET SDK error handling

Última atualização: Aug 04, 2026

O Tablestore .NET SDK trata erros lançando exceções. Este tópico descreve o método de tratamento de erros, as informações das exceções e as políticas de nova tentativa.

Método

O Tablestore .NET SDK gerencia erros lançando exceções. Se uma chamada de API não gerar exceção, a operação foi bem-sucedida. Caso contrário, a operação falhou.

Nota

Em operações em lote, como BatchGetRow e BatchWriteRow, verifique se há exceções e valide o status de cada linha. A chamada de API só é considerada bem-sucedida quando todas as linhas são processadas com êxito.

Exceções

O Tablestore .NET SDK oferece dois tipos de exceções: OTSClientException e OTSServerException. Ambas herdam da classe base Exception.

  • OTSClientException: Indica um erro interno do SDK, como parâmetro definido incorretamente ou falha ao analisar um resultado.

  • OTSServerException: Sinaliza um erro no lado do servidor, lançado após o SDK analisar uma mensagem de erro recebida do servidor. Um objeto OTSServerException geralmente contém os seguintes membros:

    • HttpStatusCode: Código de status HTTP, como 200 ou 404.

    • ErrorCode: String do código de erro retornada pelo Tablestore.

    • ErrorMessage: String da mensagem de erro retornada pelo Tablestore.

    • RequestId: Identificador Universalmente Único (UUID) que identifica a solicitação de forma exclusiva. Se não conseguir resolver o problema, anote este RequestId e envie um ticket.

Novas tentativas

  • O SDK repete operações automaticamente quando ocorre um erro. A política padrão executa até três novas tentativas, com intervalo máximo de 2000 ms entre elas. Para mais informações, consulte Retry.

  • Você também pode personalizar a política de nova tentativa modificando o parâmetro RetryPolicy em OTSClientConfig.