Inbyggda retry-logikleverantörer i SqlClient

Gäller för: .NET Framework .NET .NET Standard

Ladda ned ADO.NET

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory Skapar vårdgivare för gemensamma omprövningsscheman. Konfigurerbar omprovningslogik är avstängd som standard. Tilldela en leverantör till SqlConnection.RetryLogicProvider eller SqlCommand.RetryLogicProvider för att aktivera den för objektet.

Välj en leverantör för omförsök

De fasta, inkrementella och exponentiella leverantörerna lägger till slumpmässig jitter till varje intervall. Jitter minskar synkroniserade återförsöksburstar när många klienter råkar ut för samma avbrott.

NumberOfTries är det totala antalet försök, inklusive den initiala operationen. Till exempel NumberOfTries = 3 tillåter det första försöket och upp till två försök. Dess giltiga intervall är 1 till 60.

Inbyggd lista över övergående felmeddelanden

När SqlRetryLogicOption.TransientErrors är null, försöker de inbyggda leverantörerna igen vid de 20 felnummer som finns i SqlConfigurableRetryFactory.BaselineTransientErrors, grupperade efter var felet uppstår:

Varje fel beskrivs i de följande avsnitten.

I Microsoft.Data.SqlClient 7.0 gör SqlConfigurableRetryFactory.BaselineTransientErrors den inbyggda listan tillgänglig som en skrivskyddad samling. Använd den för att utöka baslinjen utan att kopiera felnummer från drivrutinskällan:

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 tidigare drivrutinsversioner, skapa en applikationsägd samling som innehåller de grundläggande fel du behöver och dina ytterligare fel. Innan du kopierar en baslinje, välj SqlClient-källtaggen som matchar din installerade paketversion och inspektera SqlConfigurableRetryFactory.cs. Listan på filialen main kan ändras efter att ditt paket släppts.

Fel vid anslutningsetablering

Följande fel kan försökas igen i den inbyggda listan eller är värda att lägga till i TransientErrors utöver den inbyggda listan.

Följande fel kan vara tillfälliga när de uppstår vid anslutningsetablering eller när en förfrågan skickas till servern. Försök igen på en kort, begränsad backoff. Fel som kvarstår efter några omförsök indikerar vanligtvis ett konfigurationsproblem, såsom fel server, saknade behörigheter, inkompatibla krypteringsinställningar eller uttömda kvoter, som omprövningar inte löser.

Fel på instruktionsnivå finns inte i den här listan eftersom de utlöses när anslutningen har upprättats och felet lämnar sessionen användbar. De vanligaste återförsöksbara instruktionsfelen är 1205 (deadlock victim) och 1222 (tidsgräns för låsbegäran). Försök igen hela transaktionen i stället för den enda misslyckade instruktionen.

Felmeddelandetexten kommer från Azure SQL tillfälliga anslutningsfel. Dessa fel kan försökas igen i SQL Server, Azure SQL Database, Azure SQL Managed Instance, SQL-databas i Microsoft Fabric och dedikerade SQL-pooler i Azure Synapse Analytics.

Fel under kommandoexekvering

Följande fel uppstår efter att en anslutning har upprättats, medan ett kommando körs. Försök igen hela transaktionen, inte det individuella kontoutdraget. Att försöka om en sats i en transaktion kan duplicera tidigare arbete eller bryta mot transaktionens ordergarantier.

Satsnivåfel som speglar ett batch- eller schemaproblem (till exempel 102 syntaxfel, 207 ogiltig kolumn, 2812 saknad lagrad procedur) är inte övergående. Fixa frågetexten eller schemabindningen; Att försöka igen hjälper inte.

Felmeddelandetexten kommer från sys.messages-katalogvyn . Dessa fel kommer från SQL Server-motorn, så deras antal är desamma över SQL Server, Azure SQL Database, Azure SQL Managed Instance, SQL-databas i Microsoft Fabric och dedikerade SQL-pooler i Azure Synapse Analytics, oavsett driver.

Drivrutinen, inte motorn, visar klientsidans representationer av tidsavslutning och avbokningsfel (till exempel Microsoft. Data.SqlClient-timeout-2), så dessa fel finns inte i den inbyggda listan. Om din applikation fångar dessa fel separat, hantera dem vid samma transaktionsgräns som motorfelen som beskrivits tidigare.

Kommando- och transaktionsbeteende

De inbyggda leverantörerna gör inte omförsök när ett kommando körs inom en omgivande TransactionScope eller har en SqlTransaction kopplad till sig. Kommandot körs en gång utan omprovningslogik. Att försöka om ett enda uttalande i en transaktion kan duplicera tidigare arbete eller bryta mot transaktionens avsedda ordning.

Använd SqlRetryLogicOption.AuthorizedSqlCondition för att begränsa kommandoförsök till operationer som din applikation säkert kan upprepa. Predikatet får kommandotexten. Om predikatet returnerar false, körs kommandot en gång utan omprovningslogik.

Example

För fullständiga exempel på anslutning och kommando, se:

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

Relaterat innehåll

• Skapa en anpassad återprövningsleverantör för SqlClient
• Konfigurerbar omprövningslogik i SqlClient
• Microsoft. Data.SqlClient för SQL Server