Go-SDK-Fehler werden als nosqlerr.Error-Werte gemeldet, die als Teil der API definiert sind. Fehler werden in 2 allgemeine Kategorien unterteilt:

• Fehler, die möglicherweise mit der Erwartung wiederholt werden, dass sie bei der Wiederholung erfolgreich sind. Dies sind wiederholbare Fehler, bei denen der Error.Retryable()-Methodenaufruf true zurückgibt. Beispiele hierfür sind nosqlerr.OperationLimitExceeded, nosqlerr.ReadLimitExceeded, nosqlerr.WriteLimitExceeded, die bei Überschreitung von Ressourcenverbrauchslimits ausgelöst werden.
• Fehler, die nicht wiederholt werden sollten, da sie erneut fehlschlagen. Beispiele hierfür sind nosqlerr.IllegalArgumentError, nosqlerr.TableNotFoundError usw.

Außerdem werden Fehlercodes in 2 allgemeine Kategorien unterteilt:

• Fehler, die möglicherweise mit der Erwartung wiederholt werden, dass der Vorgang bei der Wiederholung erfolgreich ist. Beispiele hierfür sind ErrorCode.READ_LIMIT_EXCEEDED und ErrorCode.WRITE_LIMIT_EXCEEDED, bei denen es sich um Throttling-Fehler (für die Cloud-Umgebung relevant) handelt, sowie ErrorCode.NETWORK_ERROR, da die meisten Netzwerkbedingungen temporär sind.
• Fehler, die nicht wiederholt werden sollten, da der Vorgang höchstwahrscheinlich erneut fehlschlägt. Beispiele hierfür sind ErrorCode.ILLEGAL_ARGUMENT (repräsentiert durch NoSQLArgumentError), ErrorCode.TABLE_NOT_FOUND usw.

Sie können bestimmen, ob NoSQLError wiederholt werden kann, indem Sie die Eigenschaft retryable prüfen. Der Wert ist für wiederholbare Fehler auf "true" gesetzt und für nicht wiederholbare Fehler falsch oder nicht definiert.

Der Treiber wiederholt die Vorgänge bei einem wiederholbaren Fehler automatisch. Wiederholungs-Handler bestimmt:

• Gibt an, ob und wie oft der Vorgang wiederholt wird.
• Wartezeit vor jeder Wiederholung.

RetryHandler ist eine Schnittstelle mit 2 Eigenschaften:

• RetryHandler#doRetry, die bestimmt, ob der Vorgang basierend auf dem Vorgang wiederholt werden soll, die Anzahl der bisherigen Wiederholungen und der Fehler. Diese Eigenschaft ist in der Regel eine Funktion, kann jedoch auch auf "Boolescher Wert" gesetzt werden, um automatische Wiederholungen zu deaktivieren.
• RetryHandler#delay, die bestimmt, wie lange vor jeder nachfolgenden Wiederholung gewartet werden soll, basierend auf denselben Informationen wie für RetryHandler#doRetry. Diese Eigenschaft ist in der Regel eine Funktion, kann jedoch auch auf die Anzahl der Millisekunden für eine konstante Verzögerung festgelegt werden.

NoSQLException dient als Basisklasse für viele vom Treiber ausgelöste Ausnahmen. In bestimmten Fällen verwendet der Treiber jedoch Standardausnahmetypen wie:

• ArgumentException und die zugehörigen Unterklassen, wie ArgumentNullException. Sie werden ausgelöst, wenn ein ungültiges Argument an eine Methode übergeben wird oder wenn eine ungültige Konfiguration (in Code oder in JSON) an die NoSQLClient-Instanz übergeben wird.
• TimeoutException wird ausgelöst, wenn ein von NoSQLClient ausgegebener Vorgang wegen Timeout abgebrochen wurde. Wenn Sie viele Timeoutausnahmen erhalten, können Sie versuchen, die Timeoutwerte in NoSQLConfig oder im Optionsargument zu erhöhen, das an die Methode NoSQLClient übergeben wird.
• InvalidOperationException wird ausgelöst, wenn der Service einen ungültigen Status zur Ausführung eines Vorgangs aufweist. Es kann auch ausgelöst werden, wenn die Abfrage nicht erfolgreich war, weil die Verarbeitung das in QueryOptions.MaxMemoryMB oder NoSQLConfig.MaxMemoryMB angegebene Speicherlimit überschritten hat. In diesem Fall können Sie den entsprechenden Speichergrenzwert erhöhen. Andernfalls können Sie den Vorgang wiederholen.
• InvalidCastException und OverflowException können auftreten, wenn Sie mit Untergruppen von FieldValue arbeiten und versuchen, einen Wert in einen Typ umzuwandeln, der nicht unterstützt wird, oder einen numerischen Wert in einen kleineren Typ umwandeln, der zu arithmetischem Überlauf führt.
• OperationCanceledException und TaskCanceledException, wenn Sie eine Stornierung des Vorgangs ausgegeben haben, der von einer Methode von NoSQLClient mit dem angegebenen CancellationToken gestartet wurde.

