Dela via

Använda nyckelord för anslutningssträngar med OLE DB-drivrutin för SQL Server

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalysplattformssystem (PDW)SQL-databas i Microsoft Fabric

Ladda ned OLE DB-drivrutins

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-drivrutinen 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.

Booleska värden i providersträngar via DBPROP_INIT_PROVIDERSTRING anges med värdena yes och no. Booleska egenskaper som anges i initieringssträngar som använder 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 bara för egenskaper som inte har något standardvärde. Om ett program använder både nyckelordet IDataInitialize::GetDataSource och nyckelordet IDBInitialize::Initialize i initieringssträngen används nyckelordsinställningen IDataInitialize::GetDataSource . Vi rekommenderar att program inte använder IDBInitialize::Initialize nyckelord i IDataInitialize:GetDataSource anslutningssträngar, eftersom det här beteendet kanske inte upprätthålls i framtida versioner.

Anmärkning

En anslutningssträng som skickas genom IDataInitialize::GetDataSource konverteras till egenskaper och tillämpas via IDBProperties::SetProperties. Om komponenttjänsterna hittade egenskapsbeskrivningen i IDBProperties::GetPropertyInfotillämpas den här egenskapen som en fristående egenskap. Annars tillämpas den via DBPROP_PROVIDERSTRING egenskapen . Om du till exempel anger anslutningssträngen Data Source=server1;Server=server2, kommer Data Source att anges som en egenskap, men Server 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 av OLE DB-program med DBPROP_INIT_PROVIDERSTRING och IDBInitialize::Initialize har följande syntax:

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
  • empty-string ::=
  • attribute ::= attribute-keyword=[{]attribute-value[}]
  • attribute-value ::= character-string
  • attribute-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 Address.
Address SSPROP_INIT_NETWORKADDRESS Nätverksadressen för servern som kör en instans av SQL Server. Address är vanligtvis serverns nätverksnamn, men kan vara andra namn som ett rör, 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 av Address har företräde framför det värde som skickas till Server i anslutningssträngar när du använder OLE DB-drivrutinen för SQL Server. Address=; ansluter till den server 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 Address är följande:

[protokoll:]Adress[,port|\pipe\pipename]

protokoll kan vara tcp (TCP/IP), lpc (delat minne) eller np (namngivna pipes). Mer information om protokoll finns i Konfigurera klientprotokoll.

Om inget protokoll eller Network nyckelord 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 Databas 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).
Authentication 1 SSPROP_AUTH_MODE Anger den SQL- eller Microsoft Entra-autentisering som används. Giltiga värden är:
  • (not set): Autentiseringsläge som bestäms av andra nyckelord.
  • ActiveDirectoryPassword: Användar-ID och lösenordsautentisering med en Microsoft Entra-identitet.
  • ActiveDirectoryIntegrated: Integrerad autentisering med Microsoft Entra-ID.

    • Obs! Nyckelordet ActiveDirectoryIntegrated kan också användas för Windows-autentisering till SQL Server. Det ersätter Integrated Security (eller Trusted_Connection) autentiseringsnyckelord. Program som använder Integrated Security (eller Trusted_Connection) nyckelord eller deras motsvarande egenskaper bör ange värdet för nyckelordet Authentication (eller dess motsvarande egenskap) för att ActiveDirectoryIntegrated aktivera nytt beteende för kryptering och certifikatverifiering.

  • ActiveDirectoryInteractive: Interaktiv autentisering med en Microsoft Entra-identitet. Den här metoden stöder Microsoft Entra multifaktorautentisering.
  • ActiveDirectoryMSI: Hanterad identitetsautentisering . För en användartilldelad identitet ska användar-ID anges till objekt-ID för användaridentiteten.
  • ActiveDirectoryServicePrincipal: Autentisering med ett tjänsthuvudnamn för Microsoft Entra. Användar-ID:t ska vara inställt på programmets (klient)-ID. Lösenordet ska anges till programhemligheten (klienten).
  • SqlPassword: Autentisering med användar-ID och lösenord.

    • Obs! Program som använder SQL Server-autentisering bör ange värdet för nyckelordet Authentication (eller motsvarande egenskap) för att SqlPassword aktivera nytt beteende för kryptering och certifikatverifiering.
