Los errores de Go SDK se notifican como valores nosqlerr.Error definidos como parte de la API. Los errores se dividen en 2 amplias categorías:

• Errores que se pueden volver a intentar con la expectativa de que se realicen correctamente. Se trata de errores reintentables en los que la llamada al método Error.Retryable() devuelve true. Entre los ejemplos de estos se incluyen nosqlerr.OperationLimitExceeded, nosqlerr.ReadLimitExceeded, nosqlerr.WriteLimitExceeded, que se generan cuando se exceden los límites de consumo de recursos.
• Errores que no se deben reintentar, ya que se volverán a producir. Entre los ejemplos se incluyen nosqlerr.IllegalArgumentError, nosqlerr.TableNotFoundError, etc.

Además, los códigos de error se dividen en 2 categorías generales:

• Errores que se pueden recuperar con la expectativa de que la operación se vuelva a intentar. Algunos ejemplos son ErrorCode.READ_LIMIT_EXCEEDED y ErrorCode.WRITE_LIMIT_EXCEEDED, que son errores de limitación (relevantes para el entorno en la nube), así como ErrorCode.NETWORK_ERROR, ya que la mayoría de las condiciones de red son temporales.
• Errores que no se deben reintentar, ya que es probable que la operación vuelva a fallar. Entre los ejemplos se incluyen ErrorCode.ILLEGAL_ARGUMENT (representado por NoSQLArgumentError), ErrorCode.TABLE_NOT_FOUND, etc.

Puede determinar si NoSQLError se puede reintentar comprobando la propiedad retryable. Su valor se define en verdadero para errores reintentables y es falso o no se define para errores no reintentables.

El controlador reintentará automáticamente las operaciones con un error reintentable. El manejador de reintentos determina:

• Indica si la operación se volverá a intentar y cuántas veces.
• Tiempo que se debe esperar antes de cada reintento.

RetryHandler es una interfaz con 2 propiedades:

• RetryHandler#doRetry que determina si se debe reintentar la operación en función de la operación, el número de reintentos que se han producido hasta el momento y el error. Esta propiedad suele ser una función, pero también se puede definir en booleano falso para desactivar los reintentos automáticos.
• RetryHandler#delay que determina el tiempo que se debe esperar antes de cada reintento sucesivo según la misma información proporcionada a RetryHandler#doRetry. Esta propiedad suele ser una función, pero también se puede establecer en número de milisegundos para un retraso constante.

NoSQLException sirve como clase base para muchas excepciones devueltas por el controlador. Sin embargo, en algunos casos el controlador utiliza tipos de excepción estándar, como:

• ArgumentException y sus subclases como ArgumentNullException. Se devuelven cuando se transfiere un argumento no válido a un método o cuando se transfiere una configuración no válida (en código o en JSON) para crear una instancia NoSQLClient.
• TimeoutException se devuelve cuando finaliza el tiempo de espera de una operación emitida por NoSQLClient. Si obtiene muchas excepciones de timeout, puede intentar aumentar los valores de timeout en NoSQLConfig o en el argumento de opciones transferido al método NoSQLClient.
• InvalidOperationException se devuelve cuando el servicio tiene un estado no válido para realizar una operación. También se puede devolver si la consulta ha fallado porque su procesamiento ha excedido el límite de memoria especificado en QueryOptions.MaxMemoryMB o NoSQLConfig.MaxMemoryMB. En este caso, puede aumentar el límite de memoria correspondiente. De lo contrario, puede volver a intentar la operación.
• InvalidCastException y OverflowException se pueden producir cuando se trabaja con subclases de FieldValue e intenta convertir un valor en un tipo que no admite o convierte un valor numérico en un tipo más pequeño que causa el desbordamiento aritmético.
• OperationCanceledException y TaskCanceledException si ha emitido una cancelación de la operación iniciada por un método de NoSQLClient utilizando el CancellationToken proporcionado.

Además, las excepciones pueden dividirse en dos grandes categorías:

• Excepciones que se pueden recuperar con la expectativa de que la operación se vuelva a intentar. En general, son subclases de RetryableException. Estas incluyen excepciones de limitación y otras excepciones en las que un recurso no está disponible temporalmente. Algunas otras subclases de NoSQLException también se pueden volver a intentar en función de las condiciones en las que se produjo la excepción. Además, los errores relacionados con la red se pueden reintentar porque la mayoría de las condiciones de red son temporales.
• Excepciones que no se deben reintentar porque seguirán fallando después de volver a intentarlo. Incluyen excepciones como TableNotFoundException, TableExistsException y otras, así como excepciones estándar como ArgumentException.

Puede determinar si una determinada instancia de NoSQLException se puede reintentar comprobando su propiedad IsRetryable.

De manera predeterminada, el controlador reintentará automáticamente las operaciones que generaron una excepción reintentable (consulte la información anterior). El controlador utiliza el manejador de reintentos para controlar los reintentos de operación. El manejador de reintentos determina:

• Indica si la operación se volverá a intentar y cuántas veces.
• Tiempo que se debe esperar antes de cada reintento.

Todos los controladores de reintentos implementan la interfaz IRetryHandler. Esta interfaz proporciona dos métodos, uno para determinar si se debe reintentar la operación en su estado actual y otro para determinar un retraso de reintento antes del siguiente reintento. Puede utilizar el manejador de reintentos por defecto o definir su propio manejador de reintentos como propiedad RetryHandler de NoSQLConfig al crear la instancia NoSQLClient.

Por defecto, el controlador utiliza la clase NoSQLRetryHandler que controla las bajas según el tipo de operación, el tipo de excepción y si el número de reintentos realizados ha alcanzado un máximo preconfigurado. También utiliza un retraso de retroceso exponencial para esperar entre reintentos que comienzan con un retraso base preconfigurado. Puede personalizar las propiedades como el número máximo de reintentos, el retraso base y otros mediante la creación de su propia instancia de NoSQLRetryHandler y su definición como una propiedad RetryHandler en NoSQLConfig. Por ejemplo:

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

Si no especifica el manejador de reintentos, el controlador utilizará una instancia de NoSQLRetryHandler con valores por defecto para todos los parámetros. También puede elegir crear su propia clase de manejador de reintentos implementando la interfaz IRetryHandler . La última opción es desactivar todos los reintentos juntos. Puede hacerlo si planea reintentar las operaciones dentro de la aplicación en su lugar. Para desactivar los reintentos, defina la propiedad RetryHandler de NoSQLConfig en NoRetries:

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