Außerdem können Ausnahmen in zwei große Kategorien unterteilt werden:

• Ausnahmen, bei denen der Vorgang bei der Wiederholung möglicherweise erfolgreich war. Im Allgemeinen handelt es sich dabei um Unterklassen von RetryableException. Dazu gehören Throttling-Ausnahmen sowie andere Ausnahmen, bei denen eine Ressource vorübergehend nicht verfügbar ist. Einige andere Unterklassen von NoSQLException können auch wiederholt werden, je nachdem, unter welchen Bedingungen die Ausnahme aufgetreten ist. Darüber hinaus können netzwerkbezogene Fehler wiederholt werden, da die meisten Netzwerkbedingungen vorübergehend sind.
• Ausnahmen, die nicht wiederholt werden sollten, da sie nach der Wiederholung immer noch nicht erfolgreich sind. Sie umfassen Ausnahmen wie TableNotFoundException, TableExistsException und andere sowie Standardausnahmen wie ArgumentException.

Sie können bestimmen, ob eine Instanz von NoSQLException wiederholt werden kann, indem Sie die Eigenschaft IsRetryable prüfen.

Standardmäßig wiederholt der Treiber automatisch Vorgänge, die eine wiederholbare Ausnahme ausgelöst haben (siehe oben). Der Treiber verwendet den Wiederholungs-Handler zur Steuerung von Vorgangswiederholungen. Der Wiederholungs-Handler bestimmt Folgendes:

• Gibt an, ob und wie oft der Vorgang wiederholt wird.
• Wartezeit vor jeder Wiederholung.

Alle Wiederholungs-Handler implementieren die Schnittstelle IRetryHandler. Diese Schnittstelle bietet zwei Methoden: eine Methode, um zu bestimmen, ob der Vorgang im aktuellen Status wiederholt werden soll, und eine andere Methode, um eine Wiederholungsverzögerung vor der nächsten Wiederholung zu bestimmen. Sie können den Standardwiederholungs-Handler verwenden oder Ihren eigenen Wiederholungs-Handler beim Erstellen der NoSQLClient-Instanz als RetryHandler-Eigenschaft NoSQLConfig festlegen.

Standardmäßig verwendet der Treiber die Klasse NoSQLRetryHandler, die Ausgänge basierend auf Vorgangstyp, Ausnahmetyp steuert und ob die Anzahl der ausgeführten Wiederholungen einen vorkonfigurierten Höchstwert erreicht hat. Außerdem wird die exponentielle Backoff-Verzögerung verwendet, um zwischen Wiederholungen zu warten, die mit einer vorkonfigurierten Basisverzögerung beginnen. Sie können die Eigenschaften wie die maximale Anzahl an Wiederholungen, Basisverzögerungen und andere anpassen, indem Sie Ihre eigene Instanz von NoSQLRetryHandler erstellen und sie als RetryHandler-Eigenschaft in NoSQLConfig festlegen. Beispiel:

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

Wenn Sie den Wiederholungs-Handler nicht angeben, verwendet der Treiber eine Instanz von NoSQLRetryHandler mit Standardwerten für alle Parameter. Alternativ können Sie eine eigene Wiederholungs-Handler-Klasse erstellen, indem Sie die IRetryHandler -Schnittstelle implementieren. Die letzte Option besteht darin, Wiederholungen gemeinsam zu deaktivieren. Dies ist möglich, wenn Sie stattdessen die Vorgänge in Ihrer Anwendung wiederholen möchten. Um Wiederholungen zu deaktivieren, setzen Sie die Eigenschaft RetryHandler von NoSQLConfig auf NoRetries:

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