Auto Translate 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. Ett värde för 0 skulle inte resultera i något försök att återansluta. Mer information finns i Återhämtning av inaktiv anslutning i OLE DB-drivrutinen.
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 i OLE DB-drivrutinen.
Database 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 (8.x).
Encrypt 1 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.
Obs! Den här egenskapen ignoreras om servercertifikatet är godkänt. Om Encrypt är inställt på Strictverifieras alltid certifikatet.
Language 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=Yes när du ansluter till tillgänglighetsgruppens lyssnare för en SQL Server-tillgänglighetsgrupp eller en SQL Server-redundansklusterinstans. MultiSubnetFailover=Yes 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=Yes

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.
Net SSPROP_INIT_NETWORKLIBRARY Synonym för Network.
Network SSPROP_INIT_NETWORKLIBRARY Nätverksbiblioteket som används för att upprätta en anslutning till en instans av SQL Server i organisationen.
Network Library SSPROP_INIT_NETWORKLIBRARY Synonym för Network.
PacketSize 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 Address å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:

[protokoll:]Server[,port]

protokoll 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\query

Ovanstå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 protokoll eller Network nyckelord 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 det värde 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.
Timeout 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.
TrustServerCertificate 1 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). Att ställa UseFMTONLY till yes instruerar drivrutinen att använda SET FMTONLY för att hämta metadata 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 certifikatvalidering när initieringsegenskaper för autentisering eller åtkomsttoken används, eller deras 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 hjälp av IDataInitialize::GetDataSource har följande syntax:

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
  • empty-string ::=
  • attribute ::= attribute-keyword=[quote]attribute-value[quote]
  • attribute-value ::= character-string
  • attribute-keyword ::= identifier
  • quote ::= " | '

Egenskapsanvändning måste överensstämma med den syntax som tillåts inom dess område. Till exempel WSID använder klammerparenteser ({}) citattecken och Application Name 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
Access Token 1 SSPROP_AUTH_ACCESS_TOKEN Åtkomsttoken som används för att autentisera till Microsoft Entra-ID.

Obs! Det är ett fel att ange nyckelordet och även UID, PWD, Trusted_Connectioneller Authentication anslutningssträngsnyckelord eller motsvarande egenskaper/nyckelord.
Application Name SSPROP_INIT_APPNAME Strängen som identifierar programmet.
Application Intent 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.
Authentication 1 SSPROP_AUTH_MODE Anger den SQL- eller Microsoft Entra-autentisering som används. Giltiga värden är:
  • (not set): Autentiseringsläge som bestäms av andra nyckelord.
  • ActiveDirectoryPassword: Användar-ID och lösenordsautentisering med en Microsoft Entra-identitet.
  • ActiveDirectoryIntegrated: Integrerad autentisering med Microsoft Entra-ID.

    • Obs! Nyckelordet ActiveDirectoryIntegrated kan också användas för Windows-autentisering till SQL Server. Det ersätter Integrated Security (eller Trusted_Connection) autentiseringsnyckelord. Program som använder Integrated Security (eller Trusted_Connection) nyckelord eller deras motsvarande egenskaper bör ange värdet för nyckelordet Authentication (eller dess motsvarande egenskap) för att ActiveDirectoryIntegrated aktivera nytt beteende för kryptering och certifikatverifiering.

  • ActiveDirectoryInteractive: Interaktiv autentisering med en Microsoft Entra-identitet. Den här metoden stöder Microsoft Entra multifaktorautentisering.
  • ActiveDirectoryMSI: Hanterad identitetsautentisering . För en användartilldelad identitet ska användar-ID anges till objekt-ID för användaridentiteten.
  • ActiveDirectoryServicePrincipal: Autentisering med ett tjänsthuvudnamn för Microsoft Entra. Användar-ID:t ska vara inställt på programmets (klient)-ID. Lösenordet ska anges till programhemligheten (klienten).
  • SqlPassword: Autentisering med användar-ID och lösenord.

    • Obs! Program som använder SQL Server-autentisering bör ange värdet för nyckelordet Authentication (eller motsvarande egenskap) för att SqlPassword aktivera nytt beteende för kryptering och certifikatverifiering.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Konfigurerar OEM/ANSI-teckenöversättning. Identifierade värden är true och false.
