Not
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Gäller för:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalysplattformssystem (PDW)SQL-databas i Microsoft Fabric
Vissa API:er i OLE DB-drivrutinen för SQL Server använder anslutningssträngar för att ange anslutningsattribut. Anslutningssträngar är en lista över nyckelord och associerade värden. varje nyckelord identifierar ett visst anslutningsattribut.
Anmärkning
OLE DB-drivrutin för SQL Server tillåter tvetydighet i anslutningssträngar för att upprätthålla bakåtkompatibilitet (till exempel kan vissa nyckelord anges mer än en gång, och motstridiga nyckelord kan tillåtas med lösning baserat på position eller prioritet). Framtida versioner av OLE DB-drivrutinen för SQL Server kanske inte tillåter tvetydighet i anslutningssträngar. Det är en bra praxis att använda OLE DB-drivrutinen för SQL Server vid modifiering av program för att eliminera beroenden som uppstår på grund av tvetydigheter i anslutningssträngar.
I följande avsnitt beskrivs de nyckelord som kan användas med OLE DB-drivrutinen för SQL Server och ActiveX Data Objects (ADO) när du använder OLE DB-drivrutinen för SQL Server som dataprovider.
Nyckelord för OLE DB-drivrutinsanslutningssträng
Det finns två sätt för OLE DB-program att initiera datakällans objekt:
IDBInitialize::Initialize
IDataInitialize::GetDataSource
I det första fallet kan en providersträng användas för att initiera anslutningsegenskaper genom att ange egenskapen DBPROP_INIT_PROVIDERSTRING i egenskapsuppsättningen DBPROPSET_DBINIT. I det andra fallet kan en initieringssträng skickas till IDataInitialize::GetDataSource-metoden för att initiera anslutningsegenskaper. Båda metoderna initierar samma OLE DB-anslutningsegenskaper, men olika uppsättningar nyckelord används. Den uppsättning nyckelord som används av IDataInitialize::GetDataSource är minst beskrivningen av egenskaper i initieringsegenskapsgruppen.
Alla providersträngsinställningar som har en motsvarande OLE DB-egenskap inställd på något standardvärde eller uttryckligen inställt på ett värde, åsidosätter OLE DB-egenskapsvärdet inställningen i providersträngen.
De booleska egenskaper som anges i providersträngarna via DBPROP_INIT_PROVIDERSTRING-värden anges med hjälp av värdena yes och no. Booleska egenskaper som anges i initieringssträngar med IDataInitialize::GetDataSource anges med hjälp av värdena true och false.
Program som använder IDataInitialize::GetDataSource kan också använda nyckelorden som används av IDBInitialize::Initialize, men endast för egenskaper som inte har något standardvärde. Om ett program använder nyckelordet IDataInitialize::GetDataSource och nyckelordet IDBInitialize::Initialize keyword i initieringssträngen används nyckelordsinställningen IDataInitialize::GetDataSource . Vi rekommenderar att program inte använder IDBInitialize::Initiera nyckelord i IDataInitialize:GetDataSource-anslutningssträngar , eftersom det här beteendet kanske inte underhålls i framtida versioner.
Anmärkning
En anslutningssträng som skickas via IDataInitialize::GetDataSource konverteras till egenskaper och tillämpas via IDBProperties::SetProperties. Om komponenttjänsterna hittade egenskapsbeskrivningen i IDBProperties::GetPropertyInfo tillämpas den här egenskapen som en fristående egenskap. Annars tillämpas den via egenskapen DBPROP_PROVIDERSTRING. Om du till exempel anger anslutningssträngen Datakälla=server1; Server=server2, datakällan anges som en egenskap, men Servern kommer att gå in i en providersträng.
Om du anger flera instanser av samma providerspecifika egenskap används det första värdet för den första egenskapen.
Använda IDBInitialize::Initialize
Anslutningssträngar som används när du använder OLE DB-applikationer med DBPROP_INIT_PROVIDERSTRING och IDBInitialize::Initialize har följande syntax:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
Attributvärden kan omges av klammerparenteser, och det är bra att göra det. Den här metoden undviker problem när attributvärden innehåller icke-alfanumeriska tecken. Den första avslutande klammerparentesen i värdet antas avsluta värdet, så värden kan inte innehålla avslutande klammerparentestecken.
Om det finns ett blankstegstecken efter =-tecknet i ett anslutningssträngsnyckelord tolkas det som en literal, även om värdet omges av citattecken.
I följande tabell beskrivs de nyckelord som kan användas med DBPROP_INIT_PROVIDERSTRING.
| Keyword | Initieringsegenskap | Description |
|---|---|---|
| Addr | SSPROP_INIT_NETWORKADDRESS | Synonym för Adress. |
| Adress | SSPROP_INIT_NETWORKADDRESS | Nätverksadressen för servern som kör en instans av SQL Server.
Adressen är vanligtvis serverns nätverksnamn, men kan vara andra namn, till exempel en pipe, en IP-adress eller en TCP/IP-port och socketadress. Om du anger en IP-adress kontrollerar du att TCP/IP- eller namngivna pipes-protokoll är aktiverade i SQL Server Configuration Manager. Värdet Adress har företräde framför det värde som skickas till Server i anslutningssträngar när OLE DB Driver för SQL Server används. Observera också att Address=; ansluter till servern som anges i nyckelordet Server , medan Address= ;, Address=.;, Address=localhost;och Address=(local); alla orsakar en anslutning till den lokala servern.Den fullständiga syntaxen för nyckelordet Adress är följande: [protokoll:]Adress[,port |\pipe\pipename] protokollet kan vara tcp (TCP/IP), lpc (delat minne) eller np (namngivna pipes). Mer information om protokoll finns i Konfigurera klientprotokoll. Om inget protokoll eller nyckelordet Nätverk har angetts använder OLE DB-drivrutinen för SQL Server den protokollordning som anges i SQL Server Configuration Manager. port är porten som du vill ansluta till på den angivna servern. Som standard använder SQL Server port 1433. |
| APP | SSPROP_INIT_APPNAME | Strängen som identifierar programmet. |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | Deklarerar programarbetsbelastningstypen när du ansluter till en server. Möjliga värden är ReadOnly och ReadWrite.Standardvärdet är ReadWrite. Mer information om OLE DB-drivrutin för SQL Server-stöd för AlwaysOn-tillgänglighetsgrupper finns i OLE DB-drivrutin för SQL Server-stöd för hög tillgänglighet, haveriberedskap. |
| AttachDBFileName | SSPROP_INIT_FILENAME | Namnet på den primära filen (inkludera det fullständiga sökvägsnamnet) för en bifogad databas. Om du vill använda AttachDBFileName måste du också ange databasnamnet med nyckelordet Database i providersträngen. Om databasen tidigare har anslutits kopplar INTE SQL Server den igen (den använder den anslutna databasen som standard för anslutningen). |
| Autentisering1 | SSPROP_AUTH_MODE | Anger den SQL- eller Microsoft Entra-autentisering som används. Giltiga värden är:
NOT: Nyckelordet ActiveDirectoryIntegrated kan också användas för Windows-autentisering till SQL Server. Det ersätter Integrated Security (eller Trusted_Connection) autentiseringsnyckelord. Vi rekommenderar att program som använder Integrated Security (eller Trusted_Connection) nyckelord eller deras motsvarande egenskaper anger värdet för nyckelordet Authentication (eller dess motsvarande egenskap) för att ActiveDirectoryIntegrated aktivera nytt beteende för kryptering och certifikatverifiering.NOT: Vi rekommenderar att program som använder SQL Server autentisering anger värdet för nyckelordet Authentication (eller motsvarande egenskap) för att SqlPassword aktivera nytt beteende för kryptering och certifikatverifiering. |
| Automatisk översättning | SSPROP_INIT_AUTOTRANSLATE | Synonym för AutoTranslate. |
| Autotranslate | SSPROP_INIT_AUTOTRANSLATE | Konfigurerar OEM/ANSI-teckenöversättning. Identifierade värden är yes och no. |
| ConnectRetryCount | SSPROP_INIT_CONNECT_RETRY_COUNT | Styr antalet återanslutningsförsök om anslutningen går förlorad. Giltiga värden sträcker sig från 0 till 255. Standardvärdet är 1. Värdet 0 skulle inte leda till något försök att återansluta. Mer information finns i Återhämtning av inaktiv anslutning. |
| ConnectRetryInterval | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Anger antalet sekunder mellan varje anslutningsförsök om anslutningen går förlorad. Giltiga värden sträcker sig från 1 till 60. Standardvärdet är 10. Mer information finns i Återhämtning av inaktiv anslutning. |
| Databas | DBPROP_INIT_CATALOG | Databasnamnet |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Anger läget för datatypshantering som ska användas. Identifierade värden är 0 för providerdatatyper och 80 för SQL Server 2000-datatyper. |
| Kryptera1 | SSPROP_INIT_ENCRYPT | Anger om data ska krypteras innan de skickas via nätverket. Möjliga värden är Optional, Mandatoryoch Strict. Standardvärdet är Mandatory. För version 18.x.x, se MSOLEDBSQL större versionsskillnader. |
| Failoverpartner | SSPROP_INIT_FAILOVERPARTNER | Namnet på den redundansserver som används för databasspegling. |
| FailoverPartnerSPN | SSPROP_INIT_FAILOVERPARTNERSPN | SPN för failover-partnern. Standardvärdet är en tom sträng. En tom sträng gör att OLE DB-drivrutinen för SQL Server använder standardprovidergenererat SPN. |
| HostNameInCertificate | SSPROP_INIT_HOST_NAME_CERTIFICATE | Värdnamnet som ska användas för att verifiera SQL Server TLS/SSL-certifikatet. Om nyckelordet HostNameInCertificate inte har angetts använder drivrutinen nyckelordsvärdet Server på anslutnings-URL:en som värdnamn för att verifiera SQL Server TLS/SSL-certifikatet. NOTERA: Den här egenskapen ignoreras om servercertifikatet är tillförlitligt. Om Encrypt är inställt på Strictverifieras certifikatet alltid. |
| Språk | SSPROP_INIT_CURRENTLANGUAGE | SQL Server-språket. |
| MarsConn | SSPROP_INIT_MARSCONNECTION | Aktiverar eller inaktiverar flera aktiva resultatuppsättningar (MARS) på anslutningen om servern är SQL Server 2005 (9.x) eller senare. Möjliga värden är yes och no. Standardvärdet är no. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Ange alltid MultiSubnetFailover=Ja när du ansluter till tillgänglighetsgruppens lyssnare för en SQL Server-tillgänglighetsgrupp eller en SQL Server-redundansklusterinstans.
MultiSubnetFailover=Ja konfigurerar OLE DB-drivrutin för SQL Server för snabbare identifiering av och anslutning till den (för närvarande) aktiva servern. Möjliga värden är Yes och No. Standardvärdet är No. Till exempel:MultiSubnetFailover=YesMer information om OLE DB-drivrutin för SQL Server-stöd för AlwaysOn-tillgänglighetsgrupper finns i OLE DB-drivrutin för SQL Server-stöd för hög tillgänglighet, haveriberedskap. |
| Net | SSPROP_INIT_NETWORKLIBRARY | Synonym för Nätverk. |
| Network | SSPROP_INIT_NETWORKLIBRARY | Nätverksbiblioteket som används för att upprätta en anslutning till en instans av SQL Server i organisationen. |
| Nätverksbibliotek | SSPROP_INIT_NETWORKLIBRARY | Synonym för Nätverk. |
| Paketstorlek | SSPROP_INIT_PACKETSIZE | TDS-paketstorlek (Tabular Data Stream). Standardvärdet är 0 (det faktiska värdet bestäms av servern). |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepterar strängarna yes och no som värden. När no används tillåts inte datakällans objekt att bevara känslig autentiseringsinformation |
| PWD | DBPROP_AUTH_PASSWORD | Sql Server-inloggningslösenordet. |
| Server | DBPROP_INIT_DATASOURCE | Namnet på en SQL Server-instans. Värdet måste vara antingen namnet på en server i nätverket, en IP-adress eller namnet på ett SQL Server Configuration Manager-alias. När det inte anges upprättas en anslutning till standardinstansen på den lokala datorn. Nyckelordet Adress åsidosätter nyckelordet Server. Du kan ansluta till standardinstansen på den lokala servern genom att ange något av följande alternativ: Server=; Server=.; Server=(local); Server=(local); Server=(localhost); Server=(localdb)\instancename; Mer information om LocalDB-stöd finns i OLE DB-drivrutin för SQL Server-stöd för LocalDB. Om du vill ange en namngiven instans av SQL Server lägger du till \InstanceName. När ingen server har angetts upprättas en anslutning till standardinstansen på den lokala datorn. Om du anger en IP-adress kontrollerar du att TCP/IP- eller namngivna pipes-protokoll är aktiverade i SQL Server Configuration Manager. Den fullständiga syntaxen för nyckelordet Server är följande: Server=[protocol:]Server[,port] protokollet kan vara tcp (TCP/IP), lpc (delat minne) eller np (namngivna pipes). I följande exempel anges ett namngivet rör: np:\\.\pipe\MSSQL$MYINST01\sql\queryOvanstående rad anger det namngivna pipe-protokollet ( np), ett namngivet rör på den lokala datorn (\\.\pipe), namnet på SQL Server-instansen (MSSQL$MYINST01) och standardnamnet för det namngivna röret (sql/query).Om inget protokolleller nätverksnyckelord har angetts använder OLE DB-drivrutinen för SQL Server den protokollordning som anges i SQL Server Configuration Manager. port är porten som du vill ansluta till på den angivna servern. Som standard använder SQL Server port 1433. Blanksteg ignoreras i början av värdet som skickas till Server i anslutningssträngar när du använder OLE DB-drivrutin för SQL Server. |
| ServerCertificate | SSPROP_INIT_SERVER_CERTIFICATE | Anger sökvägen till en certifikatfil som ska matchas mot SQL Server TLS/SSL-certifikatet. Det här alternativet kan bara användas när Strict kryptering är aktiverat. De godkända certifikatformaten är PEM, DER och CER. Om det anges kontrolleras SQL Server-certifikatet genom att se om det angivna certifikatet är en exakt matchning. |
| ServerSPN | SSPROP_INIT_SERVERSPN | SPN för servern. Standardvärdet är en tom sträng. En tom sträng gör att OLE DB-drivrutinen för SQL Server använder standardprovidergenererat SPN. |
| Tidsgräns | DBPROP_INIT_TIMEOUT | Hur lång tid (i sekunder) det går att vänta tills datakällans initiering har slutförts. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Påverkar anslutningssekvensen när den första lösta IP-adressen för värdnamnet inte svarar och det finns flera IP-adresser som är associerade med värdnamnet. TNIR interagerar med MultiSubnetFailover för att tillhandahålla olika anslutningssekvenser. Möjliga värden är Yes och No. Standardvärdet är Yes. Mer information finns i Använda transparent nätverks-IP-upplösning. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | När yesinstruerar det här alternativet OLE DB-drivrutinen för SQL Server att använda Windows-autentisering för inloggningsverifiering. Annars använder OLE DB-drivrutinen för SQL Server ett ANVÄNDARNAMN och lösenord för SQL Server för inloggningsverifiering, och nyckelorden UID och PWD måste anges. |
| TrustServerCertificate1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Accepterar strängarna yes och no som värden. Standardvärdet är no, vilket innebär att servercertifikatet verifieras. |
| UID | DBPROP_AUTH_USERID | SQL Server-inloggningsnamnet. |
| UseFMTONLY | SSPROP_INIT_USEFMTONLY | Styr hur metadata hämtas när du ansluter till SQL Server 2012 (11.x) och senare. Möjliga värden är yes och no. Standardvärdet är no.Som standard använder OLE DB-drivrutinen för SQL Server sp_describe_first_result_set och sp_describe_undeclared_parameters lagrade procedurer för att hämta metadata. Dessa lagrade procedurer har vissa begränsningar (till exempel kommer de att misslyckas när de används i tillfälliga tabeller). Ange UseFMTONLY för att yes instruera drivrutinen att använda SET FMTONLY för metadatahämtning i stället. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Det här nyckelordet är inaktuellt och dess inställning ignoreras av OLE DB-drivrutinen för SQL Server. |
| WSID | SSPROP_INIT_WSID | Arbetsstationsidentifieraren. |
[1]: För att förbättra säkerheten ändras beteendet för kryptering och certifikatverifiering när du använder initieringsegenskaper för autentisering eller åtkomsttoken eller motsvarande nyckelord för anslutningssträngar. Mer information finns i Kryptering och certifikatverifiering.
Använda IDataInitialize::GetDataSource
Anslutningssträngar som används av OLE DB-program med IDataInitialize::GetDataSource har följande syntax:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
Egenskapsanvändning måste överensstämma med den syntax som tillåts inom dess område. Till exempel använder WSID klammerparenteser ({}) citattecken och Programnamn använder enkla (') eller dubbla (") citattecken. Endast strängegenskaper kan citeras. Om du försöker citera ett heltal eller en uppräknad egenskap resulterar det i ett Connection String doesn't conform to OLE DB specification fel.
Attributvärden kan omges av enkla eller dubbla citattecken, och det är bra att göra det. Den här metoden undviker problem när värden innehåller icke-alfanumeriska tecken. Det angivna tecknet kan också visas i värden om det är omsatt i dubbla citattecken.
Ett blankstegstecken efter nyckelordet = för en anslutningssträng tolkas som en literal, även om värdet omges av citattecken.
Om en anslutningssträng har fler än en av de egenskaper som anges i följande tabell används värdet för den senaste egenskapen.
I följande tabell beskrivs de nyckelord som kan användas med IDataInitialize::GetDataSource:
| Keyword | Initieringsegenskap | Description |
|---|---|---|
| Åtkomsttoken1 | SSPROP_AUTH_ACCESS_TOKEN | Åtkomsttoken som används för att autentisera till Microsoft Entra-ID. NOT: Det är ett fel att ange nyckelordet och även UID, PWD, Trusted_Connectioneller Authentication anslutningssträngsnyckelord eller motsvarande egenskaper/nyckelord. |
| Programnamn | SSPROP_INIT_APPNAME | Strängen som identifierar programmet. |
| Program avsikt | SSPROP_INIT_APPLICATIONINTENT | Deklarerar programarbetsbelastningstypen när du ansluter till en server. Möjliga värden är ReadOnly och ReadWrite.Standardvärdet är ReadWrite. Mer information om OLE DB-drivrutin för SQL Server-stöd för AlwaysOn-tillgänglighetsgrupper finns i OLE DB-drivrutin för SQL Server-stöd för hög tillgänglighet, haveriberedskap. |
| Autentisering1 | SSPROP_AUTH_MODE | Anger den SQL- eller Microsoft Entra-autentisering som används. Giltiga värden är:
NOT: Nyckelordet ActiveDirectoryIntegrated kan också användas för Windows-autentisering till SQL Server. Det ersätter Integrated Security (eller Trusted_Connection) autentiseringsnyckelord. Vi rekommenderar att program som använder Integrated Security (eller Trusted_Connection) nyckelord eller deras motsvarande egenskaper anger värdet för nyckelordet Authentication (eller dess motsvarande egenskap) för att ActiveDirectoryIntegrated aktivera nytt beteende för kryptering och certifikatverifiering.NOT: Vi rekommenderar att program som använder SQL Server autentisering anger värdet för nyckelordet Authentication (eller motsvarande egenskap) för att SqlPassword aktivera nytt beteende för kryptering och certifikatverifiering. |
| Automatisk översättning | SSPROP_INIT_AUTOTRANSLATE | Konfigurerar OEM/ANSI-teckenöversättning. Identifierade värden är true och false. |
| Tidsgräns för anslutning | DBPROP_INIT_TIMEOUT | Hur lång tid (i sekunder) det går att vänta tills datakällans initiering har slutförts. |
| Antal anslutningsåterförsök | SSPROP_INIT_CONNECT_RETRY_COUNT | Styr antalet återanslutningsförsök om anslutningen går förlorad. Giltiga värden sträcker sig från 0 till 255. Standardvärdet är 1. Värdet 0 skulle inte leda till något försök att återansluta. Mer information finns i Återhämtning av inaktiv anslutning. |
| Anslut återförsöksintervall | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Anger antalet sekunder mellan varje anslutningsförsök om anslutningen går förlorad. Giltiga värden sträcker sig från 1 till 60. Standardvärdet är 10. Mer information finns i Återhämtning av inaktiv anslutning. |
| Aktuellt språk | SSPROPT_INIT_CURRENTLANGUAGE | Sql Server-språknamnet. |
| Datakälla | DBPROP_INIT_DATASOURCE | Namnet på en instans av SQL Server i organisationen. När det inte anges upprättas en anslutning till standardinstansen på den lokala datorn. Mer information om giltig adresssyntax finns i beskrivningen av nyckelordet Server i den här artikeln. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Anger läget för datatypshantering som ska användas. Identifierade värden är 0 för providerdatatyper och 80 för SQL Server 2000-datatyper (8.x). |
| Failover-partner | SSPROP_INIT_FAILOVERPARTNER | Namnet på den redundansserver som används för databasspegling. |
| Failover Partner SPN | SSPROP_INIT_FAILOVERPARTNERSPN | SPN för failover-partnern. Standardvärdet är en tom sträng. En tom sträng gör att OLE DB-drivrutinen för SQL Server använder standardprovidergenererat SPN. |
| Värdnamn i certifikat | SSPROP_INIT_HOST_NAME_CERTIFICATE | Värdnamnet som ska användas för att verifiera SQL Server TLS/SSL-certifikatet. Om nyckelordet Värdnamn i certifikatet inte har angetts använder drivrutinen nyckelordsvärdet Datakälla på anslutnings-URL:en som värdnamn för att verifiera SQL Server TLS/SSL-certifikatet. NOTERA: Den här egenskapen ignoreras om servercertifikatet är tillförlitligt. Om Använd kryptering för data är inställt på Strictverifieras certifikatet alltid. |
| Ursprunglig katalog | DBPROP_INIT_CATALOG | Databasnamnet |
| Ursprungligt filnamn | SSPROP_INIT_FILENAME | Namnet på den primära filen (inkludera det fullständiga sökvägsnamnet) för en bifogad databas. Om du vill använda AttachDBFileName måste du också ange databasnamnet med nyckelordet providersträngen DATABASE. Om databasen tidigare har anslutits kopplar INTE SQL Server den igen (den använder den anslutna databasen som standard för anslutningen). |
| Integrerad säkerhet | DBPROP_AUTH_INTEGRATED | Accepterar värdet SSPI för Windows-autentisering. |
| MARS-anslutning | SSPROP_INIT_MARSCONNECTION | Aktiverar eller inaktiverar flera aktiva resultatuppsättningar (MARS) på anslutningen. Identifierade värden är true och false. Standardvärdet är false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Ange alltid MultiSubnetFailover=True när du ansluter till tillgänglighetsgruppens lyssnare för en SQL Server-tillgänglighetsgrupp eller en SQL Server-redundansklusterinstans.
MultiSubnetFailover=True konfigurerar OLE DB-drivrutin för SQL Server för snabbare identifiering av och anslutning till den (för närvarande) aktiva servern. Möjliga värden är True och False. Standardvärdet är False. Till exempel:MultiSubnetFailover=TrueMer information om OLE DB-drivrutin för SQL Server-stöd för AlwaysOn-tillgänglighetsgrupper finns i OLE DB-drivrutin för SQL Server-stöd för hög tillgänglighet, haveriberedskap. |
| Nätverksadress | SSPROP_INIT_NETWORKADDRESS | Nätverksadressen för en instans av SQL Server i organisationen. Mer information om giltig adresssyntax finns i beskrivningen av nyckelordet Adress i den här artikeln. |
| Nätverksbibliotek | SSPROP_INIT_NETWORKLIBRARY | Nätverksbiblioteket som används för att upprätta en anslutning till en instans av SQL Server i organisationen. |
| Paketstorlek | SSPROP_INIT_PACKETSIZE | TDS-paketstorlek (Tabular Data Stream). Standardvärdet är 0 (det faktiska värdet bestäms av servern). |
| Lösenord | DBPROP_AUTH_PASSWORD | Sql Server-inloggningslösenordet. |
| Spara säkerhetsinformation | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepterar strängarna true och false som värden. När falsetillåts inte datakällans objekt att bevara känslig autentiseringsinformation |
| Leverantör | För OLE DB-drivrutin för SQL Server ska det här värdet vara "MSOLEDBSQL19" eller "MSOLEDBSQL". | |
| Servercertifikat | SSPROP_INIT_SERVER_CERTIFICATE | Anger sökvägen till en certifikatfil som ska matchas mot SQL Server TLS/SSL-certifikatet. Det här alternativet kan bara användas när Strict kryptering är aktiverat. De godkända certifikatformaten är PEM, DER och CER. Om det anges kontrolleras SQL Server-certifikatet genom att se om det angivna certifikatet är en exakt matchning. |
| Server-SPN | SSPROP_INIT_SERVERSPN | SPN för servern. Standardvärdet är en tom sträng. En tom sträng gör att OLE DB-drivrutinen för SQL Server använder standardprovidergenererat SPN. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Påverkar anslutningssekvensen när den första lösta IP-adressen för värdnamnet inte svarar och det finns flera IP-adresser som är associerade med värdnamnet. TNIR interagerar med MultiSubnetFailover för att tillhandahålla olika anslutningssekvenser. Möjliga värden är True och False. Standardvärdet är True. Mer information finns i Använda transparent nätverks-IP-upplösning. |
| Förtroendeservercertifikat1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Accepterar strängarna true och false som värden. Standardvärdet är false, vilket innebär att servercertifikatet verifieras. |
| Använda kryptering för data1 | SSPROP_INIT_ENCRYPT | Anger om data ska krypteras innan de skickas via nätverket. Möjliga värden är Optional, Mandatoryoch Strict. Standardvärdet är Mandatory. För version 18.x.x, se MSOLEDBSQL större versionsskillnader. |
| Använda FMTONLY | SSPROP_INIT_USEFMTONLY | Styr hur metadata hämtas när du ansluter till SQL Server 2012 (11.x) och senare. Möjliga värden är true och false. Standardvärdet är false.Som standard använder OLE DB-drivrutinen för SQL Server sp_describe_first_result_set och sp_describe_undeclared_parameters lagrade procedurer för att hämta metadata. Dessa lagrade procedurer har vissa begränsningar (till exempel kommer de att misslyckas när de används i tillfälliga tabeller). Inställningen Använd FMTONLY instruerar drivrutinen att i stället använda SET FMTONLY för metadatahämtning. |
| Användar-ID | DBPROP_AUTH_USERID | SQL Server-inloggningsnamnet. |
| Arbetsstations-ID | SSPROP_INIT_WSID | Arbetsstationsidentifieraren. |
[1]: För att förbättra säkerheten ändras krypterings- och certifikatverifieringsbeteendet när initieringsegenskaperna för autentiserings-/åtkomsttoken används eller deras motsvarande nyckelord för anslutningssträngar. Mer information finns i Kryptering och certifikatverifiering.
Anmärkning
I anslutningssträngen Old Password anger egenskapen SSPROP_AUTH_OLD_PASSWORD, vilket är det aktuella (eventuellt utgångna) lösenordet som inte är tillgängligt via en providersträngegenskap.
Nyckelord för Anslutningssträng för ActiveX-dataobjekt (ADO)
ADO-program anger egenskapen ConnectionString för ADODBConnection-objekt eller anger en anslutningssträng som en parameter till open-metoden för ADODBConnection-objekt .
ADO-program kan också använda nyckelorden som används av OLE DB IDBInitialize::Initialize-metoden , men endast för egenskaper som inte har något standardvärde. Om ett program använder både ADO-nyckelorden och IDBInitialize::Initiera nyckelord i initieringssträngen används nyckelordsinställningen ADO. Vi rekommenderar att program endast använder ADO-anslutningssträngsnyckelord.
Anslutningssträngar som används av ADO har följande syntax:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
Attributvärden kan omges av dubbla citattecken, och det är bra att göra det. Den här metoden undviker problem när värden innehåller icke-alfanumeriska tecken. Attributvärden får inte innehålla dubbla citattecken.
I följande tabell beskrivs nyckelorden som kan användas med en ADO-anslutningssträng:
| Keyword | Initieringsegenskap | Description |
|---|---|---|
| Åtkomsttoken1 | SSPROP_AUTH_ACCESS_TOKEN | Åtkomsttoken som används för att autentisera till Microsoft Entra-ID. NOT: Det är ett fel att ange nyckelordet och även UID, PWD, Trusted_Connectioneller Authentication anslutningssträngsnyckelord eller motsvarande egenskaper/nyckelord. |
| Program avsikt | SSPROP_INIT_APPLICATIONINTENT | Deklarerar programarbetsbelastningstypen när du ansluter till en server. Möjliga värden är ReadOnly och ReadWrite.Standardvärdet är ReadWrite. Mer information om OLE DB-drivrutin för SQL Server-stöd för AlwaysOn-tillgänglighetsgrupper finns i OLE DB-drivrutin för SQL Server-stöd för hög tillgänglighet, haveriberedskap. |
| Programnamn | SSPROP_INIT_APPNAME | Strängen som identifierar programmet. |
| Autentisering1 | SSPROP_AUTH_MODE | Anger den SQL- eller Microsoft Entra-autentisering som används. Giltiga värden är:
NOT: Nyckelordet ActiveDirectoryIntegrated kan också användas för Windows-autentisering till SQL Server. Det ersätter Integrated Security (eller Trusted_Connection) autentiseringsnyckelord. Vi rekommenderar att program som använder Integrated Security (eller Trusted_Connection) nyckelord eller deras motsvarande egenskaper anger värdet för nyckelordet Authentication (eller dess motsvarande egenskap) för att ActiveDirectoryIntegrated aktivera nytt beteende för kryptering och certifikatverifiering.NOT: Vi rekommenderar att program som använder SQL Server autentisering anger värdet för nyckelordet Authentication (eller motsvarande egenskap) för att SqlPassword aktivera nytt beteende för kryptering och certifikatverifiering. |
| Automatisk översättning | SSPROP_INIT_AUTOTRANSLATE | Konfigurerar OEM/ANSI-teckenöversättning. Identifierade värden är true och false. |
| Tidsgräns för anslutning | DBPROP_INIT_TIMEOUT | Hur lång tid (i sekunder) det går att vänta tills datakällans initiering har slutförts. |
| Återkopplingsförsök antal | SSPROP_INIT_CONNECT_RETRY_COUNT | Styr antalet återanslutningsförsök om anslutningen går förlorad. Giltiga värden sträcker sig från 0 till 255. Standardvärdet är 1. Värdet 0 skulle inte leda till något försök att återansluta. Mer information finns i Återhämtning av inaktiv anslutning. |
| Anslut återförsöksintervall | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Anger antalet sekunder mellan varje anslutningsförsök om anslutningen går förlorad. Giltiga värden sträcker sig från 1 till 60. Standardvärdet är 10. Mer information finns i Återhämtning av inaktiv anslutning. |
| Aktuellt språk | SSPROPT_INIT_CURRENTLANGUAGE | Sql Server-språknamnet. |
| Datakälla | DBPROP_INIT_DATASOURCE | Namnet på en instans av SQL Server i organisationen. När det inte anges upprättas en anslutning till standardinstansen på den lokala datorn. Mer information om giltig adresssyntax finns i beskrivningen av nyckelordet Server i den här artikeln. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Anger läget för datatypshantering som ska användas. Identifierade värden är 0 för providerdatatyper och 80 för SQL Server 2000-datatyper. |
| Failover-partner | SSPROP_INIT_FAILOVERPARTNER | Namnet på den redundansserver som används för databasspegling. |
| Failover Partner SPN | SSPROP_INIT_FAILOVERPARTNERSPN | SPN för failover-partnern. Standardvärdet är en tom sträng. En tom sträng gör att OLE DB-drivrutinen för SQL Server använder standardprovidergenererat SPN. |
| Värdnamn i certifikat | SSPROP_INIT_HOST_NAME_CERTIFICATE | Värdnamnet som ska användas för att verifiera SQL Server TLS/SSL-certifikatet. Om nyckelordet Värdnamn i certifikatet inte har angetts använder drivrutinen nyckelordsvärdet Datakälla på anslutnings-URL:en som värdnamn för att verifiera SQL Server TLS/SSL-certifikatet. NOTERA: Den här egenskapen ignoreras om servercertifikatet är tillförlitligt. Om Använd kryptering för data är inställt på Strictverifieras certifikatet alltid. |
| Ursprunglig katalog | DBPROP_INIT_CATALOG | Databasnamnet |
| Ursprungligt filnamn | SSPROP_INIT_FILENAME | Namnet på den primära filen (inkludera det fullständiga sökvägsnamnet) för en bifogad databas. Om du vill använda AttachDBFileName måste du också ange databasnamnet med nyckelordet providersträngen DATABASE . Om databasen tidigare har anslutits kopplar INTE SQL Server den igen (den använder den anslutna databasen som standard för anslutningen). |
| Integrerad säkerhet | DBPROP_AUTH_INTEGRATED | Accepterar värdet SSPI för Windows-autentisering. |
| MARS-anslutning | SSPROP_INIT_MARSCONNECTION | Aktiverar eller inaktiverar flera aktiva resultatuppsättningar (MARS) på anslutningen om servern är SQL Server 2005 (9.x) eller senare. Identifierade värden är true och false. Standardvärdet är false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Ange alltid MultiSubnetFailover=True när du ansluter till tillgänglighetsgruppens lyssnare för en SQL Server-tillgänglighetsgrupp eller en SQL Server-redundansklusterinstans.
MultiSubnetFailover=True konfigurerar OLE DB-drivrutin för SQL Server för snabbare identifiering av och anslutning till den (för närvarande) aktiva servern. Möjliga värden är True och False. Standardvärdet är False. Till exempel:MultiSubnetFailover=TrueMer information om OLE DB-drivrutin för SQL Server-stöd för AlwaysOn-tillgänglighetsgrupper finns i OLE DB-drivrutin för SQL Server-stöd för hög tillgänglighet, haveriberedskap. |
| Nätverksadress | SSPROP_INIT_NETWORKADDRESS | Nätverksadressen för en instans av SQL Server i organisationen. Mer information om giltig adresssyntax finns i beskrivningen av nyckelordet Adress i den här artikeln. |
| Nätverksbibliotek | SSPROP_INIT_NETWORKLIBRARY | Nätverksbiblioteket som används för att upprätta en anslutning till en instans av SQL Server i organisationen. |
| Paketstorlek | SSPROP_INIT_PACKETSIZE | TDS-paketstorlek (Tabular Data Stream). Standardvärdet är 0 (det faktiska värdet bestäms av servern). |
| Lösenord | DBPROP_AUTH_PASSWORD | Sql Server-inloggningslösenordet. |
| Spara säkerhetsinformation | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepterar strängarna true och false som värden. När falsetillåts inte datakällans objekt att bevara känslig autentiseringsinformation. |
| Leverantör | För OLE DB-drivrutinen för SQL Server är värdet MSOLEDBSQL19 eller MSOLEDBSQL. |
|
| Servercertifikat | SSPROP_INIT_SERVER_CERTIFICATE | Anger sökvägen till en certifikatfil som ska matchas mot SQL Server TLS/SSL-certifikatet. Det här alternativet kan bara användas när Strict kryptering är aktiverat. De godkända certifikatformaten är PEM, DER och CER. Om det anges kontrolleras SQL Server-certifikatet genom att se om det angivna certifikatet är en exakt matchning. |
| Server-SPN | SSPROP_INIT_SERVERSPN | SPN för servern. Standardvärdet är en tom sträng. En tom sträng gör att OLE DB-drivrutinen för SQL Server använder standardprovidergenererat SPN. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Påverkar anslutningssekvensen när den första lösta IP-adressen för värdnamnet inte svarar och det finns flera IP-adresser som är associerade med värdnamnet. TNIR interagerar med MultiSubnetFailover för att tillhandahålla olika anslutningssekvenser. Möjliga värden är True och False. Standardvärdet är True. Mer information finns i Använda transparent nätverks-IP-upplösning. |
| Förtroendeservercertifikat1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Accepterar strängarna true och false som värden. Standardvärdet är false, vilket innebär att servercertifikatet verifieras. |
| Använda kryptering för data1 | SSPROP_INIT_ENCRYPT | Anger om data ska krypteras innan de skickas via nätverket. Möjliga värden är Optional, Mandatoryoch Strict. Standardvärdet är Mandatory. För version 18.x.x, se MSOLEDBSQL större versionsskillnader. |
| Använda FMTONLY | SSPROP_INIT_USEFMTONLY | Styr hur metadata hämtas när du ansluter till SQL Server 2012 (11.x) och senare. Möjliga värden är true och false. Standardvärdet är false.Som standard använder OLE DB-drivrutinen för SQL Server sp_describe_first_result_set och sp_describe_undeclared_parameters lagrade procedurer för att hämta metadata. Dessa lagrade procedurer har vissa begränsningar (till exempel kommer de att misslyckas när de används i tillfälliga tabeller). Inställningen Använd FMTONLY instruerar drivrutinen att i stället använda SET FMTONLY för metadatahämtning. |
| Användar-ID | DBPROP_AUTH_USERID | SQL Server-inloggningsnamnet. |
| Arbetsstations-ID | SSPROP_INIT_WSID | Arbetsstationsidentifieraren. |
[1]: För att förbättra säkerheten ändras krypterings- och certifikatverifieringsbeteendet när initieringsegenskaperna för autentiserings-/åtkomsttoken används eller deras motsvarande nyckelord för anslutningssträngar. Mer information finns i Kryptering och certifikatverifiering.
Anmärkning
I anslutningssträngen anger egenskapen "Gammalt lösenord" SSPROP_AUTH_OLD_PASSWORD, vilket är det aktuella (eventuellt utgångna) lösenordet som inte är tillgängligt via en providersträngegenskap.