Os erros Go SDK são reportados como valores nosqlerr.Error definidos como parte da API. Os erros são divididos em 2 categorias amplas:

• Erros que podem ser repetidos com expectativa de que possam ser bem-sucedidos na nova tentativa. Estes são erros repetitivos nos quais a chamada do método Error.Retryable() retorna true. Exemplos disso incluem nosqlerr.OperationLimitExceeded, nosqlerr.ReadLimitExceeded, nosqlerr.WriteLimitExceeded, que são gerados quando limites de consumo de recursos são excedidos.
• Erros que não devem ser repetidos, pois falharão novamente. Exemplos disso incluem nosqlerr.IllegalArgumentError, nosqlerr.TableNotFoundError etc.

Além disso, os códigos de erro são divididos em 2 categorias amplas:

• Erros que podem ser repetidos com expectativa de que a operação possa ser bem-sucedida na nova tentativa. Exemplos disso são ErrorCode.READ_LIMIT_EXCEEDED e ErrorCode.WRITE_LIMIT_EXCEEDED, que são erros de aceleração (relevantes para o ambiente de Nuvem), e também ErrorCode.NETWORK_ERROR, uma vez que a maioria das condições de rede são temporárias.
• Erros que não devem ser repetidos, pois a operação provavelmente falhará novamente. Exemplos disso incluem ErrorCode.ILLEGAL_ARGUMENT (representado por NoSQLArgumentError), ErrorCode.TABLE_NOT_FOUND etc.

Você pode determinar se o NoSQLError pode ser repetido verificando a propriedade retryable. Seu valor é definido como verdadeiro para erros repetitivos e é falso ou indefinido para erros não repetitivos.

O driver repetirá automaticamente as operações em um erro repetitivo. O handler de repetição determina:

• Se e quantas vezes a operação será repetida.
• Quanto tempo esperar antes de cada nova tentativa.

RetryHandler é uma interface com 2 propriedades:

• RetryHandler#doRetry que determina se a operação deve ser repetida com base na operação, o número de tentativas aconteceu até o momento e o erro ocorreu. Essa propriedade geralmente é uma função, mas também pode ser definida como falsa booliana para desativar novas tentativas automáticas.
• RetryHandler#delay que determina quanto tempo esperar antes de cada repetição sucessiva com base nas mesmas informações fornecidas para RetryHandler#doRetry. Essa propriedade geralmente é uma função, mas também pode ser definida como o número de milissegundos para um atraso constante.

NoSQLException serve como uma classe base para muitas exceções geradas pelo driver. No entanto, em determinados casos, o driver usa tipos de exceção padrão, como:

• ArgumentException e suas subclasses, como ArgumentNullException. Eles são lançados quando um argumento inválido é passado para um método ou quando uma configuração inválida (em código ou em JSON) é especificada para criar uma instância NoSQLClient.
• TimeoutException é lançado quando há timeout de uma operação emitida por NoSQLClient. Se você estiver obtendo muitas exceções de timeout, poderá tentar aumentar os valores de timeout em NoSQLConfig ou no argumento de opções passado para o método NoSQLClient.
• InvalidOperationException é lançado quando o serviço é um estado inválido para executar uma operação. Ela também poderá ser lançada se a consulta tiver falhado, pois seu processamento excedeu o limite de memória especificado em QueryOptions.MaxMemoryMB ou NoSQLConfig.MaxMemoryMB. Nesse caso, você pode aumentar o limite de memória correspondente. Caso contrário, você poderá repetir a operação.
• InvalidCastException e OverflowException podem ocorrer ao trabalhar com subáreas de FieldValue e tentar converter um valor em um tipo que não suporta ou converter um valor numérico em um tipo menor causando overflow aritmético.
• OperationCanceledException e TaskCanceledException se você tiver emitido um cancelamento da operação iniciada por um método NoSQLClient usando o CancellationToken fornecido.

Além disso, as exceções podem ser divididas em duas categorias amplas:

• Exceções que podem ser repetidas com expectativa de que a operação possa ser bem-sucedida na nova tentativa. Em geral, são subclasses de RetryableException. Isso inclui a limitação de exceções, bem como outras exceções em que um recurso está temporariamente indisponível. Algumas outras subclasses de NoSQLException também podem ser repetidas dependendo das condições nas quais a exceção ocorreu. Além disso, erros relacionados à rede são repetidos porque a maioria das condições de rede é temporária.
• Exceções que não devem ser repetidas porque ainda falharão após a nova tentativa. Eles incluem exceções como TableNotFoundException, TableExistsException e outras, além de exceções padrão, como ArgumentException.

Você pode determinar se determinada instância de NoSQLException pode ser repetida verificando sua propriedade IsRetryable.

Por padrão, o driver repetirá automaticamente as operações que geraram uma exceção repetitiva (veja acima). O driver usa o handler de repetição para controlar novas tentativas de operação. O handler de repetição determina:

• Se e quantas vezes a operação será repetida.
• Quanto tempo esperar antes de cada nova tentativa.

Todos os handlers de repetição implementam a interface IRetryHandler. Essa interface fornece dois métodos: um para determinar se a operação em seu estado atual deve ser repetida e outro para determinar um atraso de repetição antes da próxima repetição. Você tem a opção de usar o handler de repetição padrão ou definir seu próprio handler de repetição como propriedade RetryHandler de NoSQLConfig ao criar a instância NoSQLClient.

Por padrão, o driver usa a classe NoSQLRetryHandler que controla a retirada com base no tipo de operação, no tipo de exceção e se o número de novas tentativas executadas atingiu um máximo pré-configurado. Ele também usa atraso de backoff exponencial para aguardar entre novas tentativas, começando com um atraso base pré-configurado. Você pode personalizar as propriedades, como o número máximo de novas tentativas, atraso base e outras, criando sua própria instância de NoSQLRetryHandler e definindo-a como uma propriedade RetryHandler em NoSQLConfig. Por exemplo:

var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region = .....,
        ...............
        RetryHandler = new NoSQLRetryHandler
        {
            MaxRetryAttempts = 20,
            BaseDelay = TimeSpan.FromSeconds(2)
        }
    });

Se você não especificar o handler de repetição, o driver usará uma instância de NoSQLRetryHandler com valores padrão para todos os parâmetros. Como alternativa, você pode optar por criar sua própria classe de handler de repetição implementando a interface IRetryHandler . A última opção é desativar todas as tentativas juntas. Você poderá fazer isso se planejar repetir as operações no seu aplicativo. Para desativar novas tentativas, defina a propriedade RetryHandler como NoSQLConfig como NoRetries:

var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region = .....,
        ...............
        RetryHandler = NoSQLConfig.NoRetries
    });