Verbindingsopties voor Microsoft. Data.SqlClient

Microsoft.Data.SqlClient-verbindingsopties bepalen hoe de driver een verbinding tot stand brengt, identificeert, routeert, opnieuw tot stand probeert te brengen en in een pool opneemt. Stel ze in een verbindingsreeks in of via overeenkomende SqlConnectionStringBuilder eigenschappen.

Voor Microsoft Entra ID-authenticatie, zie Microsoft Entra ID authenticatie. Voor TLS-instellingen, zie Versleuteling en certificaatvalidatie.

Instellingen instellen met SqlConnectionStringBuilder

Gebruik de builder in plaats van fragmenten van verbindingsreeks aan elkaar te koppelen:

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,
};

De code gebruikt namen van bouwerwoningen. De tabellen gebruiken de gebruikelijke spelling van de verbindingsreeks. De chauffeur accepteert ook gedocumenteerde aliassen.

Opties voor time-out

Verbindings- en commando-timeouts meten verschillend werk. Connect Timeout Beperkt de uitvoering van zoekopdrachten niet. Command Timeout Beperkt authenticatie of het wachten op een gepoolde verbinding niet.

A CancellationToken staat los van beide instellingen. Geef het door aan OpenAsync, commando-uitvoering en lezersmethoden, zodat de aanroeper kan stoppen met wachten voordat een timeout verloopt.

Workload-identiteit en routeringsopties

Application Intent=ReadOnly Normaal gesproken wordt deze gekoppeld aan een availability group listener of een service-endpoint dat read routing ondersteunt. Zie Hoge beschikbaarheid en rampenherstel.

Netwerk- en pakketopties

MultiSubnetFailover=true wordt niet ondersteund voor benoemde instanties, andere protocollen dan TCP, databasespiegeling of eindpunten die zijn geconfigureerd met meer dan 64 IP-adressen. Het is veilig voor een single-IP TCP-endpoint.

Microsoft. Data.SqlClient 7.0 heeft ook een procesbrede AppContext-schakelaar die elke verbinding kan laten functioneren alsof MultiSubnetFailover=true. De standaard verbindingsreeks blijft false wanneer die switch niet is ingeschakeld. Zie AppContext-switches in SqlClient.

Poolopties

Poolinstellingen gelden voor elke afzonderlijke pool, niet voor het hele proces of de databaseserver. Voordat u ophaalt Max Pool Size, bevestig dat verbindingen en lezers snel worden verwijderd en dat de database het resulterende totaal over elke applicatieinstantie kan accepteren.

Voor poolsleutels, tokengedrag, blokkeringsperioden, clearing en diagnostiek, zie SQL Server connection pooling.

Opties voor verbindingsherstel

De eerste herpoging tijdens het herstel van de verbinding is onmiddellijk. Connect Retry Interval Van toepassing vóór latere pogingen. Om de ingebouwde initiële open herpoging voor één bewerking te omzeilen, gebruik je een open overload met OpenWithoutRetry.

Deze sleutelwoorden proberen een commando dat mislukt terwijl het wordt uitgevoerd niet opnieuw uit te voeren. Gebruik configureerbare herkansingslogica voor een aangepast open- of commandobeleid. Voer opdrachten alleen opnieuw uit wanneer de gevolgen ervan veilig kunnen worden herhaald.

Serveridentiteit en certificaatopties

Deze opties lossen specifieke naamgevingsvereisten voor certificaten of Kerberos op. Ze vervangen de normale authenticatie en certificaatvalidatie niet.

Host Name In Certificate verandert de naam die wordt gebruikt voor certificaatmatching. Het vertrouwt een niet-vertrouwde uitgever niet. Server Certificate pint een exact certificaatbestand en vereist een applicatie-update wanneer dat certificaat roteert.

Onjuiste SPN-overrides kunnen Kerberos-authenticatie verhinderen of de beoogde identiteitscontrole verzwakken. Corrigeer DNS- en SPN-registraties in plaats van uitzonderingen in te stellen, indien mogelijk.

Houd de verbindingslijnen klein. Voeg alleen een optie toe als je kunt aangeven welk gedrag het verandert en hoe de werklast dat gedrag verifieert.

Wijzigingen in de optie bekijken

Voordat je een optie in productie verandert:

1. Noteer de huidige verbindingsreeks, driverversie, eindpunttype en waargenomen probleem.
2. Verander één gedrag tegelijk.
3. Test verbindingsopbouw, authenticatie, certificaatvalidatie, pooling, failover, annulering en het uitvoeren van query's.
4. Meet harde verbindingen, poolwachttijden, verbindingslatentie en foutgetallen.
5. Bevestig de instelling op elke gedeployeerde instantie.

Verbindingsstrings maken deel uit van de poolsleutel. Een gefaseerde uitrol kan tijdelijk zowel oude als nieuwe pools creëren, wat het totale aantal fysieke databaseverbindingen verhoogt.

Verwante onderwerpen

• Verbindingsreeksen
• Verbind met een databron
• SQL Server verbindingspooling
• Versleuteling en certificaatvalidatie
• Hoge beschikbaarheid en herstel na noodgevallen
• SqlConnectionStringBuilder