Proveedores de lógica de reintentos integrados en SqlClient

Se aplica a: .NET Framework .NET Standard

Descargar ADO.NET

Microsoft.Data.SqlClient.SqlConfigurableRetryFactory crea proveedores para los calendarios comunes de reintentos. La lógica de reintentos configurable está desactivada por defecto. Asigna un proveedor a SqlConnection.RetryLogicProvider o SqlCommand.RetryLogicProvider para habilitarlo para ese objeto.

Elige un proveedor de reintentos

Los proveedores fijos, incrementales y exponenciales añaden jitter aleatorio a cada intervalo. La variación aleatoria reduce las ráfagas sincronizadas en los reintentos cuando muchos clientes experimentan la misma interrupción.

NumberOfTries es el número total de intentos, incluyendo la operación inicial. Por ejemplo, NumberOfTries = 3 permite el primer intento y hasta dos intentos. Su rango válido es del 1 al 60.

Lista de errores transitorios incorporada

Cuando SqlRetryLogicOption.TransientErrors es null, los proveedores integrados vuelven a intentar los 20 números de error en SqlConfigurableRetryFactory.BaselineTransientErrors, agrupados según el origen del fallo:

Cada error se describe en las secciones siguientes.

En Microsoft.Data.SqlClient 7.0, SqlConfigurableRetryFactory.BaselineTransientErrors expone la lista integrada como una colección de solo lectura. Úsalo para extender la línea base sin copiar números de error del origen del controlador:

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

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

Para versiones anteriores de controladores, crea una colección propiedad de la aplicación que contenga los errores base que necesitas y tus errores adicionales. Antes de copiar una línea base, selecciona la etiqueta de código fuente SqlClient que coincida con la versión de tu paquete instalado e inspecciona SqlConfigurableRetryFactory.cs. La lista en la main sucursal puede cambiar después de que liberen tu paquete.

Errores durante el establecimiento de la conexión

Los siguientes errores se pueden volver a intentar en la lista integrada o merece la pena añadirlos a TransientErrors además de la lista integrada.

Los siguientes errores pueden ser transitorios cuando ocurren durante el establecimiento de la conexión o al enviar una solicitud al servidor. Vuelva a intentarlo en un retroceso corto y limitado. Los errores que persisten después de unos pocos intentos suelen indicar un problema de configuración, como un servidor equivocado, permisos faltos, ajustes de cifrado incompatibles o cuota agotada, que intentar de nuevo no solucionará.

Los errores a nivel de instrucción no están en esta lista porque se producen después de que se haya establecido la conexión y el fallo no impide seguir usando la sesión. Los errores de instrucciones que se pueden reintentar más comunes son 1205 (víctima de interbloqueo) y 1222 (tiempo de espera de la solicitud de bloqueo). Reintente la transacción completa en lugar de la sola instrucción que falla.

El texto del mensaje de error procede de Azure SQL errores de conexión transitorios. Estos errores se pueden volver a intentar en SQL Server, Azure SQL Database, Azure SQL Managed Instance, la base de datos SQL de Microsoft Fabric y los pools SQL dedicados de Azure Synapse Analytics.

Errores durante la ejecución de comandos

Los siguientes errores ocurren después de establecer una conexión, mientras se ejecuta un comando. Vuelve a intentar toda la transacción, no el extracto individual. Volver a intentar una instrucción dentro de una transacción puede duplicar trabajos anteriores o violar las garantías de orden de la transacción.

Los errores a nivel de sentencia que reflejan un problema de lote o esquema (por ejemplo, 102 errores de sintaxis, 207 columna inválida, 2812 procedimiento almacenado perdido) no son transitorios. Fijar el texto de consulta o la vinculación del esquema; Reintentar no ayuda.

El texto del mensaje de error procede de la vista de catálogo sys.messages. Estos errores provienen del motor SQL Server, por lo que sus números son los mismos en SQL Server, Azure SQL Database, Azure SQL Managed Instance, base de datos SQL en Microsoft Fabric y pools SQL dedicados en Azure Synapse Analytics, independientemente del driver.

El controlador, no el motor, expone representaciones del lado cliente de los errores de tiempo de espera de instrucción y de cancelación (por ejemplo, el tiempo de espera de Microsoft.Data.SqlClient -2), por lo que estos errores no están en la lista incorporada. Si tu aplicación detecta estos errores por separado, trátalos en el mismo límite de transacción que los errores del motor descritos anteriormente.

Comportamiento de comandos y transacciones

Los proveedores integrados saltan el intento cuando un comando se ejecuta dentro de un ambiente TransactionScope o tiene un SqlTransaction adjunto. El comando se ejecuta una vez sin lógica de reintento. Reintentar una única instrucción dentro de una transacción puede duplicar operaciones previas o vulnerar el orden previsto de la transacción.

Use SqlRetryLogicOption.AuthorizedSqlCondition para limitar los reintentos de comandos a operaciones que tu aplicación pueda repetir de forma segura. El predicado recibe el texto del comando. Si el predicado devuelve false, el comando se ejecuta una vez sin lógica de reintento.

Ejemplo

Para ejemplos completos de conexión y comandos, véase:

• SqlConnection.RetryLogicProvider
• SqlCommand.RetryLogicProvider

Contenido relacionado

• Crea un proveedor de reintentos personalizado para SqlClient
• Lógica de reintento configurable en SqlClient
• Microsoft. Data.SqlClient para SQL Server