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 programas de reintentos comunes. 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 fluctuación aleatoria a cada intervalo. La fluctuación reduce las ráfagas de reintentos sincronizadas cuando muchos clientes se enfrentan a la misma interrupción del servicio.

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 del controlador, crea una colección propia de la aplicación que contenga los errores de referencia que necesites 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 de la rama main puede cambiar tras el lanzamiento de 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. Reintentar con un retroceso breve 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 en el nivel de instrucción no figuran en esta lista porque se producen después de que se haya establecido la conexión y el error permite seguir utilizando la sesión. Los errores de instrucción más comunes que se pueden reintentar son el 1205 (víctima de interbloqueo) y el 1222 (tiempo de espera de solicitud de bloqueo agotado). Reintenta toda la transacción en lugar de la única instrucción que ha generado un error.

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 solo la instrucción individual. Volver a intentar una sola instrucción dentro de una transacción puede duplicar el trabajo anterior o incumplir las garantías de ordenación 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, y no el motor, muestra las representaciones del lado del cliente de los errores de tiempo de espera y cancelación de instrucciones (por ejemplo, el tiempo de espera de Microsoft.Data.SqlClient -2), por lo que estos errores no figuran en la lista integrada. 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 omiten el reintento cuando un comando se ejecuta dentro de un TransactionScope ambiental o tiene un SqlTransaction asociado. El comando se ejecuta una vez sin lógica de reintento. Reintentar una sola instrucción dentro de una transacción puede duplicar el trabajo anterior o infringir 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