Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics Platform System (PDW)
SQL Database in Microsoft Fabric
OLE DB-stuurprogramma downloaden
Sommige API's in het OLE DB-stuurprogramma voor SQL Server gebruiken verbindingsreeksen om verbindingskenmerken op te geven. Verbindingsreeksen zijn een lijst met trefwoorden en bijbehorende waarden; elk trefwoord identificeert een bepaald verbindingskenmerk.
Opmerking
OLE DB-stuurprogramma voor SQL Server maakt dubbelzinnigheid in verbindingsreeksen mogelijk om compatibiliteit met eerdere versies te behouden (sommige trefwoorden kunnen bijvoorbeeld meerdere keren worden opgegeven en conflicterende trefwoorden kunnen worden toegestaan met een oplossing op basis van positie of prioriteit). Toekomstige releases van HET OLE DB-stuurprogramma voor SQL Server staan mogelijk geen dubbelzinnigheid toe in verbindingsreeksen. Het is een goede gewoonte om bij het wijzigen van toepassingen het OLE DB-stuurprogramma voor SQL Server te gebruiken om eventuele dubbelzinnigheid van verbindingsreeksen te verwijderen.
In de volgende secties worden de trefwoorden beschreven die kunnen worden gebruikt met het OLE DB-stuurprogramma voor SQL Server en ActiveX-gegevensobjecten (ADO) wanneer u OLE DB-stuurprogramma voor SQL Server gebruikt als gegevensprovider.
Trefwoorden voor OLE DB-stuurprogrammaverbindingstekens
Er zijn twee manieren waarop OLE DB-toepassingen gegevensbronobjecten kunnen initialiseren:
IDBInitialize::InitializeIDataInitialize::GetDataSource
In het eerste geval kan een providertekenreeks worden gebruikt om verbindingseigenschappen te initialiseren door de eigenschap DBPROP_INIT_PROVIDERSTRING in te stellen in de DBPROPSET_DBINIT eigenschappenset. In het tweede geval kan een initialisatietekenreeks worden doorgegeven aan IDataInitialize::GetDataSource de methode om verbindingseigenschappen te initialiseren. Beide methoden initialiseren dezelfde OLE DB-verbindingseigenschappen, maar verschillende sets trefwoorden worden gebruikt. De set trefwoorden die IDataInitialize::GetDataSource gebruikt, is minimaal de beschrijving van eigenschappen binnen de groep van initialisatie-eigenschappen.
Elke providertekenreeksinstelling die een bijbehorende OLE DB-eigenschap heeft ingesteld op een bepaalde standaardwaarde of expliciet is ingesteld op een waarde, overschrijft de waarde van de OLE DB-eigenschap de instelling in de providertekenreeks.
Booleaanse eigenschappen die zijn ingesteld in providertekenreeksen via DBPROP_INIT_PROVIDERSTRING waarden, worden ingesteld met behulp van de waarden yes en no. Booleaanse eigenschappen die zijn ingesteld in initialisatietekenreeksen die worden gebruikt IDataInitialize::GetDataSource , worden ingesteld met behulp van de waarden true en false.
Toepassingen die IDataInitialize::GetDataSource gebruiken, kunnen ook de trefwoorden van IDBInitialize::Initialize gebruiken, maar alleen voor eigenschappen die geen standaardwaarde hebben. Als een toepassing zowel het IDataInitialize::GetDataSource trefwoord als het IDBInitialize::Initialize trefwoord in de initialisatietekenreeks gebruikt, wordt de IDataInitialize::GetDataSource trefwoordinstelling gebruikt. Het wordt aanbevolen dat toepassingen geen trefwoorden gebruiken IDBInitialize::Initialize in IDataInitialize:GetDataSource verbindingsreeksen, omdat dit gedrag mogelijk niet wordt gehandhaafd in toekomstige releases.
Opmerking
Een doorgegeven IDataInitialize::GetDataSource verbindingsreeks wordt geconverteerd naar eigenschappen en toegepast via IDBProperties::SetProperties. Als componentservices de beschrijving van de eigenschap in IDBProperties::GetPropertyInfo gevonden hebben, wordt deze eigenschap toegepast als een zelfstandige eigenschap. Anders wordt deze toegepast via DBPROP_PROVIDERSTRING de eigenschap. Als u bijvoorbeeld de verbindingsreeks Data Source=server1;Server=server2 opgeeft, wordt Data Source ingesteld als een eigenschap, maar Server wordt geplaatst in een providertekenreeks.
Als u meerdere exemplaren van dezelfde providerspecifieke eigenschap opgeeft, wordt de eerste waarde van de eerste eigenschap gebruikt.
Het gebruik van IDBInitialize::Initialize
Verbindingsreeksen die worden gebruikt door OLE DB-toepassingen die gebruik maken van DBPROP_INIT_PROVIDERSTRING met IDBInitialize::Initialize hebben de volgende syntaxis:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
Kenmerkwaarden kunnen eventueel tussen accolades worden opgenomen en het is raadzaam dit te doen. Deze procedure voorkomt problemen wanneer kenmerkwaarden niet-alfanumerieke tekens bevatten. De eerste sluitende accolade in de waarde wordt verondersteld de waarde te beëindigen, zodat waarden geen sluitende accolade kunnen bevatten.
Een spatieteken na het = teken van een trefwoord voor een verbindingsreeks wordt geïnterpreteerd als een letterlijke waarde, zelfs als de waarde tussen aanhalingstekens staat.
In de volgende tabel worden de trefwoorden beschreven die kunnen worden gebruikt met DBPROP_INIT_PROVIDERSTRING.
| Keyword | Initialisatie-eigenschap | Description |
|---|---|---|
Addr |
SSPROP_INIT_NETWORKADDRESS |
Synoniem voor Address. |
Address |
SSPROP_INIT_NETWORKADDRESS |
Het netwerkadres van de server waarop een exemplaar van SQL Server wordt uitgevoerd.
Address is meestal de netwerknaam van de server, maar kan andere namen zijn, zoals een pijp, een IP-adres of een TCP/IP-poort en socketadres.Als u een IP-adres opgeeft, moet u ervoor zorgen dat de TCP/IP- of named pipes-protocollen zijn ingeschakeld in SQL Server Configuration Manager. De waarde van Address heeft voorrang op de waarde die wordt doorgegeven Server in verbindingsreeksen bij het gebruik van OLE DB-stuurprogramma voor SQL Server.
Address=;maakt verbinding met de server die is opgegeven in het Server trefwoord, terwijl Address= ;, Address=.;Address=localhost;, en Address=(local); allemaal een verbinding met de lokale server veroorzaken.De volledige syntaxis voor het Address trefwoord is als volgt:[protocol:]Address[,port|\pipe\pipename] protocol kan tcp (TCP/IP), lpc (gedeeld geheugen) of np (named pipes) zijn. Zie Clientprotocollen configureren voor meer informatie over protocollen.Als geen van beide protocollen of het Network trefwoord is opgegeven, gebruikt HET OLE DB-stuurprogramma voor SQL Server de protocolvolgorde die is opgegeven in SQL Server Configuration Manager.poort is de poort waarmee verbinding moet worden gemaakt, op de opgegeven server. SQL Server maakt standaard gebruik van poort 1433. |
APP |
SSPROP_INIT_APPNAME |
De tekenreeks die de toepassing identificeert. |
ApplicationIntent |
SSPROP_INIT_APPLICATIONINTENT |
Declareert het workloadtype van de toepassing bij het maken van verbinding met een server. Mogelijke waarden zijn ReadOnly en ReadWrite.De standaardwaarde is ReadWrite. Voor meer informatie over de ondersteuning van het OLE DB-stuurprogramma voor SQL Server voor Always On-beschikbaarheidsgroepen, zie OLE DB-stuurprogramma voor SQL Server-ondersteuning voor hoge beschikbaarheid en rampenherstel. |
AttachDBFileName |
SSPROP_INIT_FILENAME |
De naam van het primaire bestand (inclusief de volledige padnaam) van een koppelbare database. Als u AttachDBFileName wilt gebruiken, moet u ook de databasenaam opgeven met het trefwoord 'Database' in de providerstring. Als de database eerder is gekoppeld, wordt deze niet opnieuw gekoppeld door SQL Server (de gekoppelde database wordt gebruikt als de standaarddatabase voor de verbinding). |
Authentication
1 |
SSPROP_AUTH_MODE |
Hiermee geeft u de GEBRUIKTE SQL- of Microsoft Entra-verificatie op. Geldige waarden zijn:
Opmerking: Het ActiveDirectoryIntegrated trefwoord kan ook worden gebruikt voor Windows-authenticatie naar SQL Server. Het vervangt authenticatietrefwoorden Integrated Security (of Trusted_Connection). Applicaties die Integrated Security (of Trusted_Connection) sleutelwoorden of hun bijbehorende eigenschappen gebruiken, moeten de waarde van het Authentication trefwoord (of de bijbehorende eigenschap) instellen op ActiveDirectoryIntegrated om een nieuw encryptie- en certificaatvalidatiegedrag mogelijk te maken.Opmerking: Applicaties die SQL Server-authenticatie gebruiken, moeten de waarde van het Authentication trefwoord (of de bijbehorende eigenschap) instellen op om SqlPasswordnieuw encryptie- en certificaatvalidatiegedrag mogelijk te maken. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
Synoniem voor AutoTranslate. |
AutoTranslate |
SSPROP_INIT_AUTOTRANSLATE |
Hiermee configureert u OEM/ANSI-tekenomzetting. Herkende waarden zijn yes en no. |
ConnectRetryCount |
SSPROP_INIT_CONNECT_RETRY_COUNT |
Hiermee bepaalt u het aantal pogingen om opnieuw verbinding te maken als de verbinding is verbroken. Geldige waarden variëren van 0 tot 255. De standaardwaarde is 1. Een waarde van 0 het resultaat is dat er geen poging wordt gemaakt om opnieuw verbinding te maken. Zie Tolerantie voor inactiviteit in het OLE DB-stuurprogramma voor meer informatie. |
ConnectRetryInterval |
SSPROP_INIT_CONNECT_RETRY_INTERVAL |
Hiermee geeft u het aantal seconden op tussen elke poging om de verbinding opnieuw te proberen als de verbinding is verbroken. Geldige waarden variëren van 1 tot 60. De standaardwaarde is 10. Zie Tolerantie voor inactiviteit in het OLE DB-stuurprogramma voor meer informatie. |
Database |
DBPROP_INIT_CATALOG |
De naam van de database. |
DataTypeCompatibility |
SSPROP_INIT_DATATYPECOMPATIBILITY |
Hiermee specificeert u de modus voor het verwerken van gegevenstypen. Herkende waarden zijn 0 voor providergegevenstypen en 80 voor SQL Server 2000 -gegevenstypen (8.x). |
Encrypt
1 |
SSPROP_INIT_ENCRYPT |
Hiermee geeft u op of gegevens moeten worden versleuteld voordat ze via het netwerk worden verzonden. Mogelijke waarden zijn Optional, Mandatoryen Strict. De standaardwaarde is Mandatory. Zie voor versies 18.x.x de belangrijkste verschillen in MSOLEDBSQL-versies. |
FailoverPartner |
SSPROP_INIT_FAILOVERPARTNER |
De naam van de failoverserver die wordt gebruikt voor databasespiegeling. |
FailoverPartnerSPN |
SSPROP_INIT_FAILOVERPARTNERSPN |
De SPN voor de failoverpartner. De standaardwaarde is een lege tekenreeks. Een lege tekenreeks zorgt ervoor dat het OLE DB-stuurprogramma voor SQL Server gebruikmaakt van de standaard-, door de provider gegenereerde SPN. |
HostNameInCertificate |
SSPROP_INIT_HOST_NAME_CERTIFICATE |
De hostnaam die moet worden gebruikt voor het valideren van het TLS/SSL-certificaat van SQL Server. Als het HostNameInCertificate trefwoord niet is ingesteld, gebruikt het stuurprogramma de Server trefwoordwaarde op de verbindings-URL als hostnaam om het SQL Server TLS/SSL-certificaat te valideren.Opmerking: deze eigenschap wordt genegeerd als het servercertificaat wordt vertrouwd. Als Encrypt is ingesteld op Strict, wordt het certificaat altijd gevalideerd. |
Language |
SSPROP_INIT_CURRENTLANGUAGE |
De SQL Server-taal. |
MarsConn |
SSPROP_INIT_MARSCONNECTION |
Hiermee schakelt u meerdere actieve resultatensets (MARS) in of uit op de verbinding als de server SQL Server 2005 (9.x) of hoger is. Mogelijke waarden zijn yes en no. De standaardwaarde is no. |
MultiSubnetFailover |
SSPROP_INIT_MULTISUBNETFAILOVER |
Geef altijd MultiSubnetFailover=Yes op wanneer u verbinding maakt met de listener van een SQL Server-beschikbaarheidsgroep of een exemplaar van een SQL Server-failovercluster.
MultiSubnetFailover=Yes hiermee configureert u het OLE DB-stuurprogramma voor SQL Server om snellere detectie van en verbinding met de (momenteel) actieve server te bieden. Mogelijke waarden zijn Yes en No. De standaardwaarde is No. Voorbeeld:MultiSubnetFailover=YesVoor meer informatie over de ondersteuning van het OLE DB-stuurprogramma voor SQL Server voor Always On-beschikbaarheidsgroepen, zie OLE DB-stuurprogramma voor SQL Server-ondersteuning voor hoge beschikbaarheid en rampenherstel. |
Net |
SSPROP_INIT_NETWORKLIBRARY |
Synoniem voor Network. |
Network |
SSPROP_INIT_NETWORKLIBRARY |
De netwerkbibliotheek die wordt gebruikt om een verbinding tot stand te brengen met een exemplaar van SQL Server in de organisatie. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
Synoniem voor Network. |
PacketSize |
SSPROP_INIT_PACKETSIZE |
TDS-pakketgrootte (Tabular Data Stream). De standaardwaarde is 0 (de werkelijke waarde wordt bepaald door de server). |
PersistSensitive |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
Accepteert de tekenreeksen yes en no als waarden. Wanneer no dit wordt gebruikt, mag het gegevensbronobject geen gevoelige verificatiegegevens persistent maken |
PWD |
DBPROP_AUTH_PASSWORD |
Het aanmeldingswachtwoord van SQL Server. |
Server |
DBPROP_INIT_DATASOURCE |
De naam van een SQL Server-exemplaar. De waarde moet de naam zijn van een server in het netwerk, een IP-adres of de naam van een SQL Server Configuration Manager-alias. Wanneer dit niet is opgegeven, wordt er een verbinding gemaakt met de standaardinstantie op de lokale computer. Het Address trefwoord overschrijft het Server trefwoord.U kunt verbinding maken met het standaardexemplaren op de lokale server door een van de volgende opties op te geven: Server=;Server=.;Server=(local);Server=(local);Server=(localhost);Server=(localdb)\<instancename>;Zie OLE DB-stuurprogramma voor SQL Server-ondersteuning voor LocalDB voor meer informatie over LocalDB-ondersteuning. Als u een benoemd exemplaar van SQL Server wilt opgeven, voegt u \<InstanceName> toe.Als er geen server is opgegeven, wordt er een verbinding gemaakt met de standaardinstantie op de lokale computer. Als u een IP-adres opgeeft, moet u ervoor zorgen dat de TCP/IP- of named pipes-protocollen zijn ingeschakeld in SQL Server Configuration Manager. De volledige syntaxis voor het Server trefwoord is als volgt:[protocol:]Server[,poort] protocol kan tcp (TCP/IP), lpc (gedeeld geheugen) of np (named pipes) zijn.In het volgende voorbeeld wordt een benoemde pijp opgegeven: np:\\.\pipe\MSSQL$MYINST01\sql\queryDe bovenstaande regel geeft het benoemde pipeprotocol ( np), een benoemde pijp op de lokale computer (\\.\pipe), de naam van het SQL Server-exemplaar (MSSQL$MYINST01) en de standaardnaam van de benoemde pipe (sql/query).Als noch een protocol noch het Network trefwoord is opgegeven, gebruikt HET OLE DB-stuurprogramma voor SQL Server de protocolvolgorde die is opgegeven in SQL Server Configuration Manager.poort is de poort waarmee verbinding moet worden gemaakt, op de opgegeven server. SQL Server maakt standaard gebruik van poort 1433.Spaties worden genegeerd aan het begin van de waarde die aan Server wordt doorgegeven in de verbindingsreeks bij het gebruik van het OLE DB-Stuurprogramma van SQL Server. |
ServerCertificate |
SSPROP_INIT_SERVER_CERTIFICATE |
Hiermee geeft u het pad naar een certificaatbestand dat overeenkomt met het SQL Server TLS/SSL-certificaat. Deze optie kan alleen worden gebruikt wanneer Strict versleuteling is ingeschakeld. De geaccepteerde certificaatindelingen zijn PEM, DER en CER. Als dit is opgegeven, wordt het SQL Server-certificaat gecontroleerd door te zien of het opgegeven certificaat een exacte overeenkomst is. |
ServerSPN |
SSPROP_INIT_SERVERSPN |
De SPN voor de server. De standaardwaarde is een lege tekenreeks. Een lege tekenreeks zorgt ervoor dat het OLE DB-stuurprogramma voor SQL Server gebruikmaakt van de standaard-, door de provider gegenereerde SPN. |
Timeout |
DBPROP_INIT_TIMEOUT |
De hoeveelheid tijd (in seconden) die moet worden gewacht totdat de initialisatie van de gegevensbron is voltooid. |
TransparentNetworkIPResolution |
SSPROP_INIT_TNIR |
Beïnvloedt de verbindingsreeks wanneer het eerste opgeloste IP-adres van de hostnaam niet reageert en er meerdere IP-adressen zijn gekoppeld aan de hostnaam. TNIR communiceert met MultiSubnetFailover om verschillende verbindingsreeksen te bieden. Mogelijke waarden zijn Yes en No. De standaardwaarde is Yes. Zie Transparent Network IP Resolution gebruiken voor meer informatie. |
Trusted_Connection |
DBPROP_AUTH_INTEGRATED |
Wanneer yes, geeft deze optie het OLE DB-stuurprogramma voor SQL Server opdracht om Windows-verificatie te gebruiken voor aanmeldingsvalidatie. Anders gebruikt het OLE DB-stuurprogramma voor SQL Server een SQL Server-gebruikersnaam en -wachtwoord voor aanmeldingsvalidatie en moeten de UID- en PWD-trefwoorden worden opgegeven. |
TrustServerCertificate
1 |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
Accepteert de tekenreeksen yes en no als waarden. De standaardwaarde is no, wat betekent dat het servercertificaat wordt gevalideerd. |
UID |
DBPROP_AUTH_USERID |
De aanmeldingsnaam van SQL Server. |
UseFMTONLY |
SSPROP_INIT_USEFMTONLY |
Hiermee bepaalt u hoe metagegevens worden opgehaald wanneer u verbinding maakt met SQL Server 2012 (11.x) en hoger. Mogelijke waarden zijn yes en no. De standaardwaarde is no.Standaard gebruikt het OLE DB-stuurprogramma voor SQL Server sp_describe_first_result_set en sp_describe_undeclared_parameters opgeslagen procedures om metagegevens op te halen. Deze opgeslagen procedures hebben enkele beperkingen (ze mislukken bijvoorbeeld wanneer ze op tijdelijke tabellen werken). Instellen van UseFMTONLY op yes instrueert het stuurprogramma om SET FMTONLY voor het ophalen van metagegevens te gebruiken. |
UseProcForPrepare |
SSPROP_INIT_USEPROCFORPREP |
Dit trefwoord is afgeschaft en de instelling wordt genegeerd door het OLE DB-stuurprogramma voor SQL Server. |
WSID |
SSPROP_INIT_WSID |
De werkstation-id. |
1 Om de beveiliging te verbeteren, wordt het gedrag van versleuteling en certificaatvalidatie gewijzigd bij het gebruik van de eigenschappen voor de initialisatie van authenticatie of accesstokens, of hun overeenkomende trefwoorden in verbindingsreeksen. Zie Versleuteling en certificaatvalidatie voor meer informatie.
IDataInitialize::GetDataSource gebruiken
Verbindingsreeksen die worden gebruikt door OLE DB-toepassingen met IDataInitialize::GetDataSource hebben de volgende syntaxis:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
Het gebruik van eigenschappen moet de syntaxis naleven die in de context is toegestaan. Gebruikt bijvoorbeeld WSID accolades ({}) aanhalingstekens en Application Name gebruikt enkele (') of dubbele (") aanhalingstekens. Alleen tekenreekseigenschappen kunnen worden geciteerd. Als u probeert een geheel getal of een geïnventareerde eigenschap aan te geven, treedt er een Connection String doesn't conform to OLE DB specification fout op.
Kenmerkwaarden kunnen eventueel tussen enkele of dubbele aanhalingstekens worden geplaatst en het is raadzaam dit te doen. Deze procedure voorkomt problemen wanneer waarden niet-alfanumerieke tekens bevatten. Het gebruikte aanhalingsteken kan ook worden weergegeven in waarden als het dubbele aanhalingsteken is.
Een spatieteken na het = teken van een trefwoord voor een verbindingsreeks wordt geïnterpreteerd als een letterlijke waarde, zelfs als de waarde tussen aanhalingstekens staat.
Als een verbindingsreeks meer dan een van de eigenschappen bevat die in de volgende tabel worden vermeld, wordt de waarde van de laatste eigenschap gebruikt.
In de volgende tabel worden de trefwoorden beschreven die kunnen worden gebruikt met IDataInitialize::GetDataSource:
| Keyword | Initialisatie-eigenschap | Description |
|---|---|---|
Access Token
1 |
SSPROP_AUTH_ACCESS_TOKEN |
Het toegangstoken dat wordt gebruikt voor verificatie bij Microsoft Entra-id. Opmerking: het is een fout om dit trefwoord op te geven en ook UID, PWDTrusted_Connectionof Authentication verbindingsreekstrefwoorden of de bijbehorende eigenschappen/trefwoorden. |
Application Name |
SSPROP_INIT_APPNAME |
De tekenreeks die de toepassing identificeert. |
Application Intent |
SSPROP_INIT_APPLICATIONINTENT |
Declareert het workloadtype van de toepassing bij het maken van verbinding met een server. Mogelijke waarden zijn ReadOnly en ReadWrite.De standaardwaarde is ReadWrite. Voor meer informatie over de ondersteuning van het OLE DB-stuurprogramma voor SQL Server voor Always On-beschikbaarheidsgroepen, zie OLE DB-stuurprogramma voor SQL Server-ondersteuning voor hoge beschikbaarheid en rampenherstel. |
Authentication
1 |
SSPROP_AUTH_MODE |
Hiermee geeft u de GEBRUIKTE SQL- of Microsoft Entra-verificatie op. Geldige waarden zijn:
Opmerking: Het ActiveDirectoryIntegrated trefwoord kan ook worden gebruikt voor Windows-authenticatie naar SQL Server. Het vervangt authenticatietrefwoorden Integrated Security (of Trusted_Connection). Applicaties die sleutelwoorden (Integrated Security of Trusted_Connection) of hun bijbehorende eigenschappen gebruiken, moeten de waarde van het sleutelwoord Authentication (of de bijbehorende eigenschap) instellen op ActiveDirectoryIntegrated om nieuw gedrag voor encryptie en certificaatvalidatie mogelijk te maken.Opmerking: Applicaties die SQL Server-authenticatie gebruiken, moeten de waarde van het Authentication trefwoord (of de bijbehorende eigenschap) instellen op om SqlPasswordnieuw encryptie- en certificaatvalidatiegedrag mogelijk te maken. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
Hiermee configureert u OEM/ANSI-tekenomzetting. Herkende waarden zijn true en false. |
Connect Timeout |
DBPROP_INIT_TIMEOUT |
De hoeveelheid tijd (in seconden) die moet worden gewacht totdat de initialisatie van de gegevensbron is voltooid. |
Connect Retry Count |
SSPROP_INIT_CONNECT_RETRY_COUNT |
Hiermee bepaalt u het aantal pogingen om opnieuw verbinding te maken als de verbinding is verbroken. Geldige waarden variëren van 0 tot 255. De standaardwaarde is 1. Een waarde van 0 het resultaat is dat er geen poging wordt gemaakt om opnieuw verbinding te maken. Zie Tolerantie voor inactiviteit in het OLE DB-stuurprogramma voor meer informatie. |
Connect Retry Interval |
SSPROP_INIT_CONNECT_RETRY_INTERVAL |
Hiermee geeft u het aantal seconden op tussen elke poging om de verbinding opnieuw te proberen als de verbinding is verbroken. Geldige waarden variëren van 1 tot 60. De standaardwaarde is 10. Zie Tolerantie voor inactiviteit in het OLE DB-stuurprogramma voor meer informatie. |
Current Language |
SSPROPT_INIT_CURRENTLANGUAGE |
De naam van de SQL Server-taal. |
Data Source |
DBPROP_INIT_DATASOURCE |
De naam van een exemplaar van SQL Server in de organisatie. Wanneer dit niet is opgegeven, wordt er een verbinding gemaakt met de standaardinstantie op de lokale computer. Zie de beschrijving van het Server trefwoord in dit artikel voor meer informatie over geldige adressyntaxis. |
DataTypeCompatibility |
SSPROP_INIT_DATATYPECOMPATIBILITY |
Hiermee specificeert u de modus voor het verwerken van gegevenstypen. Herkende waarden zijn 0 voor providergegevenstypen en 80 voor SQL Server 2000 -gegevenstypen (8.x). |
Failover Partner |
SSPROP_INIT_FAILOVERPARTNER |
De naam van de failoverserver die wordt gebruikt voor databasespiegeling. |
Failover Partner SPN |
SSPROP_INIT_FAILOVERPARTNERSPN |
De SPN voor de failoverpartner. De standaardwaarde is een lege tekenreeks. Een lege tekenreeks zorgt ervoor dat het OLE DB-stuurprogramma voor SQL Server gebruikmaakt van de standaard-, door de provider gegenereerde SPN. |
Host Name In Certificate |
SSPROP_INIT_HOST_NAME_CERTIFICATE |
De hostnaam die moet worden gebruikt voor het valideren van het TLS/SSL-certificaat van SQL Server. Als het Host Name In Certificate trefwoord niet is ingesteld, gebruikt het stuurprogramma de Data Source trefwoordwaarde op de verbindings-URL als hostnaam om het SQL Server TLS/SSL-certificaat te valideren.Opmerking: deze eigenschap wordt genegeerd als het servercertificaat wordt vertrouwd. Als Use Encryption for Data is ingesteld op Strict, wordt het certificaat altijd gevalideerd. |
Initial Catalog |
DBPROP_INIT_CATALOG |
De naam van de database. |
Initial File Name |
SSPROP_INIT_FILENAME |
De naam van het primaire bestand (inclusief de volledige padnaam) van een koppelbare database. Als u wilt gebruiken AttachDBFileName, moet u ook de databasenaam opgeven met het trefwoord providertekenreeks DATABASE . Als de database eerder is gekoppeld, wordt deze niet opnieuw gekoppeld door SQL Server (de gekoppelde database wordt gebruikt als de standaarddatabase voor de verbinding). |
Integrated Security |
DBPROP_AUTH_INTEGRATED |
Accepteert de waarde SSPI voor Windows-verificatie. |
MARS Connection |
SSPROP_INIT_MARSCONNECTION |
Met deze optie kunt u meerdere actieve resultatensets (MARS) in- of uitschakelen voor de verbinding. Herkende waarden zijn true en false. De standaardwaarde is false. |
MultiSubnetFailover |
SSPROP_INIT_MULTISUBNETFAILOVER |
Geef altijd MultiSubnetFailover=True op wanneer u verbinding maakt met de listener van een SQL Server-beschikbaarheidsgroep of een exemplaar van een SQL Server-failovercluster.
MultiSubnetFailover=True hiermee configureert u het OLE DB-stuurprogramma voor SQL Server om snellere detectie van en verbinding met de (momenteel) actieve server te bieden. Mogelijke waarden zijn True en False. De standaardwaarde is False. Voorbeeld:MultiSubnetFailover=TrueVoor meer informatie over de ondersteuning van het OLE DB-stuurprogramma voor SQL Server voor Always On-beschikbaarheidsgroepen, zie OLE DB-stuurprogramma voor SQL Server-ondersteuning voor hoge beschikbaarheid en rampenherstel. |
Network Address |
SSPROP_INIT_NETWORKADDRESS |
Het netwerkadres van een exemplaar van SQL Server in de organisatie. Zie de beschrijving van het Address trefwoord in dit artikel voor meer informatie over geldige adressyntaxis. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
De netwerkbibliotheek die wordt gebruikt om een verbinding tot stand te brengen met een exemplaar van SQL Server in de organisatie. |
Packet Size |
SSPROP_INIT_PACKETSIZE |
TDS-pakketgrootte (Tabular Data Stream). De standaardwaarde is 0 (de werkelijke waarde wordt bepaald door de server). |
Password |
DBPROP_AUTH_PASSWORD |
Het aanmeldingswachtwoord van SQL Server. |
Persist Security Info |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
Accepteert de tekenreeksen true en false als waarden. Wanneer falsemag het gegevensbronobject geen gevoelige verificatiegegevens persistent maken |
Provider |
Voor het OLE DB-stuurprogramma voor SQL Server is de waarde MSOLEDBSQL19 of MSOLEDBSQL. |
|
Server Certificate |
SSPROP_INIT_SERVER_CERTIFICATE |
Hiermee geeft u het pad naar een certificaatbestand dat overeenkomt met het SQL Server TLS/SSL-certificaat. Deze optie kan alleen worden gebruikt wanneer Strict versleuteling is ingeschakeld. De geaccepteerde certificaatindelingen zijn PEM, DER en CER. Als dit is opgegeven, wordt het SQL Server-certificaat gecontroleerd door te zien of het opgegeven certificaat een exacte overeenkomst is. |
Server SPN |
SSPROP_INIT_SERVERSPN |
De SPN voor de server. De standaardwaarde is een lege tekenreeks. Een lege tekenreeks zorgt ervoor dat het OLE DB-stuurprogramma voor SQL Server gebruikmaakt van de standaard-, door de provider gegenereerde SPN. |
TransparentNetworkIPResolution |
SSPROP_INIT_TNIR |
Beïnvloedt de verbindingsreeks wanneer het eerste opgeloste IP-adres van de hostnaam niet reageert en er meerdere IP-adressen zijn gekoppeld aan de hostnaam. TNIR communiceert met MultiSubnetFailover om verschillende verbindingsreeksen te bieden. Mogelijke waarden zijn True en False. De standaardwaarde is True. Zie Transparent Network IP Resolution gebruiken voor meer informatie. |
Trust Server Certificate
1 |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
Accepteert de tekenreeksen true en false als waarden. De standaardwaarde is false, wat betekent dat het servercertificaat wordt gevalideerd. |
Use Encryption for Data
1 |
SSPROP_INIT_ENCRYPT |
Hiermee geeft u op of gegevens moeten worden versleuteld voordat ze via het netwerk worden verzonden. Mogelijke waarden zijn Optional, Mandatoryen Strict. De standaardwaarde is Mandatory. Zie voor versies 18.x.x de belangrijkste verschillen in MSOLEDBSQL-versies. |
Use FMTONLY |
SSPROP_INIT_USEFMTONLY |
Hiermee bepaalt u hoe metagegevens worden opgehaald wanneer u verbinding maakt met SQL Server 2012 (11.x) en hoger. Mogelijke waarden zijn true en false. De standaardwaarde is false.Standaard gebruikt het OLE DB-stuurprogramma voor SQL Server sp_describe_first_result_set en sp_describe_undeclared_parameters opgeslagen procedures om metagegevens op te halen. Deze opgeslagen procedures hebben enkele beperkingen (ze mislukken bijvoorbeeld wanneer ze op tijdelijke tabellen werken). Instellen van Use FMTONLY op true instrueert het stuurprogramma om SET FMTONLY voor het ophalen van metagegevens te gebruiken. |
User ID |
DBPROP_AUTH_USERID |
De aanmeldingsnaam van SQL Server. |
Workstation ID |
SSPROP_INIT_WSID |
De werkstation-id. |
1 Om de beveiliging te verbeteren, wordt het gedrag van versleuteling en certificaatvalidatie aangepast bij het gebruik van eigenschappen voor initialisatie van authenticatie-/toegangstokens of hun bijbehorende trefwoorden voor verbindingsreeksen. Voor details, zie Versleuteling en certificaatvalidatie.
Opmerking
In de verbindingsreeks stelt de Old Password eigenschap SSPROP_AUTH_OLD_PASSWORD in, wat het huidige (mogelijk verlopen) wachtwoord is dat niet beschikbaar is via een providertekenreekseigenschap.
ADO-verbindingsreekstrefwoorden (ActiveX Data Objects)
ADO-toepassingen stellen de ConnectionString eigenschap van ADODBConnection objecten in of leveren een verbindingsreeks op als parameter voor de Open methode van ADODBConnection objecten.
ADO-toepassingen kunnen ook de trefwoorden gebruiken die worden gebruikt door de OLE DB-methode IDBInitialize::Initialize , maar alleen voor eigenschappen die geen standaardwaarde hebben. Als een toepassing zowel de ADO-trefwoorden als de IDBInitialize::Initialize trefwoorden in de initialisatietekenreeks gebruikt, wordt de ADO-trefwoordinstelling gebruikt. Het wordt aanbevolen dat toepassingen alleen trefwoorden voor ADO-verbindingsreeksen gebruiken.
Verbindingsreeksen die door ADO worden gebruikt, hebben de volgende syntaxis:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
Kenmerkwaarden kunnen eventueel tussen dubbele aanhalingstekens worden geplaatst en het is raadzaam dit te doen. Deze procedure voorkomt problemen wanneer waarden niet-alfanumerieke tekens bevatten. Kenmerkwaarden mogen geen dubbele aanhalingstekens bevatten.
In de volgende tabel worden de trefwoorden beschreven die kunnen worden gebruikt met een ADO-verbindingsreeks:
| Keyword | Initialisatie-eigenschap | Description |
|---|---|---|
Access Token
1 |
SSPROP_AUTH_ACCESS_TOKEN |
Het toegangstoken dat wordt gebruikt voor verificatie bij Microsoft Entra-id. Opmerking: het is een fout om dit trefwoord op te geven en ook UID, PWDTrusted_Connectionof Authentication verbindingsreekstrefwoorden of de bijbehorende eigenschappen/trefwoorden. |
Application Intent |
SSPROP_INIT_APPLICATIONINTENT |
Declareert het workloadtype van de toepassing bij het maken van verbinding met een server. Mogelijke waarden zijn ReadOnly en ReadWrite.De standaardwaarde is ReadWrite. Voor meer informatie over de ondersteuning van het OLE DB-stuurprogramma voor SQL Server voor Always On-beschikbaarheidsgroepen, zie OLE DB-stuurprogramma voor SQL Server-ondersteuning voor hoge beschikbaarheid en rampenherstel. |
Application Name |
SSPROP_INIT_APPNAME |
De tekenreeks die de toepassing identificeert. |
Authentication
1 |
SSPROP_AUTH_MODE |
Hiermee geeft u de GEBRUIKTE SQL- of Microsoft Entra-verificatie op. Geldige waarden zijn:
Opmerking: Het ActiveDirectoryIntegrated trefwoord kan ook worden gebruikt voor Windows-authenticatie naar SQL Server. Het vervangt authenticatietrefwoorden Integrated Security (of Trusted_Connection). Applicaties die sleutelwoorden (of Trusted_Connection) of hun bijbehorende eigenschappen gebruiken, moeten de waarde van het trefwoord Authentication (of de bijbehorende eigenschap) instellen op ActiveDirectoryIntegrated om nieuw gedrag voor encryptie en certificaatvalidatie mogelijk te maken.Opmerking: Applicaties die SQL Server-authenticatie gebruiken, moeten de waarde van het Authentication trefwoord (of de bijbehorende eigenschap) instellen op om SqlPasswordnieuw encryptie- en certificaatvalidatiegedrag mogelijk te maken. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
Hiermee configureert u OEM/ANSI-tekenomzetting. Herkende waarden zijn true en false. |
Connect Timeout |
DBPROP_INIT_TIMEOUT |
De hoeveelheid tijd (in seconden) die moet worden gewacht totdat de initialisatie van de gegevensbron is voltooid. |
Connect Retry Count |
SSPROP_INIT_CONNECT_RETRY_COUNT |
Hiermee bepaalt u het aantal pogingen om opnieuw verbinding te maken als de verbinding is verbroken. Geldige waarden variëren van 0 tot 255. De standaardwaarde is 1. Een waarde van 0 het resultaat is dat er geen poging wordt gemaakt om opnieuw verbinding te maken. Zie Tolerantie voor inactiviteit in het OLE DB-stuurprogramma voor meer informatie. |
Connect Retry Interval |
SSPROP_INIT_CONNECT_RETRY_INTERVAL |
Hiermee geeft u het aantal seconden op tussen elke poging om de verbinding opnieuw te proberen als de verbinding is verbroken. Geldige waarden variëren van 1 tot 60. De standaardwaarde is 10. Zie Tolerantie voor inactiviteit in het OLE DB-stuurprogramma voor meer informatie. |
Current Language |
SSPROPT_INIT_CURRENTLANGUAGE |
De naam van de SQL Server-taal. |
Data Source |
DBPROP_INIT_DATASOURCE |
De naam van een exemplaar van SQL Server in de organisatie. Wanneer dit niet is opgegeven, wordt er een verbinding gemaakt met de standaardinstantie op de lokale computer. Zie de beschrijving van het Server trefwoord in dit artikel voor meer informatie over geldige adressyntaxis. |
DataTypeCompatibility |
SSPROP_INIT_DATATYPECOMPATIBILITY |
Specificeert de modus van verwerking van datatypen die wordt gebruikt. Herkende waarden zijn 0 voor providergegevenstypen en 80 voor SQL Server 2000 -gegevenstypen (8.x). |
Failover Partner |
SSPROP_INIT_FAILOVERPARTNER |
De naam van de failoverserver die wordt gebruikt voor databasespiegeling. |
Failover Partner SPN |
SSPROP_INIT_FAILOVERPARTNERSPN |
De SPN voor de failoverpartner. De standaardwaarde is een lege tekenreeks. Een lege tekenreeks zorgt ervoor dat het OLE DB-stuurprogramma voor SQL Server gebruikmaakt van de standaard-, door de provider gegenereerde SPN. |
Host Name In Certificate |
SSPROP_INIT_HOST_NAME_CERTIFICATE |
De hostnaam die moet worden gebruikt voor het valideren van het TLS/SSL-certificaat van SQL Server. Als het Host Name In Certificate trefwoord niet is ingesteld, gebruikt het stuurprogramma de Data Source trefwoordwaarde op de verbindings-URL als hostnaam om het SQL Server TLS/SSL-certificaat te valideren.Opmerking: deze eigenschap wordt genegeerd als het servercertificaat wordt vertrouwd. Als Use Encryption for Data is ingesteld op Strict, wordt het certificaat altijd gevalideerd. |
Initial Catalog |
DBPROP_INIT_CATALOG |
De naam van de database. |
Initial File Name |
SSPROP_INIT_FILENAME |
De naam van het primaire bestand (inclusief de volledige padnaam) van een koppelbare database. Als u wilt gebruiken AttachDBFileName, moet u ook de databasenaam opgeven met het trefwoord providertekenreeks DATABASE . Als de database eerder is gekoppeld, wordt deze niet opnieuw gekoppeld door SQL Server (de gekoppelde database wordt gebruikt als de standaarddatabase voor de verbinding). |
Integrated Security |
DBPROP_AUTH_INTEGRATED |
Accepteert de waarde SSPI voor Windows-verificatie. |
MARS Connection |
SSPROP_INIT_MARSCONNECTION |
Hiermee schakelt u meerdere actieve resultatensets (MARS) in of uit op de verbinding als de server SQL Server 2005 (9.x) of hoger is. Herkende waarden zijn true en false. De standaardwaarde is false. |
MultiSubnetFailover |
SSPROP_INIT_MULTISUBNETFAILOVER |
Geef altijd MultiSubnetFailover=True op wanneer u verbinding maakt met de listener van een SQL Server-beschikbaarheidsgroep of een exemplaar van een SQL Server-failovercluster.
MultiSubnetFailover=True hiermee configureert u het OLE DB-stuurprogramma voor SQL Server om snellere detectie van en verbinding met de (momenteel) actieve server te bieden. Mogelijke waarden zijn True en False. De standaardwaarde is False. Voorbeeld:MultiSubnetFailover=TrueVoor meer informatie over de ondersteuning van het OLE DB-stuurprogramma voor SQL Server voor Always On-beschikbaarheidsgroepen, zie OLE DB-stuurprogramma voor SQL Server-ondersteuning voor hoge beschikbaarheid en rampenherstel. |
Network Address |
SSPROP_INIT_NETWORKADDRESS |
Het netwerkadres van een exemplaar van SQL Server in de organisatie. Zie de beschrijving van het Address trefwoord in dit artikel voor meer informatie over geldige adressyntaxis. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
De netwerkbibliotheek die wordt gebruikt om een verbinding tot stand te brengen met een exemplaar van SQL Server in de organisatie. |
Packet Size |
SSPROP_INIT_PACKETSIZE |
TDS-pakketgrootte (Tabular Data Stream). De standaardwaarde is 0 (de werkelijke waarde wordt bepaald door de server). |
Password |
DBPROP_AUTH_PASSWORD |
Het aanmeldingswachtwoord van SQL Server. |
Persist Security Info |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
Accepteert de tekenreeksen true en false als waarden. Wanneer false, is het gegevensbronobject niet toegestaan gevoelige authenticatiegegevens te bewaren. |
Provider |
Voor het OLE DB-stuurprogramma voor SQL Server is de waarde MSOLEDBSQL19 of MSOLEDBSQL. |
|
Server Certificate |
SSPROP_INIT_SERVER_CERTIFICATE |
Hiermee geeft u het pad naar een certificaatbestand dat overeenkomt met het SQL Server TLS/SSL-certificaat. Deze optie kan alleen worden gebruikt wanneer Strict versleuteling is ingeschakeld. De geaccepteerde certificaatindelingen zijn PEM, DER en CER. Als dit is opgegeven, wordt het SQL Server-certificaat gecontroleerd door te zien of het opgegeven certificaat een exacte overeenkomst is. |
Server SPN |
SSPROP_INIT_SERVERSPN |
De SPN voor de server. De standaardwaarde is een lege tekenreeks. Een lege tekenreeks zorgt ervoor dat het OLE DB-stuurprogramma voor SQL Server gebruikmaakt van de standaard-, door de provider gegenereerde SPN. |
TransparentNetworkIPResolution |
SSPROP_INIT_TNIR |
Beïnvloedt de verbindingsreeks wanneer het eerste opgeloste IP-adres van de hostnaam niet reageert en er meerdere IP-adressen zijn gekoppeld aan de hostnaam. TNIR communiceert met MultiSubnetFailover om verschillende verbindingsreeksen te bieden. Mogelijke waarden zijn True en False. De standaardwaarde is True. Zie Transparent Network IP Resolution gebruiken voor meer informatie. |
Trust Server Certificate
1 |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
Accepteert de tekenreeksen true en false als waarden. De standaardwaarde is false, wat betekent dat het servercertificaat wordt gevalideerd. |
Use Encryption for Data
1 |
SSPROP_INIT_ENCRYPT |
Hiermee geeft u op of gegevens moeten worden versleuteld voordat ze via het netwerk worden verzonden. Mogelijke waarden zijn Optional, Mandatoryen Strict. De standaardwaarde is Mandatory. Zie voor versies 18.x.x de belangrijkste verschillen in MSOLEDBSQL-versies. |
Use FMTONLY |
SSPROP_INIT_USEFMTONLY |
Hiermee bepaalt u hoe metagegevens worden opgehaald wanneer u verbinding maakt met SQL Server 2012 (11.x) en hoger. Mogelijke waarden zijn true en false. De standaardwaarde is false.Standaard gebruikt het OLE DB-stuurprogramma voor SQL Server sp_describe_first_result_set en sp_describe_undeclared_parameters opgeslagen procedures om metagegevens op te halen. Deze opgeslagen procedures hebben enkele beperkingen (ze mislukken bijvoorbeeld wanneer ze op tijdelijke tabellen werken). Instellen van Use FMTONLY op true instrueert het stuurprogramma om SET FMTONLY voor het ophalen van metagegevens te gebruiken. |
User ID |
DBPROP_AUTH_USERID |
De aanmeldingsnaam van SQL Server. |
Workstation ID |
SSPROP_INIT_WSID |
De werkstation-id. |
1 Om de beveiliging te verbeteren, wordt het gedrag van versleuteling en certificaatvalidatie aangepast bij het gebruik van eigenschappen voor initialisatie van authenticatie-/toegangstokens of hun bijbehorende trefwoorden voor verbindingsreeksen. Voor details, zie Versleuteling en certificaatvalidatie.
Opmerking
In de verbindingsreeks wordt de eigenschap Oud wachtwoord ingesteld SSPROP_AUTH_OLD_PASSWORD. Dit is het huidige (mogelijk verlopen) wachtwoord dat niet beschikbaar is via een providertekenreekseigenschap.