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 ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics 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::Initialize
IDataInitialize::GetDataSource
In het eerste geval kan een providertekenreeks worden gebruikt om verbindingseigenschappen te initialiseren door de eigenschap in te stellen DBPROP_INIT_PROVIDERSTRING in de DBPROPSET_DBINIT eigenschappenset. In het tweede geval kan een initialisatietekenreeks worden doorgegeven aan de methode IDataInitialize::GetDataSource om verbindingseigenschappen te initialiseren. Beide methoden initialiseren dezelfde OLE DB-verbindingseigenschappen, maar verschillende sets trefwoorden worden gebruikt. De set trefwoorden die worden gebruikt door IDataInitialize::GetDataSource is minimaal de beschrijving van eigenschappen binnen de groep 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 in providertekenreeksen via DBPROP_INIT_PROVIDERSTRING-waarden zijn ingesteld, worden met de waarden yes en no ingesteld. Booleaanse eigenschappen die zijn ingesteld in initialisatietekenreeksen met behulp van IDataInitialize::GetDataSource worden ingesteld met behulp van de waarden true en false.
Toepassingen die gebruikmaken van IDataInitialize::GetDataSource kunnen ook de trefwoorden gebruiken die worden gebruikt door IDBInitialize::Initialize, maar alleen voor eigenschappen die geen standaardwaarde hebben. Als een toepassing zowel het trefwoord IDataInitialize::GetDataSource als het trefwoord IDBInitialize::Initialize gebruikt in de initialisatietekenreeks, wordt de trefwoordinstelling IDataInitialize::GetDataSource gebruikt. Het wordt aanbevolen dat toepassingen geen IDBInitialize gebruiken::Initialiseer trefwoorden in IDataInitialize:GetDataSource-verbindingsreeksen , omdat dit gedrag mogelijk niet wordt onderhouden in toekomstige releases.
Opmerking
Een verbindingsreeks die wordt doorgegeven via IDataInitialize::GetDataSource wordt geconverteerd naar eigenschappen en toegepast via IDBProperties::SetProperties. Als onderdeelservices de beschrijving van de eigenschap hebben gevonden in IDBProperties::GetPropertyInfo, wordt deze eigenschap toegepast als een zelfstandige eigenschap. Anders wordt deze toegepast via DBPROP_PROVIDERSTRING eigenschap. Als u bijvoorbeeld de verbindingsreeksgegevensbron=server1 opgeeft; Server=server2, gegevensbron wordt ingesteld als een eigenschap, maar Server gaat naar 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 met behulp 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 adres. |
| Adres | SSPROP_INIT_NETWORKADDRESS | Het netwerkadres van de server waarop een exemplaar van SQL Server wordt uitgevoerd.
Adres 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 Adres heeft voorrang op de waarde die wordt doorgegeven aan Server in verbindingsreeksen bij gebruik van OLE DB-stuurprogramma voor SQL Server. Houd er ook rekening mee dat Address=; verbinding maakt met de server die is opgegeven in het trefwoord Server, terwijl Address= ;, Address=.;, Address=localhost; en Address=(local); alle een verbinding veroorzaken met de lokale server.De volledige syntaxis voor het trefwoord Adres is als volgt: [protocol:]Adres[,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 trefwoord Netwerk 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 sleutelwoord Database in de providertekenreeks. 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). |
| Verificatie1 | SSPROP_AUTH_MODE | Hiermee geeft u de GEBRUIKTE SQL- of Microsoft Entra-verificatie op. Geldige waarden zijn:
NOTITIE: Het ActiveDirectoryIntegrated trefwoord kan ook worden gebruikt voor Windows-verificatie voor SQL Server. Het vervangt authenticatietrefwoorden Integrated Security (of Trusted_Connection). Het wordt aanbevolen dat toepassingen die de trefwoorden Integrated Security (of Trusted_Connection) of de bijbehorende eigenschappen gebruiken, de waarde van het trefwoord Authentication (of de bijbehorende eigenschap) instellen op ActiveDirectoryIntegrated om het nieuwe versleutelingsgedrag en certificaatvalidatiegedrag in te schakelen.NOTITIE: Het wordt aanbevolen dat toepassingen met behulp van SQL Server verificatie de waarde van het Authentication trefwoord (of de bijbehorende eigenschap) instellen om SqlPassword in te schakelen. |
| Automatisch vertalen | 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 zou resulteren in geen poging opnieuw verbinding te maken. Voor meer informatie, zie Veerkracht van inactieve verbindingen. |
| 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 Niet-actieve verbindingstolerantie 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. |
| Versleutelen1 | 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 trefwoord HostNameInCertificate niet is ingesteld, gebruikt het stuurprogramma de trefwoordwaarde Server op de verbindings-URL als hostnaam om het TLS/SSL-certificaat van SQL Server te valideren. NOTITIE: Deze eigenschap wordt genegeerd als het servercertificaat wordt vertrouwd. Als Encrypt is ingesteld op Strict, wordt het certificaat altijd gevalideerd. |
| Taal | 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=Ja op wanneer u verbinding maakt met de availability group listener van een SQL Server-beschikbaarheidsgroep of een SQL Server-failovercluster-exemplaar.
MultiSubnetFailover=Ja configureert 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 Netwerk. |
| 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. |
| Netwerkbibliotheek | SSPROP_INIT_NETWORKLIBRARY | Synoniem voor Netwerk. |
| Pakketgrootte | 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 trefwoord Adres overschrijft het trefwoord Server . U kunt verbinding maken met het standaardexemplaren op de lokale server door een van de volgende opties op te geven: Server=; Server=.; Server=(lokaal); Server=(lokaal); 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 \ 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 trefwoord Server is als volgt: Server=[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 geen protocol of het trefwoord Netwerk is opgegeven, gebruikt 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 wordt doorgegeven aan Server in verbindingsreeksen bij gebruik van OLE DB-stuurprogramma voor 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. |
| TrustServerCertificate1 | 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). Als u UseFMTONLY instelt, wordt het stuurprogramma geïnstrueerd om in plaats daarvan SET FMTONLY te gebruiken voor het ophalen van metagegevens. |
| 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 validatiegedrag van versleuteling en certificaat gewijzigd wanneer u de initialisatie-eigenschappen van het verificatie- of toegangstoken gebruikt of de bijbehorende trefwoorden voor verbindingsreeksen. Zie Versleuteling en certificaatvalidatie voor meer informatie.
IDataInitialize::GetDataSource gebruiken
Verbindingsreeksen die worden gebruikt door OLE DB-toepassingen met behulp van 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.
WSID gebruikt bijvoorbeeld accolades ({}) aanhalingstekens en Toepassingsnaam maakt gebruik van 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 |
|---|---|---|
| Toegangstoken1 | SSPROP_AUTH_ACCESS_TOKEN | Het toegangstoken dat wordt gebruikt voor verificatie bij Microsoft Entra-id. NOTITIE: Het is een fout om dit trefwoord op te geven en ook UID, PWDof Trusted_Connection verbindingsreekstrefwoorden Authenticationof de bijbehorende eigenschappen/trefwoorden. |
| Toepassingsnaam | SSPROP_INIT_APPNAME | De tekenreeks die de toepassing identificeert. |
| Toepassingsintentie | 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. |
| Verificatie1 | SSPROP_AUTH_MODE | Hiermee geeft u de GEBRUIKTE SQL- of Microsoft Entra-verificatie op. Geldige waarden zijn:
NOTITIE: Het ActiveDirectoryIntegrated trefwoord kan ook worden gebruikt voor Windows-verificatie voor SQL Server. Het vervangt authenticatietrefwoorden Integrated Security (of Trusted_Connection). Het wordt aanbevolen dat toepassingen die de trefwoorden Integrated Security (of Trusted_Connection) of de bijbehorende eigenschappen gebruiken, de waarde van het trefwoord Authentication (of de bijbehorende eigenschap) instellen op ActiveDirectoryIntegrated om het nieuwe versleutelingsgedrag en certificaatvalidatiegedrag in te schakelen.NOTITIE: Het wordt aanbevolen dat toepassingen met behulp van SQL Server verificatie de waarde van het Authentication trefwoord (of de bijbehorende eigenschap) instellen om SqlPassword in te schakelen. |
| Automatisch vertalen | SSPROP_INIT_AUTOTRANSLATE | Hiermee configureert u OEM/ANSI-tekenomzetting. Herkende waarden zijn true en false. |
| Time-out verbinden | DBPROP_INIT_TIMEOUT | De hoeveelheid tijd (in seconden) die moet worden gewacht totdat de initialisatie van de gegevensbron is voltooid. |
| Aantal Herhaalpogingen Verbinden | 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 zou resulteren in geen poging opnieuw verbinding te maken. Zie Niet-actieve verbindingstolerantie voor meer informatie. |
| Interval voor opnieuw proberen verbinden | 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 Niet-actieve verbindingstolerantie voor meer informatie. |
| Huidige taal | SSPROPT_INIT_CURRENTLANGUAGE | De naam van de SQL Server-taal. |
| Gegevensbron | 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 trefwoord Server 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). |
| Failoverpartner | 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. |
| Hostnaam in certificaat | SSPROP_INIT_HOST_NAME_CERTIFICATE | De hostnaam die moet worden gebruikt voor het valideren van het TLS/SSL-certificaat van SQL Server. Als het trefwoord Hostnaam in certificaat niet is ingesteld, gebruikt het stuurprogramma de trefwoordwaarde gegevensbron op de verbindings-URL als hostnaam om het TLS/SSL-certificaat van SQL Server te valideren. NOTITIE: Deze eigenschap wordt genegeerd als het servercertificaat wordt vertrouwd. Als Versleuteling voor gegevens op Strict wordt ingesteld, wordt het certificaat altijd gevalideerd. |
| Eerste catalogus | DBPROP_INIT_CATALOG | De naam van de database. |
| Initiële bestandsnaam | 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 van de providertekenreeks. 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). |
| Geïntegreerde beveiliging | DBPROP_AUTH_INTEGRATED | Accepteert de waarde SSPI voor Windows-verificatie. |
| MARS-verbinding | 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 SQL Server-failoverclusterexemplaar.
MultiSubnetFailover=True configureert 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. |
| Netwerkadres | SSPROP_INIT_NETWORKADDRESS | Het netwerkadres van een exemplaar van SQL Server in de organisatie. Zie de beschrijving van het trefwoord Adres in dit artikel voor meer informatie over geldige adressyntaxis. |
| Netwerkbibliotheek | SSPROP_INIT_NETWORKLIBRARY | De netwerkbibliotheek die wordt gebruikt om een verbinding tot stand te brengen met een exemplaar van SQL Server in de organisatie. |
| Pakketgrootte | SSPROP_INIT_PACKETSIZE | TDS-pakketgrootte (Tabular Data Stream). De standaardwaarde is 0 (de werkelijke waarde wordt bepaald door de server). |
| wachtwoord | DBPROP_AUTH_PASSWORD | Het aanmeldingswachtwoord van SQL Server. |
| Beveiligingsinformatie behouden | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepteert de tekenreeksen true en false als waarden. Wanneer falsemag het gegevensbronobject geen gevoelige verificatiegegevens persistent maken |
| Aanbieder | Voor OLE DB-stuurprogramma voor SQL Server moet deze waarde 'MSOLEDBSQL19' of 'MSOLEDBSQL' zijn. | |
| Servercertificaat | 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. |
| Vertrouwensservercertificaat1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Accepteert de tekenreeksen true en false als waarden. De standaardwaarde is false, wat betekent dat het servercertificaat wordt gevalideerd. |
| Versleuteling gebruiken voor gegevens1 | 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. |
| FMTONLY gebruiken | 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). Door FMTONLY in te stellen, wordt het stuurprogramma geïnstrueerd om in plaats daarvan SET FMTONLY te gebruiken voor het ophalen van metagegevens. |
| Gebruikers-ID | DBPROP_AUTH_USERID | De aanmeldingsnaam van SQL Server. |
| Werkstation-id | SSPROP_INIT_WSID | De werkstation-id. |
[1]: Om de beveiliging te verbeteren worden het gedrag van versleuteling en certificaatvalidatie aangepast bij gebruik van de initialisatie-eigenschappen van Authenticatie/Toegangstokens of hun bijbehorende verbindingsstringsleutelwoorden. Voor details, zie Versleuteling en certificaatvalidatie.
Opmerking
In de verbindingsreeks Old Password wordt SSPROP_AUTH_OLD_PASSWORD ingesteld. Dit is het huidige (mogelijk verlopen) wachtwoord dat niet beschikbaar is via een providertekenreekseigenschap.
ADO-verbindingsreekstrefwoorden (ActiveX Data Objects)
ADO-toepassingen stellen de eigenschap ConnectionString 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 METHODE OLE DB 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 |
|---|---|---|
| Toegangstoken1 | SSPROP_AUTH_ACCESS_TOKEN | Het toegangstoken dat wordt gebruikt voor verificatie bij Microsoft Entra-id. NOTITIE: Het is een fout om dit trefwoord op te geven en ook UID, PWDof Trusted_Connection verbindingsreekstrefwoorden Authenticationof de bijbehorende eigenschappen/trefwoorden. |
| Toepassingsintentie | 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 Driver for SQL Server Support for High Availability, Disaster Recovery. |
| Toepassingsnaam | SSPROP_INIT_APPNAME | De tekenreeks die de toepassing identificeert. |
| Verificatie1 | SSPROP_AUTH_MODE | Hiermee geeft u de GEBRUIKTE SQL- of Microsoft Entra-verificatie op. Geldige waarden zijn:
NOTITIE: Het ActiveDirectoryIntegrated trefwoord kan ook worden gebruikt voor Windows-verificatie voor SQL Server. Het vervangt authenticatiesleutelwoorden Integrated Security (of Trusted_Connection). Het wordt aanbevolen dat toepassingen de trefwoorden Integrated Security (of Trusted_Connection) of hun bijbehorende eigenschappen gebruiken om de waarde van het trefwoord Authentication of de bijbehorende eigenschap in te stellen op ActiveDirectoryIntegrated om nieuw gedrag voor versleuteling en certificaatvalidatie in te schakelen.NOTITIE: Het wordt aanbevolen dat toepassingen met behulp van SQL Server verificatie de waarde van het Authentication trefwoord (of de bijbehorende eigenschap) instellen om SqlPassword in te schakelen. |
| Automatisch vertalen | SSPROP_INIT_AUTOTRANSLATE | Hiermee configureert u OEM/ANSI-tekenomzetting. Herkende waarden zijn true en false. |
| Time-out verbinden | DBPROP_INIT_TIMEOUT | De hoeveelheid tijd (in seconden) die moet worden gewacht totdat de initialisatie van de gegevensbron is voltooid. |
| Aantal Herhaalpogingen Verbinden | 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 zou resulteren in geen poging opnieuw verbinding te maken. Raadpleeg Ongebruikte verbinding veerkracht voor meer informatie. |
| Interval voor opnieuw proberen verbinden | 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. Voor meer informatie, zie Niet-actieve verbindingstolerantie. |
| Huidige taal | SSPROPT_INIT_CURRENTLANGUAGE | De naam van de SQL Server-taal. |
| Gegevensbron | 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 trefwoord Server 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. |
| Failoverpartner | 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. |
| Hostnaam in certificaat | SSPROP_INIT_HOST_NAME_CERTIFICATE | De hostnaam die moet worden gebruikt voor het valideren van het TLS/SSL-certificaat van SQL Server. Als het trefwoord Hostnaam in certificaat niet is ingesteld, gebruikt het stuurprogramma de trefwoordwaarde gegevensbron op de verbindings-URL als hostnaam om het TLS/SSL-certificaat van SQL Server te valideren. NOTITIE: Deze eigenschap wordt genegeerd als het servercertificaat wordt vertrouwd. Als Versleuteling voor gegevens op Strict wordt ingesteld, wordt het certificaat altijd gevalideerd. |
| Eerste catalogus | DBPROP_INIT_CATALOG | De naam van de database. |
| Initiële bestandsnaam | 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 van de providertekenreeks. 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). |
| Geïntegreerde beveiliging | DBPROP_AUTH_INTEGRATED | Accepteert de waarde SSPI voor Windows-verificatie. |
| MARS-verbinding | 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 SQL Server-failoverclusterexemplaar.
MultiSubnetFailover=True configureert 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. |
| Netwerkadres | SSPROP_INIT_NETWORKADDRESS | Het netwerkadres van een exemplaar van SQL Server in de organisatie. Zie de beschrijving van het trefwoord Adres in dit artikel voor meer informatie over geldige adressyntaxis. |
| Netwerkbibliotheek | SSPROP_INIT_NETWORKLIBRARY | De netwerkbibliotheek die wordt gebruikt om een verbinding tot stand te brengen met een exemplaar van SQL Server in de organisatie. |
| Pakketgrootte | SSPROP_INIT_PACKETSIZE | TDS-pakketgrootte (Tabular Data Stream). De standaardwaarde is 0 (de werkelijke waarde wordt bepaald door de server). |
| wachtwoord | DBPROP_AUTH_PASSWORD | Het aanmeldingswachtwoord van SQL Server. |
| Beveiligingsinformatie behouden | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepteert de tekenreeksen true en false als waarden. Wanneer false, is het gegevensbronobject niet toegestaan gevoelige authenticatiegegevens te bewaren. |
| Aanbieder | Voor het OLE DB-stuurprogramma voor SQL Server is de waarde MSOLEDBSQL19 of MSOLEDBSQL. |
|
| Servercertificaat | 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. |
| Vertrouwensservercertificaat1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Accepteert de tekenreeksen true en false als waarden. De standaardwaarde is false, wat betekent dat het servercertificaat wordt gevalideerd. |
| Versleuteling gebruiken voor gegevens1 | 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. |
| FMTONLY gebruiken | 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). Door FMTONLY in te stellen, wordt het stuurprogramma geïnstrueerd om in plaats daarvan SET FMTONLY te gebruiken voor het ophalen van metagegevens. |
| Gebruikers-ID | DBPROP_AUTH_USERID | De aanmeldingsnaam van SQL Server. |
| Werkstation-id | SSPROP_INIT_WSID | De werkstation-id. |
[1]: Om de beveiliging te verbeteren worden het gedrag van versleuteling en certificaatvalidatie aangepast bij gebruik van de initialisatie-eigenschappen van Authenticatie/Toegangstokens of hun bijbehorende verbindingsstringsleutelwoorden. Voor details, zie Versleuteling en certificaatvalidatie.
Opmerking
In de verbindingsreeks wordt met de eigenschap Oud wachtwoord SSPROP_AUTH_OLD_PASSWORD ingesteld. Dit is het huidige (mogelijk verlopen) wachtwoord dat niet beschikbaar is via een providertekenreekseigenschap.