Opciones de conexión para Microsoft. Data.SqlClient

Las opciones de conexión de Microsoft.Data.SqlClient controlan cómo el controlador establece, identifica, enruta, reintenta y administra la agrupación de conexiones. Establézcalas en una cadena de conexión o mediante las propiedades correspondientes SqlConnectionStringBuilder.

Para la autenticación de Microsoft Entra ID, véase autenticación Microsoft Entra ID. Para la configuración de TLS, consulta Cifrado y validación de certificados.

Establecer opciones con SqlConnectionStringBuilder

Usa el builder en lugar de concatenar fragmentos de cadena de conexión:

var builder = new SqlConnectionStringBuilder
{
    DataSource = "tcp:sql.example.com,1433",
    InitialCatalog = "Orders",
    IntegratedSecurity = true,
    Encrypt = SqlConnectionEncryptOption.Mandatory,
    ApplicationName = "Orders.Worker",
    ConnectTimeout = 30,
    ConnectRetryCount = 3,
    ConnectRetryInterval = 10,
    MultiSubnetFailover = true,
};

El código utiliza nombres de propiedades de los constructores. Las tablas usan las formas habituales de escribir las cadenas de conexión. El conductor también acepta alias documentados.

Opciones de tiempo de espera

Los tiempos de espera de conexión y de comandos se aplican a operaciones diferentes. Connect Timeout no limita la ejecución de consultas. Command Timeout No limita la autenticación ni la espera para una conexión agrupada.

A CancellationToken es independiente de ambas configuraciones. Pásalo a OpenAsync, a la ejecución de comandos y a los métodos de lectura para que el llamante deje de esperar antes de que expire el tiempo de espera.

Opciones de identidad de carga de trabajo y enrutamiento

Application Intent=ReadOnly Normalmente se empareja con un oyente de grupo de disponibilidad o un punto final de servicio que soporta enrutamiento de lectura. Consulta Alta disponibilidad y recuperación ante desastres.

Opciones de red y paquetes

MultiSubnetFailover=true no está soportado con instancias nombradas, protocolos no TCP, espejamiento de bases de datos ni endpoints configurados con más de 64 direcciones IP. Es seguro para un punto final TCP de una sola IP.

Microsoft.Data.SqlClient 7.0 también dispone de un conmutador de AppContext para todo el proceso que puede hacer que todas las conexiones se comporten como si MultiSubnetFailover=true. La cadena de conexión por defecto se mantiene false cuando ese switch no está activado. Consulta los interruptores AppContext en SqlClient.

Opciones de agrupación

La configuración del pool se aplica a cada pool distinto, no a todo el proceso o servidor de base de datos. Antes de aumentar Max Pool Size, confirma que las conexiones y lectores se eliminan rápidamente y que la base de datos puede aceptar el total resultante en cada instancia de aplicación.

Para claves de pool, comportamiento de tokens, periodos de bloqueo, limpieza y diagnóstico, consulta SQL Server connection pooling.

Opciones de recuperación de conexión

El primer intento durante la recuperación de conexión es inmediato. Connect Retry Interval se aplica antes de los intentos posteriores. Para saltarse el reintento abierto inicial incorporado para una operación, se utiliza una sobrecarga abierta con OpenWithoutRetry.

Estas palabras clave no intentan repetir un comando que falla mientras está en ejecución. Utiliza lógica de reintento configurable para una política personalizada de apertura o comando. Vuelva a intentar los comandos solo cuando sea seguro repetir sus efectos.

Opciones de identidad del servidor y certificados

Estas opciones satisfacen requisitos específicos de nomenclatura de certificados o de Kerberos. No sustituyen la autenticación normal ni la validación de certificados.

Host Name In Certificate cambia el nombre utilizado para la coincidencia de certificados. No confía en un emisor no confiable. Server Certificate ancla un archivo de certificado específico y requiere una actualización de la aplicación cuando ese certificado se renueva.

Las invalidaciones incorrectas del SPN pueden impedir la autenticación de Kerberos o debilitar la comprobación de identidad prevista. Corrija la configuración de DNS y el registro de SPN en lugar de establecer anulaciones cuando sea posible.

Mantén las cuerdas de conexión pequeñas. Añade una opción solo cuando puedas indicar qué comportamiento cambia y cómo la carga de trabajo verifica ese comportamiento.

Cambios en la opción de revisión

Antes de cambiar una opción en producción:

1. Registra la cadena de conexión actual, la versión del driver, el tipo de endpoint y el problema observado.
2. Cambia un comportamiento a la vez.
3. Prueba del establecimiento de conexiones, la autenticación, la validación de certificados, la agrupación de conexiones, la conmutación por error, la cancelación y la ejecución de consultas.
4. Mide conexiones duras, esperas en pool, latencia de conexión y números de error.
5. Confirma la configuración en cada instancia desplegada.

Las cadenas de conexión forman parte de la clave del pool. Un despliegue por etapas puede crear temporalmente tanto pools antiguos como nuevos, lo que aumenta el número total de conexiones físicas a bases de datos.

Contenido relacionado

• Cadenas de conexión
• Conectarse a un origen de datos
• Agrupación de conexiones a SQL Server
• Cifrado y validación de certificados
• Alta disponibilidad y recuperación ante desastres
• SqlConnectionStringBuilder