Ingebouwde retry-logicaproviders in SqlClient

Van toepassing op: .NET Framework .NET Standard

ADO.NET downloaden

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory Maakt aanbieders voor gemeenschappelijke herhalingsschema's. Configureerbare herkansingslogica staat standaard uit. Wijs een provider toe aan SqlConnection.RetryLogicProvider of SqlCommand.RetryLogicProvider om het voor dat object in te schakelen.

Kies een herkansingsaanbieder

De vaste, incrementele en exponentiële providers voegen willekeurige jitter toe aan elk interval. Jitter vermindert gelijktijdige pieken in herhaalpogingen wanneer veel clients met dezelfde storing te maken krijgen.

NumberOfTries is het totale aantal pogingen, inclusief de initiële operatie. Bijvoorbeeld, NumberOfTries = 3 staat de eerste poging toe en tot twee herhalingen. Het geldige bereik ligt tussen 1 en 60.

Ingebouwde lijst met tijdelijke fouten

Wanneer SqlRetryLogicOption.TransientErrors is ingesteld op null, proberen de ingebouwde providers de 20 foutnummers in SqlConfigurableRetryFactory.BaselineTransientErrors opnieuw, gegroepeerd op basis van waar de fout optreedt:

Elke fout wordt beschreven in de volgende secties.

In Microsoft.Data.SqlClient 7.0 biedt SqlConfigurableRetryFactory.BaselineTransientErrors de ingebouwde lijst aan als een alleen-lezenverzameling. Gebruik het om de baseline uit te breiden zonder foutnummers van de driverbron te kopiëren:

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

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

Maak voor eerdere driverversies een verzameling die eigendom is van de toepassing en die de standaardfouten bevat die u nodig hebt, evenals de aanvullende fouten. Selecteer voordat je een baseline kopieert de SqlClient-brontag die overeenkomt met je geïnstalleerde pakketversie en inspecteer SqlConfigurableRetryFactory.cs. De lijst in de main branch kan veranderen nadat je package is uitgebracht.

Fouten tijdens het tot stand brengen van verbindingen

De volgende fouten kunnen opnieuw worden geprobeerd met de ingebouwde lijst of zijn de moeite waard om toe te voegen aan TransientErrors naast de ingebouwde lijst.

De volgende fouten kunnen voorbijgaand zijn wanneer ze optreden tijdens het tot stand brengen van de verbinding of tijdens het verzenden van een verzoek naar de server. Probeer het na een korte, begrensde wachttijd opnieuw. Fouten die langer dan een paar herpogingen blijven bestaan, wijzen meestal op een configuratieprobleem, zoals een verkeerde server, ontbrekende permissies, incompatibele encryptie-instellingen of een uitgeputte quotum, die een herpoging niet oplost.

Fouten op instructieniveau staan niet in deze lijst, omdat ze optreden nadat de verbinding tot stand is gekomen en de sessie na de fout bruikbaar blijft. De meest voorkomende fouten in opnieuw uit te voeren instructies zijn 1205 (deadlockslachtoffer) en 1222 (time-out bij een vergrendelingsaanvraag). Voer de hele transactie opnieuw uit in plaats van de enkele mislukte instructie.

De tekst van het foutbericht is afkomstig van Azure SQL tijdelijke verbindingsfouten. Deze fouten zijn geschikt voor herhaling via SQL Server, Azure SQL Database, Azure SQL Managed Instance, SQL database in Microsoft Fabric en speciale SQL-pools in Azure Synapse Analytics.

Fouten tijdens commando-uitvoering

De volgende fouten treden op nadat een verbinding is opgezet, terwijl een commando wordt uitgevoerd. Probeer de hele transactie opnieuw, niet de individuele afschrift. Het opnieuw proberen van één statement binnen een transactie kan eerder werk dupliceren of de ordeningsgaranties van de transactie schenden.

Fouten op instructieniveau die een batch- of schemaprobleem weerspiegelen (bijvoorbeeld 102 syntaxisfouten, 207 ongeldige kolom, 2812 ontbrekende opgeslagen procedure) zijn niet tijdelijk. Fix de querytekst of de schemabinding; Opnieuw proberen helpt niet.

De foutmelding komt uit de sys.messages-catalogusweergave . Deze fouten komen van de SQL Server-engine, dus hun aantallen zijn hetzelfde in SQL Server, Azure SQL Database, Azure SQL Managed Instance, SQL-database in Microsoft Fabric en speciale SQL-pools in Azure Synapse Analytics, ongeacht de driver.

De driver, niet de engine, geeft representaties aan de clientzijde van statement-time-out- en annuleringsfouten weer (bijvoorbeeld de Microsoft.Data.SqlClient -2-time-out), daarom staan deze fouten niet in de ingebouwde lijst. Als je applicatie deze fouten apart oppikt, behandel ze dan aan dezelfde transactiegrens als de eerder beschreven enginefouten.

Commando- en transactiegedrag

De ingebouwde providers voeren geen nieuwe poging uit wanneer een opdracht binnen een bestaande TransactionScope wordt uitgevoerd of wanneer er een SqlTransaction aan is gekoppeld. Het commando wordt één keer uitgevoerd zonder logica voor nieuwe pogingen. Het opnieuw proberen van een enkele verklaring binnen een transactie kan eerder werk dupliceren of de bedoelde volgorde van de transactie schenden.

Gebruik SqlRetryLogicOption.AuthorizedSqlCondition het om commando-retries te beperken tot bewerkingen die je applicatie veilig kan herhalen. Het predicaat ontvangt de opdrachttekst. Als het predicaat terugkeert false, voert het commando één keer uit zonder herkansingslogica.

Example

Voor volledige voorbeelden van verbindingen en commando's, zie:

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

Verwante onderwerpen

• Maak een aangepaste herhalingsprovider voor SqlClient
• Configureerbare logica voor opnieuw proberen in SqlClient
• Microsoft. Data.SqlClient voor SQL Server