Fournisseurs de logique de tentative intégrés dans SqlClient

S’applique à : .NET Framework .NET Standard

Télécharger ADO.NET

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory crée des prestataires pour des plannings de réessais courants. La logique de nouvelle tentative configurable est désactivée par défaut. Attribuez un fournisseur à SqlConnection.RetryLogicProvider ou SqlCommand.RetryLogicProvider pour l’activer pour cet objet.

Choisissez un prestataire de réessais.

Les stratégies fixe, incrémentielle et exponentielle ajoutent une gigue aléatoire à chaque intervalle. La gigue réduit les vagues synchronisées de nouvelles tentatives lorsque de nombreux clients subissent la même interruption de service.

NumberOfTries est le nombre total de tentatives, y compris l’opération initiale. Par exemple, NumberOfTries = 3 permet la première tentative et jusqu’à deux tentatives. Sa plage valide est de 1 à 60.

Liste d’erreurs transitoires intégrée

Lorsque SqlRetryLogicOption.TransientErrors est null, les fournisseurs intégrés réessaient les 20 nombres d’erreur dans SqlConfigurableRetryFactory.BaselineTransientErrors, regroupés selon l’origine de la défaillance :

Chaque erreur est décrite dans les sections qui suivent.

Dans Microsoft. Data.SqlClient 7.0 SqlConfigurableRetryFactory.BaselineTransientErrors expose la liste intégrée comme une collection en lecture seule. Utilisez-le pour étendre la base sans copier les numéros d’erreur de la source du pilote :

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

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

Pour les versions antérieures des pilotes, créez une collection appartenant à l’application qui contient les erreurs de base nécessaires ainsi que vos erreurs supplémentaires. Avant de copier une baseline, sélectionnez la balise source SqlClient qui correspond à la version de votre package installé et inspectez SqlConfigurableRetryFactory.cs. La liste de la branche main peut changer après la publication de votre package.

Erreurs lors de l’établissement de la connexion

Les erreurs suivantes sont réessayables dans la liste intégrée ou valent la peine d’être ajoutées TransientErrors en haut de la liste intégrée.

Les erreurs suivantes peuvent être transitoires lorsqu’elles surviennent lors de l’établissement de la connexion ou lors de l’envoi d’une requête au serveur. Réessayez après un court délai (« backoff ») limité. Les erreurs qui persistent après quelques tentatives indiquent généralement un problème de configuration, comme un mauvais serveur, des permissions manquantes, des paramètres de chiffrement incompatibles ou un quota épuisé, que la réévaluation ne corrigera pas.

Les erreurs au niveau des instructions ne figurent pas dans cette liste, car elles se produisent une fois la connexion établie et l’échec laisse la session utilisable. Les erreurs d’instruction pouvant faire l’objet d’une nouvelle tentative les plus courantes sont 1205 (victime d’interblocage) et 1222 (délai d’expiration de la demande de verrouillage). Relancez l’intégralité de la transaction plutôt que la seule instruction qui échoue.

Le texte du message d’erreur provient de Azure SQL erreurs de connexion temporaires. Ces erreurs peuvent être réessayées sur SQL Server, Azure SQL Database, Azure SQL Managed Instance, base de données SQL dans Microsoft Fabric, ainsi que dans les pools SQL dédiés dans Azure Synapse Analytics.

Erreurs lors de l’exécution des commandes

Les erreurs suivantes surviennent après l’établissement d’une connexion, pendant qu’une commande est en cours. Essayez à nouveau toute la transaction, pas le relevé individuel. La répétition d'une instruction au sein d'une transaction peut entraîner une duplication du travail déjà effectué ou enfreindre les garanties d'ordre de la transaction.

Les erreurs au niveau de l’instruction qui reflètent un problème de batch ou de schéma (par exemple, 102 des erreurs de syntaxe, 207 une colonne invalide, 2812 une procédure stockée manquante) ne sont pas transitoires. Fixez le texte de requête ou la liaison du schéma ; Réessayer n’aide pas.

Le texte des messages d’erreur provient de la vue catalogue sys.messages . Ces erreurs proviennent du moteur SQL Server, donc leurs chiffres sont les mêmes pour SQL Server, Azure SQL Database, Azure SQL Managed Instance, base de données SQL dans Microsoft Fabric, et les pools SQL dédiés dans Azure Synapse Analytics, quel que soit le pilote.

C’est le pilote, et non le moteur, qui expose des représentations côté client des erreurs de délai d’expiration d’instruction et d’annulation (par exemple, le délai d’expiration Microsoft.Data.SqlClient -2) ; ces erreurs ne figurent donc pas dans la liste prédéfinie. Si votre application détecte ces erreurs séparément, gérez-les à la même frontière de transaction que les erreurs du moteur décrites précédemment.

Comportement des commandes et des transactions

Les fournisseurs intégrés n’effectuent pas de nouvelle tentative lorsqu’une commande s’exécute dans un contexte ambiant TransactionScope ou est associée à un SqlTransaction. La commande s’exécute une fois sans logique de réessayage. Réessayer une seule instruction dans une transaction peut dupliquer un travail antérieur ou violer l’ordre prévu de la transaction.

Utilisez-le SqlRetryLogicOption.AuthorizedSqlCondition pour limiter les tentatives de commande aux opérations que votre application peut répéter en toute sécurité. Le prédicat reçoit le texte de la commande. Si le prédicat retourne false, la commande s’exécute une fois sans logique de réessayage.

Exemple

Pour des exemples complets de connexion et de commande, voir :

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

Contenu connexe

• Créer un fournisseur de tentatives personnalisé pour SqlClient
• Logique de nouvelle tentative configurable dans SqlClient
• Microsoft. Data.SqlClient pour SQL Server