Anslutningsalternativ för Microsoft. Data.SqlClient

Microsoft. Data.SqlClient-anslutningsalternativ styr hur drivrutinen etablerar, identifierar, routar, försöker om och poolar en anslutning. Ange dem i en anslutningssträng eller via motsvarande SqlConnectionStringBuilder egenskaper.

För Microsoft Entra ID-autentisering, se Microsoft Entra ID-autentisering. För TLS-inställningar, se Kryptering och certifikatvalidering.

Sätt inställningar med SqlConnectionStringBuilder

Använd buildern istället för att sammanfoga fragment av reťazec pripojenia:

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

Koden använder byggarens egenskapsnamn. Tabellerna använder vanliga stavningar i reťazec pripojenia. Föraren accepterar också dokumenterade alias.

Timeout-alternativ

Anslutnings- och kommandotidsgränser avser olika typer av arbete. Connect Timeout Det begränsar inte frågeexekveringen. Command Timeout Det begränsar inte autentisering eller väntan på en poolad anslutning.

En CancellationToken är separat från båda inställningarna. Skicka den till OpenAsync, kommandoexekvering och läsarmetoder så att anroparen kan sluta vänta innan en timeout går ut.

Arbetslastsidentitet och routningsalternativ

Application Intent=ReadOnly kopplas vanligtvis ihop med en tillgänglighetsgrupplyssnare eller en tjänstslutpunkt som stöder läsroutning. Se Hög tillgänglighet och katastrofåterställning.

Nätverks- och paketalternativ

MultiSubnetFailover=true stöds inte med namngivna instanser, icke-TCP-protokoll, databasspegling eller endpoints konfigurerade med fler än 64 IP-adresser. Det är säkert för en TCP-endpoint med en enda IP.

Microsoft. Data.SqlClient 7.0 har också en processomfattande AppContext-switch som kan få varje anslutning att bete sig som om MultiSubnetFailover=true. Anslutningssträngen förblir false som standard när den inställningen inte är aktiverad. Se AppContext-switchar i SqlClient.

Alternativ för poolning

Poolinställningar gäller för varje separat pool, inte för hela processen eller databasservern. Innan du höjer Max Pool Size, bekräfta att anslutningar och läsare tas bort snabbt och att databasen kan acceptera det resulterande totalvärdet över varje applikationsinstans.

För poolnycklar, tokenbeteende, blockeringsperioder, rensning och diagnostik, se SQL Server connection pooling.

Alternativ för anslutningsåterställning

Det första försöket under återhämtningen av anslutningen sker omedelbart. Connect Retry Interval gäller före senare försök. För att kringgå inbyggd initial-öppen omprövning för en operation, använd en öppen överbelastning med OpenWithoutRetry.

Dessa nyckelord försöker inte om ett kommando som misslyckas medan det körs. Använd konfigurerbar återförsökslogik för en anpassad öppnings- eller kommandopolicy. Försök om kommandon endast när det är säkert att upprepa deras effekter.

Serveridentitet och certifikatalternativ

Dessa alternativ uppfyller specifika namngivningskrav för certifikat eller Kerberos. De ersätter inte vanlig autentisering och certifikatvalidering.

Host Name In Certificate ändrar namnet som används för certifikatmatchning. Den litar inte på en opålitlig utgivare. Server Certificate Pinnar en exakt certifikatfil och kräver en applikationsuppdatering när certifikatet roterar.

Felaktiga SPN-överskrivningar kan förhindra Kerberos-autentisering eller försvaga den avsedda identitetskontrollen. Fixa DNS- och SPN-registrering istället för att sätta överskrivningar när det är möjligt.

Håll anslutningssträngarna små. Lägg till ett alternativ endast när du kan ange vilket beteende det ändrar och hur arbetsbelastningen verifierar det beteendet.

Ändringar i granskningsalternativ

Innan du ändrar ett alternativ i produktion:

1. Registrera aktuell reťazec pripojenia, drivrutinsversion, endpoint-typ och observerat problem.
2. Byt ett beteende i taget.
3. Testa anslutningsetablering, autentisering, certifikatvalidering, anslutningspoolning, failover, avbrytning och frågekörning.
4. Mät hårda anslutningar, poolväntetider, anslutningslatens och felnummer.
5. Bekräfta inställningen på varje distribuerad instans.

Anslutningssträngar är en del av poolnyckeln. En stegvis utrullning kan tillfälligt skapa både gamla och nya pooler, vilket ökar det totala antalet fysiska databasanslutningar.

Relaterat innehåll

• Anslutningssträngar
• Koppla till en datakälla
• SQL Server anslutningspoolning
• Kryptering och certifikatvalidering
• Hög tillgänglighet och haveriberedskap
• SqlConnectionStringBuilder