Wbudowani dostawcy logiki ponawiania w SqlClient

Dotyczy: .NET Framework .NET Standard

Pobieranie ADO.NET

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory tworzy dostawców dla typowych harmonogramów powtórek. Domyślnie jest wyłączona konfigurowalna logika powtórek. Przypisz dostawcę do SqlConnection.RetryLogicProvider lub SqlCommand.RetryLogicProvider, aby go włączyć dla tego obiektu.

Wybierz dostawcę powtórek

Mechanizmy stały, przyrostowy i wykładniczy dodają losowe odchylenie czasowe do każdego odstępu. Jitter zmniejsza synchronizowane serie powtórek, gdy wielu klientów napotyka tę samą awarię.

NumberOfTries to całkowita liczba prób, wliczając początkową operację. Na przykład NumberOfTries = 3 umożliwia wykonanie pierwszej próby i maksymalnie dwóch ponownych prób. Prawidłowy zakres to od 1 do 60.

Wbudowana lista błędów przejściowych

Gdy SqlRetryLogicOption.TransientErrors ma wartość null, wbudowani dostawcy ponawiają próby dla 20 numerów błędów z SqlConfigurableRetryFactory.BaselineTransientErrors, pogrupowanych według miejsca pochodzenia awarii:

Każdy błąd opisany jest w kolejnych sekcjach.

W Microsoft. Data.SqlClient 7.0 SqlConfigurableRetryFactory.BaselineTransientErrors udostępnia wbudowaną listę jako kolekcję tylko do odczytu. Użyj go do rozszerzenia bazy bez kopiowania numerów błędów ze źródła sterownika:

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

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

W przypadku wcześniejszych wersji sterowników stwórz kolekcję należącą do aplikacji, która zawiera potrzebne błędy bazowe oraz dodatkowe błędy. Przed skopiowaniem baseline wybierz tag źródłowy SqlClienta, który odpowiada wersji zainstalowanego pakietu, i sprawdź SqlConfigurableRetryFactory.cs. Lista w gałęzi main może ulec zmianie po wydaniu pakietu.

Błędy podczas nawiązywania połączenia

Poniższe błędy można ponowić na wbudowanej liście lub warto dodać je do TransientErrors oprócz wbudowanej listy.

Poniższe błędy mogą być przejściowe, gdy pojawiają się podczas nawiązywania połączenia lub podczas wysyłania żądania do serwera. Ponów próbę na krótkim, ograniczonym wycofywaniu. Błędy, które utrzymują się po kilku próbach, zwykle wskazują na problem konfiguracyjny, taki jak zły serwer, brakujące uprawnienia, niekompatybilne ustawienia szyfrowania lub wyczerpany limit, którego ponowne próby nie naprawią.

Błędów na poziomie instrukcji nie ma na tej liście, ponieważ występują po nawiązaniu połączenia, a awaria pozostawia sesję w stanie używalnym. Najczęstsze błędy instrukcji, które można ponowić, to 1205 (ofiara impasu) i 1222 (przekroczenie limitu czasu żądania blokady). Ponów całą transakcję zamiast pojedynczej instrukcji, która nie powiodła się.

Tekst komunikatu o błędzie pochodzi z błędów połączenia przejściowego Azure SQL. Te błędy kwalifikują się do ponownego próbowania w SQL Server, Azure SQL Database, Azure SQL Managed Instance, bazie danych SQL w Microsoft Fabric oraz dedykowanych pulach SQL w Azure Synapse Analytics.

Błędy podczas wykonywania poleceń

Następujące błędy pojawiają się po nawiązaniu połączenia, podczas wykonywania polecenia. Spróbuj ponownie całą transakcję, nie indywidualne wyciągi. Ponowienie jednej instrukcji w transakcji może spowodować powielenie wcześniej wykonanej pracy lub naruszenie gwarancji kolejności wykonywania w transakcji.

Błędy na poziomie instrukcji, które odzwierciedlają problem wsadowy lub schematyczny (na przykład 102 błędy składniowe, 207 nieprawidłowa kolumna, 2812 brakująca procedura przechowywana), nie są przejściowe. Popraw tekst zapytania lub wiązanie schematu; Próba ponowna nie pomaga.

Tekst komunikatu o błędzie pochodzi z widoku katalogu sys.messages . Błędy te pochodzą z silnika SQL Server, więc ich liczby są takie same w SQL Server, Azure SQL Database, Azure SQL Managed Instance, bazie danych SQL w Microsoft Fabric oraz dedykowanych pulach SQL w Azure Synapse Analytics, regardless of driver.

Sterownik, a nie silnik, udostępnia po stronie klienta reprezentacje błędów limitu czasu i anulowania (na przykład limit czasu Microsoft.Data.SqlClient -2), więc te błędy nie są uwzględnione na wbudowanej liście. Jeśli twoja aplikacja wykrywa te błędy osobno, obsługuj je na tej samej granicy transakcji, co wcześniej opisane błędy silnika.

Zachowanie poleceń i transakcji

Wbudowani dostawcy pomijają ponawianie, gdy polecenie jest wykonywane wewnątrz otaczającego elementu TransactionScope lub ma dołączony element SqlTransaction. Polecenie jest wykonywane tylko raz, bez mechanizmu ponawiania. Ponowienie wykonania pojedynczej instrukcji w transakcji może spowodować powielenie wcześniej wykonanych operacji lub naruszenie zamierzonej kolejności operacji w transakcji.

Użyj SqlRetryLogicOption.AuthorizedSqlCondition, aby ograniczyć ponowienia poleceń do operacji, które aplikacja może bezpiecznie ponawiać. Predykat otrzymuje tekst komendy. Jeśli predykat zwraca false, polecenie wykonuje się raz bez logiki ponownej próby.

Example

Pełne przykłady połączeń i poleceń można znaleźć w następujących przypadkach:

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

Treści powiązane

• Stwórz niestandardowego dostawcy powtórek dla SqlClient
• Konfigurowalna logika ponawiania prób w programie SqlClient
• Microsoft. Data.SqlClient for SQL Server