Connect Timeout DBPROP_INIT_TIMEOUT Hur lång tid (i sekunder) det går att vänta tills datakällans initiering har slutförts.
Connect Retry Count 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. Ett värde för 0 skulle inte resultera i något försök att återansluta. Mer information finns i Återhämtning av inaktiv anslutning i OLE DB-drivrutinen.
Connect Retry Interval 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 i OLE DB-drivrutinen.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Sql Server-språknamnet.
Data Source 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 Server-nyckelordet 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.
Host Name In Certificate SSPROP_INIT_HOST_NAME_CERTIFICATE Värdnamnet som ska användas för att verifiera SQL Server TLS/SSL-certifikatet. Om nyckelordet Host Name In Certificate inte har angetts använder drivrutinen nyckelordsvärdet Data Source på anslutnings-URL:en som värdnamn för att verifiera SQL Server TLS/SSL-certifikatet.
Obs! Den här egenskapen ignoreras om servercertifikatet är godkänt. Om Use Encryption for Data är inställt på Strictverifieras alltid certifikatet.
Initial Catalog DBPROP_INIT_CATALOG Databasnamnet
Initial File Name 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 AttachDBFileNamemåste du också ange databasnamnet med nyckelordet providersträng DATABASE . Om databasen tidigare har anslutits kopplar INTE SQL Server den igen (den använder den anslutna databasen som standard för anslutningen).
Integrated Security DBPROP_AUTH_INTEGRATED Accepterar värdet SSPI för Windows-autentisering.
MARS Connection 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=True

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.
Network Address SSPROP_INIT_NETWORKADDRESS Nätverksadressen för en instans av SQL Server i organisationen.

För mer information om giltig adresssyntax, se beskrivningen av nyckelordet Address i den här artikeln.
Network Library SSPROP_INIT_NETWORKLIBRARY Nätverksbiblioteket som används för att upprätta en anslutning till en instans av SQL Server i organisationen.
Packet Size SSPROP_INIT_PACKETSIZE TDS-paketstorlek (Tabular Data Stream). Standardvärdet är 0 (det faktiska värdet bestäms av servern).
Password DBPROP_AUTH_PASSWORD Sql Server-inloggningslösenordet.
Persist Security Info 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
Provider För OLE DB-drivrutinen för SQL Server är värdet MSOLEDBSQL19 eller MSOLEDBSQL.
Server Certificate 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.
Trust Server Certificate 1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Accepterar strängarna true och false som värden. Standardvärdet är false, vilket innebär att servercertifikatet verifieras.
Use Encryption for Data 1 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.
Use 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). Att ställa Use FMTONLY till true instruerar drivrutinen att använda SET FMTONLY för att hämta metadata i stället.
User ID DBPROP_AUTH_USERID SQL Server-inloggningsnamnet.
Workstation ID SSPROP_INIT_WSID Arbetsstationsidentifieraren.

1 För att förbättra säkerhetsbeteendet, krypteringsbeteendet och certifikatverifieringsbeteendet, ändras detta vid användning av initieringsegenskaper för autentisering/åtkomsttoken eller deras motsvarande anslutningssträngens nyckelord. Mer information finns i Kryptering och certifikatverifiering.

Anmärkning

I anslutningssträngen anger egenskapen Old PasswordSSPROP_AUTH_OLD_PASSWORD, vilken är det aktuella (eventuellt utgångna) lösenordet som inte är tillgängligt via en provideregenskap.

Nyckelord för anslutningssträng för ActiveX-dataobjekt (ADO)

ADO-program anger ConnectionString egenskapen ADODBConnection för objekt eller anger en anslutningssträng som en parameter till Open objektmetoden ADODBConnection .

ADO-program kan också använda nyckelord som används av OLE DB-metoden IDBInitialize::Initialize , men bara för egenskaper som inte har något standardvärde. Om ett program använder både ADO-nyckelorden och nyckelorden IDBInitialize::Initialize i initieringssträngen används ADO-nyckelordsinställningen. 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-string
  • empty-string ::=
  • attribute ::= attribute-keyword=["]attribute-value["]
  • attribute-value ::= character-string
  • attribute-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
Access Token 1 SSPROP_AUTH_ACCESS_TOKEN Åtkomsttoken som används för att autentisera till Microsoft Entra-ID.

