In SqlClient integrierte Anbieter für Wiederholungslogik

Gilt für: .NET Framework .NET .NET Standard

Herunterladen von ADO.NET

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory erstellt Provider für gängige Wiederholungszeitpläne. Konfigurierbare Wiederholungslogik ist standardmäßig deaktiviert. Weisen Sie SqlConnection.RetryLogicProvider oder SqlCommand.RetryLogicProvider einen Anbieter zu, um es für das Objekt zu aktivieren.

Wählen Sie einen Anbieter für Wiederholungen

Die festen, inkrementellen und exponentiellen Anbieter fügen jedem Intervall zufällige Jitter hinzu. Jitter reduziert synchronisierte Häufungen von Wiederholungsversuchen, wenn viele Clients von demselben Ausfall betroffen sind.

NumberOfTries ist die Gesamtzahl der Versuche, einschließlich der anfänglichen Operation. Zum Beispiel NumberOfTries = 3 erlaubt er den ersten Versuch und bis zu zwei Wiederholungen. Ihr gültiger Bereich liegt zwischen 1 und 60.

Eingebaute transiente Fehlerliste

Wenn SqlRetryLogicOption.TransientErrors auf null festgelegt ist, wiederholen die integrierten Anbieter die 20 Fehlernummern in SqlConfigurableRetryFactory.BaselineTransientErrors, gruppiert danach, wo der Fehler auftritt:

Jeder Fehler wird in den folgenden Abschnitten beschrieben.

In Microsoft.Data.SqlClient 7.0 stellt SqlConfigurableRetryFactory.BaselineTransientErrors die integrierte Liste als schreibgeschützte Sammlung bereit. Verwenden Sie es, um die Baseline zu erweitern, ohne Fehlernummern aus der Treiberquelle zu kopieren:

var transientErrors = SqlConfigurableRetryFactory.BaselineTransientErrors
    .Append(12345)
    .ToArray();

var options = new SqlRetryLogicOption
{
    NumberOfTries = 5,
    DeltaTime = TimeSpan.FromSeconds(2),
    MaxTimeInterval = TimeSpan.FromSeconds(30),
    TransientErrors = transientErrors,
};

Für frühere Treiberversionen erstellen Sie eine applikationseigene Sammlung, die die benötigten Basisfehler und Ihre zusätzlichen Fehler enthält. Bevor Sie eine Basislinie kopieren, wählen Sie das SqlClient-Quelltag aus, das Ihrer installierten Paketversion entspricht, und überprüfen Sie SqlConfigurableRetryFactory.cs. Die Liste in der Filiale main kann sich ändern, nachdem dein Paket freigegeben wurde.

Fehler beim Verbindungsaufbau

Die folgenden Fehler können in der integrierten Liste erneut versucht werden oder es lohnt sich, sie zusätzlich zur integrierten Liste in TransientErrors aufzunehmen.

Die folgenden Fehler können vorübergehend auftreten, wenn sie während der Verbindungsaufnahme oder beim Senden einer Anfrage an den Server auftreten. Versuchen Sie es mit einem kurzen, begrenzten Backoff. Fehler, die auch nach einigen Wiederholungen bestehen bleiben, deuten meist auf ein Konfigurationsproblem hin, wie einen falschen Server, fehlende Berechtigungen, inkompatible Verschlüsselungseinstellungen oder eine erschöpfte Quote, die ein erneuter Versuch nicht beheben kann.

Fehler auf Anweisungsebene befinden sich nicht in dieser Liste, da sie ausgelöst werden, nachdem die Verbindung hergestellt wurde und der Fehler die Sitzung nutzbar lässt. Die häufigsten Fehler bei Anweisungen, die erneut ausgeführt werden können, sind 1205 (Deadlock-Opfer) und 1222 (Zeitüberschreitung bei der Sperranforderung). Wiederholen Sie die gesamte Transaktion statt der einzelnen fehlerhaften Anweisung.

Fehlermeldungstext stammt aus Azure SQL vorübergehenden Verbindungsfehlern. Diese Fehler sind für Wiederholungen in SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance, SQL-Datenbank in Microsoft Fabric und dedizierten SQL-Pools in Azure Synapse Analytics zugelassen.

Fehler während der Befehlsausführung

Die folgenden Fehler treten auf, nachdem eine Verbindung hergestellt wurde, während ein Befehl ausgeführt wird. Versuchen Sie die gesamte Transaktion erneut, nicht die individuelle Kontoausrechnung. Die Wiederholung einer Anweisung innerhalb einer Transaktion kann dazu führen, dass frühere Arbeit dupliziert wird oder die Reihenfolgegarantien der Transaktion verletzt werden.

Fehler auf Anweisungsniveau, die ein Batch- oder Schemaproblem widerspiegeln (zum Beispiel 102 Syntaxfehler, 207 ungültige Spalte, 2812 fehlende gespeicherte Prozedur), sind nicht vorübergehend. Beheben Sie den Abfragetext oder die Schema-Bindung; Ein erneuter Versuch hilft nicht.

Der Fehlermeldungstext stammt aus der sys.messages-Katalogansicht . Diese Fehler stammen vom SQL Server-Datenbankmodul, daher sind ihre Nummern in SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance, SQL-Datenbank in Microsoft Fabric und dedizierten SQL-Pools in Azure Synapse Analytics unabhängig vom Treiber identisch.

Der Treiber, nicht die Engine, gibt clientseitige Darstellungen von Fehlern aufgrund von Anweisungszeitüberschreitungen und Abbrüchen aus (z. B. das Microsoft.Data.SqlClient-Timeout -2), sodass diese Fehler nicht in der integrierten Liste enthalten sind. Wenn Ihre Anwendung diese Fehler separat erkennt, behandeln Sie sie an derselben Transaktionsgrenze wie die zuvor beschriebenen Engine-Fehler.

Befehls- und Transaktionsverhalten

Die integrierten Anbieter überspringen den Wiederholungsversuch, wenn ein Befehl innerhalb eines TransactionScope ausgeführt wird oder ihm ein SqlTransaction zugeordnet ist. Der Befehl läuft einmal ohne Logik für einen erneuten Versuch. Die Wiederholung einer einzelnen Anweisung innerhalb einer Transaktion kann dazu führen, dass frühere Aktionen dupliziert werden oder die beabsichtigte Reihenfolge der Transaktion verletzt wird.

Verwenden Sie SqlRetryLogicOption.AuthorizedSqlCondition, um Wiederholungen von Befehlen auf Vorgänge zu beschränken, die Ihre Anwendung sicher wiederholen kann. Das Prädikat erhält den Befehlstext. Wenn das Prädikat zurückgibt false, wird der Befehl einmal ohne Retry-Logik ausgeführt.

Beispiel

Für vollständige Verbindungs- und Befehlsbeispiele siehe:

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

Verwandte Inhalte

• Erstellen Sie einen benutzerdefinierten Wiederholungsanbieter für SqlClient
• Konfigurierbare Wiederholungslogik in SqlClient
• Microsoft. Data.SqlClient für SQL Server