Provider di logica di ritentazione integrati in SqlClient

Si applica a: .NET Framework .NET .NET Standard

Scarica ADO.NET

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory Crea fornitori per i programmi di ritentativi comuni. La logica di ripetizione dei tentativi configurabile è disattivata per impostazione predefinita. Assegna un provider a SqlConnection.RetryLogicProvider o SqlCommand.RetryLogicProvider per abilitarlo per quell'oggetto.

Scegli un fornitore di ritentativi

I fornitori fissi, incrementali ed esponenziali aggiungono jitter casuale a ogni intervallo. Il jitter riduce i picchi sincronizzati di nuovi tentativi quando molti client riscontrano lo stesso disservizio.

NumberOfTries è il numero totale di tentativi, inclusa l'operazione iniziale. Ad esempio, NumberOfTries = 3 permette il primo tentativo e fino a due tentativi. Il suo intervallo valido va da 1 a 60.

Elenco di errori transitori integrato

Quando SqlRetryLogicOption.TransientErrors è null, i provider integrati riprovano i 20 numeri di errore in SqlConfigurableRetryFactory.BaselineTransientErrors, raggruppati per dove ha origine il guasto:

Ogni errore è descritto nelle sezioni successive.

In Microsoft. Data.SqlClient 7.0, SqlConfigurableRetryFactory.BaselineTransientErrors espone la lista integrata come una collezione di sola lettura. Usalo per estendere la base senza copiare i numeri di errore dalla sorgente del driver:

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

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

Per versioni precedenti dei driver, crea una collezione di proprietà dell'applicazione che contenga gli errori di base necessari e i tuoi errori aggiuntivi. Prima di copiare una baseline, seleziona il tag sorgente SqlClient che corrisponde alla versione installata del pacchetto e ispeziona SqlConfigurableRetryFactory.cs. L'elenco nel ramo main può cambiare dopo il rilascio del tuo pacchetto.

Errori durante l'instaurazione della connessione

I seguenti errori sono quelli per cui è possibile riprovare nell'elenco integrato oppure che vale la pena aggiungere a TransientErrors oltre a quelli dell'elenco integrato.

I seguenti errori possono essere transitori quando si verificano durante l'instaurazione della connessione o durante l'invio di una richiesta al server. Riprova dopo un breve backoff limitato. Gli errori che persistono oltre pochi tentativi di solito indicano un problema di configurazione, come un server sbagliato, permessi mancanti, impostazioni di crittografia incompatibili o quota esaurita, che un ritentativo non risolverà.

Gli errori a livello di istruzione non sono inclusi in questo elenco perché vengono attivati dopo la connessione e l'errore lascia utilizzabile la sessione. Gli errori ripetibili delle istruzioni più comuni sono 1205 (vittima di deadlock) e 1222 (timeout della richiesta di blocco). Ritentare l'intera transazione anziché la singola istruzione non riuscita.

Il testo del messaggio di errore proviene da Azure SQL errori di connessione temporanei. Questi errori possono essere ritentati su SQL Server, database SQL di Azure, Istanza gestita di SQL di Azure, database SQL in Microsoft Fabric e pool SQL dedicati in Azure Synapse Analytics.

Errori durante l'esecuzione del comando

I seguenti errori si verificano dopo l'instaurazione di una connessione, mentre un comando è in esecuzione. Riprova l'intera transazione, non l'estratto conto individuale. Riprovare un'istruzione all'interno di una transazione può duplicare operazioni precedenti o violare le garanzie relative all'ordine di esecuzione della transazione.

Gli errori a livello di istruzione che riflettono un problema batch o di schema (ad esempio, 102 errori di sintassi, 207 colonna non valida, 2812 procedura memorizzata mancante) non sono transitori. Correggere il testo della query o l'associazione allo schema; riprovare non serve.

Il testo del messaggio di errore proviene dalla vista del catalogo sys.messages. Questi errori provengono dal motore SQL Server, quindi i loro numeri sono gli stessi su SQL Server, database SQL di Azure, Istanza gestita di SQL di Azure, database SQL in Microsoft Fabric e pool SQL dedicati in Azure Synapse Analytics, indipendentemente dal driver.

Il driver, non il motore, espone rappresentazioni lato client degli errori di timeout e annullamento delle istruzioni (ad esempio, il timeout di Microsoft.Data.SqlClient -2), quindi questi errori non sono inclusi nell'elenco predefinito. Se la tua applicazione intercetta questi errori separatamente, gestiteli nell'ambito della stessa transazione degli errori del motore descritti in precedenza.

Comportamento di comandi e transazioni

I provider predefiniti non eseguono nuovi tentativi quando un comando viene eseguito all'interno di un TransactionScope esistente o a cui è associato un SqlTransaction. Il comando viene eseguito una volta senza meccanismo di ripetizione. Rieseguire una singola istruzione all'interno di una transazione può duplicare operazioni già eseguite o violare l'ordine previsto della transazione.

Usalo SqlRetryLogicOption.AuthorizedSqlCondition per limitare i tentativi di comando alle operazioni che la tua applicazione può ripetere in sicurezza. Il predicato riceve il testo del comando. Se il predicato restituisce false, il comando viene eseguito una volta senza logica di ritento.

Esempio

Per esempi completi di connessione e comando, vedi:

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

Contenuti correlati

• Crea un provider di ritenti personalizzati per SqlClient
• Logica di ripetizione dei tentativi configurabile in SqlClient
• Microsoft.Data.SqlClient per SQL Server