Obs! Det är ett fel att ange nyckelordet och även UID, PWD, Trusted_Connectioneller Authentication anslutningssträngsnyckelord eller motsvarande egenskaper/nyckelord.
Application Intent 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.
Application Name SSPROP_INIT_APPNAME Strängen som identifierar programmet.
Authentication 1 SSPROP_AUTH_MODE Anger den SQL- eller Microsoft Entra-autentisering som används. Giltiga värden är:
  • (not set): Autentiseringsläge som bestäms av andra nyckelord.
  • ActiveDirectoryPassword: Användar-ID och lösenordsautentisering med en Microsoft Entra-identitet.
  • ActiveDirectoryIntegrated: Integrerad autentisering med Microsoft Entra-ID.

    • Obs! Nyckelordet ActiveDirectoryIntegrated kan också användas för Windows-autentisering till SQL Server. Det ersätter Integrated Security (eller Trusted_Connection) autentiseringsnyckelord. Program som använder Integrated Security (eller Trusted_Connection) nyckelord eller deras motsvarande egenskaper bör ange värdet för nyckelordet Authentication (eller dess motsvarande egenskap) för att ActiveDirectoryIntegrated aktivera nytt beteende för kryptering och certifikatverifiering.

  • ActiveDirectoryInteractive: Interaktiv autentisering med en Microsoft Entra-identitet. Den här metoden stöder Microsoft Entra multifaktorautentisering.
  • ActiveDirectoryMSI: Hanterad identitetsautentisering . För en användartilldelad identitet ska användar-ID anges till objekt-ID för användaridentiteten.
  • ActiveDirectoryServicePrincipal: Autentisering med ett tjänsthuvudnamn för Microsoft Entra. Användar-ID:t ska vara inställt på programmets (klient)-ID. Lösenordet ska anges till programhemligheten (klienten).
  • SqlPassword: Autentisering med användar-ID och lösenord.

    • Obs! Program som använder SQL Server-autentisering bör ange värdet för nyckelordet Authentication (eller motsvarande egenskap) för att SqlPassword aktivera nytt beteende för kryptering och certifikatverifiering.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Konfigurerar OEM/ANSI-teckenöversättning. Identifierade värden är true och false.
Connect Timeout DBPROP_INIT_TIMEOUT Hur lång tid (i sekunder) det går att vänta tills datakällans initiering har slutförts.
Connect Retry Count 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. Ett värde för 0 skulle inte resultera i något försök att återansluta. Mer information finns i Återhämtning av inaktiv anslutning i OLE DB-drivrutinen.
Connect Retry Interval 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 i OLE DB-drivrutinen.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Sql Server-språknamnet.
Data Source 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 denna artikel.
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.
Host Name In Certificate SSPROP_INIT_HOST_NAME_CERTIFICATE Värdnamnet som ska användas för att verifiera SQL Server TLS/SSL-certifikatet. Om nyckelordet Host Name In Certificate inte har angetts använder drivrutinen nyckelordsvärdet Data Source på anslutnings-URL:en som värdnamn för att verifiera SQL Server TLS/SSL-certifikatet.
Obs! Den här egenskapen ignoreras om servercertifikatet är godkänt. Om Use Encryption for Data är inställt på Strictverifieras alltid certifikatet.
Initial Catalog DBPROP_INIT_CATALOG Databasnamnet
Initial File Name 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 AttachDBFileNamemåste du också ange databasnamnet med nyckelordet providersträng DATABASE . Om databasen tidigare har anslutits kopplar INTE SQL Server den igen (den använder den anslutna databasen som standard för anslutningen).
Integrated Security DBPROP_AUTH_INTEGRATED Accepterar värdet SSPI för Windows-autentisering.
MARS Connection 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=True

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.
Network Address SSPROP_INIT_NETWORKADDRESS Nätverksadressen för en instans av SQL Server i organisationen.

Mer information om giltig adresssyntax finns i beskrivningen av Address-nyckelordet i den här artikeln.
Network Library SSPROP_INIT_NETWORKLIBRARY Nätverksbiblioteket som används för att upprätta en anslutning till en instans av SQL Server i organisationen.
Packet Size SSPROP_INIT_PACKETSIZE TDS-paketstorlek (Tabular Data Stream). Standardvärdet är 0 (det faktiska värdet bestäms av servern).
Password DBPROP_AUTH_PASSWORD Sql Server-inloggningslösenordet.
Persist Security Info 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.
Provider För OLE DB-drivrutinen för SQL Server är värdet MSOLEDBSQL19 eller MSOLEDBSQL.
Server Certificate 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.
Trust Server Certificate 1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Accepterar strängarna true och false som värden. Standardvärdet är false, vilket innebär att servercertifikatet verifieras.
Use Encryption for Data 1 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.
Use 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). Att ställa in Use FMTONLY till true instruerar drivrutinen att använda SET FMTONLY för att hämta metadata i stället.
User ID DBPROP_AUTH_USERID SQL Server-inloggningsnamnet.
Workstation ID SSPROP_INIT_WSID Arbetsstationsidentifieraren.

1 För att förbättra säkerhetsbeteendet, krypteringsbeteendet och certifikatverifieringsbeteendet, ändras detta vid användning av initieringsegenskaper för autentisering/åtkomsttoken eller deras motsvarande anslutningssträngens nyckelord. Mer information finns i Kryptering och certifikatverifiering.

Anmärkning

I anslutningssträngen anger SSPROP_AUTH_OLD_PASSWORDegenskapen "Gammalt lösenord", som är det aktuella (eventuellt utgångna) lösenordet som inte är tillgängligt via en providersträngegenskap.

Relaterat innehåll

  • Last updated on