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)
Belangrijk
SQL Server Native Client (SNAC) wordt niet geleverd met:
- SQL Server 2022 (16.x) en latere versies
- SQL Server Management Studio 19 en latere versies
De SQL Server Native Client (SQLNCLI of SQLNCLI11) en de verouderde Microsoft OLE DB-provider voor SQL Server (SQLOLEDB) worden niet aanbevolen voor de ontwikkeling van nieuwe toepassingen.
Gebruik een van de volgende stuurprogramma's voor nieuwe projecten:
Voor SQLNCLI die als onderdeel van SQL Server Database Engine (versies 2012 tot en met 2019) wordt geleverd, raadpleegt u deze uitzondering voor de levenscyclus van ondersteuning.
Sommige SQL Server Native Client API's gebruiken verbindingsstrings om verbindingsattributen te specificeren. Verbindingsstrings zijn lijsten van trefwoorden en bijbehorende waarden; Elk trefwoord identificeert een specifiek verbindingsattribuut.
Voor informatie, zie Verbindingsstring-sleutelwoorden gebruiken met OLE DB Driver for SQL Server.
Opmerking
SQL Server Native Client laat ambiguïteit in verbindingsstrings toe om achterwaartse compatibiliteit te behouden (bijvoorbeeld, sommige trefwoorden kunnen meer dan eens worden gespecificeerd, en conflicterende trefwoorden kunnen worden toegestaan met oplossing op basis van positie of precedent). Het is goede praktijk bij het aanpassen van applicaties om SQL Server Native Client te gebruiken om afhankelijkheid van verbindingsreeks-ambiguïteit te elimineren.
De volgende secties beschrijven de trefwoorden die gebruikt kunnen worden met de SQL Server Native Client OLE DB-provider, de SQL Server Native Client ODBC-driver en ActiveX Data Objects (ADO) wanneer SQL Server Native Client als dataprovider wordt gebruikt.
ODBC Driver verbindingsreeks trefwoorden
ODBC-applicaties gebruiken verbindingsstrings als parameters voor de SQLDriverConnect- en SQLBrowseConnect-functies .
Verbindingsstrings die door ODBC worden gebruikt, hebben de volgende syntaxis:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=[{]attribute-value[}]
attribute-value ::= character-string
attribute-keyword ::= identifier
Attribuutwaarden kunnen optioneel worden omsloten door beugels, en het is goede praktijk om dit te doen. Dit voorkomt problemen wanneer attribuutwaarden niet-alfanumerieke tekens bevatten. De eerste sluitende crace in de waarde wordt verondersteld de waarde te beëindigen, dus waarden kunnen geen sluitende crace bevatten.
De volgende tabel beschrijft de trefwoorden die gebruikt kunnen worden met een ODBC-verbindingsreeks.
| Keyword | Description |
|---|---|
| Addr | Synoniem voor "Adres". |
| Adres | 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 Address gaat voor de waarde die aan Server wordt doorgegeven in ODBC-verbindingsstrings bij gebruik van SQL Server Native Client. 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 noch het protocol noch het netwerk-sleutelwoord zijn opgegeven, zal SQL Server Native Client de protocolvolgorde gebruiken die in SQL Server Configuration Manager is gespecificeerd. poort is de poort waarmee verbinding moet worden gemaakt, op de opgegeven server. SQL Server maakt standaard gebruik van poort 1433. |
| AnsiNPW | Wanneer "ja" is, gebruikt de driver ANSI-gedefinieerde gedragingen voor het afhandelen van NULL-vergelijkingen, tekengegevensopvulling, waarschuwingen en NULL-concatenatie. Wanneer "nee", worden door ANSI gedefinieerde gedragingen niet blootgesteld. Voor meer informatie over het gedrag van ANSI NPW, zie Effecten van ISO-opties. |
| APP | Naam van de applicatie die SQLDriverConnect aanroept (optioneel). Indien gespecificeerd, wordt deze waarde opgeslagen in de kolom master.dbo.sysprocessesprogram_name en wordt teruggegeven door sp_who en de APP_NAME functies. |
| ApplicationIntent | Declareert het workloadtype van de toepassing bij het maken van verbinding met een server. Mogelijke waarden zijn ReadOnly- en ReadWrite-. De standaard is ReadWrite. Voorbeeld:ApplicationIntent=ReadOnlyVoor meer informatie over de ondersteuning van SQL Server Native Client's voor Always On-beschikbaarheidsgroepen, zie SQL Server Native Client Support for High Availability, Disaster Recovery. |
| AttachDBFileName | De naam van het primaire bestand van een toevoegbare database. Voeg het volledige pad toe en escape elk \ tekens als je een C tekenreeks variabele gebruikt:AttachDBFileName=c:\\MyFolder\\MyDB.mdfDeze database wordt aangesloten en wordt de standaarddatabase voor de verbinding. Om AttachDBFileName te gebruiken, moet je ook de databasenaam opgeven in de SQLDriverConnect-parameterDATABASE of het SQL_COPT_CURRENT_CATALOG connection-attribuut. Als de database eerder was aangesloten, koppelt SQL Server deze niet opnieuw aan; het gebruikt de gekoppelde database als standaard voor de verbinding. |
| AutoTranslate | Wanneer "ja" wordt gezegd, worden ANSI-tekenreeksen die tussen client en server worden verzonden vertaald door via Unicode te converteren om problemen te minimaliseren met het matchen van uitgebreide tekens tussen de codepagina's op de client en de server. Client-SQL_C_CHAR data die naar een SQL Server karakter, varchar of tekstvariabele, parameter of kolom wordt gestuurd, wordt omgezet van teken naar Unicode met behulp van de client ANSI-codepagina (ACP), en vervolgens omgezet van Unicode naar teken met behulp van de ACP van de server. SQL Server char-, varchar- of tekstgegevens die naar een client worden gestuurd SQL_C_CHAR variabele worden omgezet van karakter naar Unicode met de server ACP, en vervolgens van Unicode naar karakter met de client ACP. Deze conversies worden op de client uitgevoerd door de SQL Server Native Client ODBC-driver. Dit vereist dat dezelfde ANSI-codepage (ACP) die op de server wordt gebruikt, beschikbaar is op de client. Deze instellingen hebben geen effect op de conversies die plaatsvinden voor deze overdrachten: * Unicode SQL_C_WCHAR clientgegevens die naar char, varchar of tekst op de server worden gestuurd. * char-, varchar- of tekstservergegevens die naar een Unicode SQL_C_WCHAR-variabele op de client worden gestuurd. * ANSI SQL_C_CHAR clientgegevens die naar Unicode nchar, nvarchar of ntext op de server worden gestuurd. * Unicode nchar, nvarchar of ntext servergegevens die naar een ANSI SQL_C_CHAR variabele op de client worden gestuurd. Wanneer "nee", wordt er geen karaktervertaling uitgevoerd. De SQL Server Native Client ODBC-driver vertaalt geen client ANSI-tekens SQL_C_CHAR gegevens die naar char, varchar of tekstvariabelen, parameters of kolommen op de server worden gestuurd. Er wordt geen vertaling uitgevoerd op char-, varchar- of tekstgegevens die van de server naar SQL_C_CHAR variabelen op de client worden gestuurd. Als de client en SQL Server verschillende ACP's gebruiken, kunnen uitgebreide tekens verkeerd worden geïnterpreteerd. |
| Database | Naam van de standaard SQL Server-database voor de verbinding. Als Database niet is opgegeven, wordt de standaarddatabase gebruikt die voor het inlogen is gedefinieerd. De standaarddatabase van de ODBC-databron overschrijft de standaarddatabase die voor het inlogen is gedefinieerd. De database moet een bestaande database zijn, tenzij ook AttachDBFileName is gespecificeerd. Als AttachDBFileName ook wordt gespecificeerd, wordt het primaire bestand waarnaar het verwijst toegevoegd en krijgt het de databasenaam die door Database is opgegeven. |
| stuurprogramma | De naam van de driver zoals teruggegeven door SQLDrivers. De trefwoordwaarde voor de SQL Server Native Client ODBC-driver is "{SQL Server Native Client 11.0}". Het Server-sleutelwoord is vereist als Driver is opgegeven en DriverCompletion is ingesteld op SQL_DRIVER_NOPROMPT. Voor meer informatie over drivernamen, zie Using the SQL Server Native Client Header and Library Files. |
| DSN | Naam van een bestaande ODBC-gebruiker of systeemgegevensbron. Dit trefwoord overschrijft alle waarden die mogelijk zijn gespecificeerd in de zoekwoorden Server, Netwerk en Adres . |
| Coderen | Hiermee geeft u op of gegevens moeten worden versleuteld voordat ze via het netwerk worden verzonden. Mogelijke waarden zijn "ja"/"verplicht" (18,0+), 'nee'/'optioneel' (18,0+) en 'strict' (18,0+). De standaardwaarde is "ja" in versie 18.0+ en "nee" in eerdere versies. |
| Fallback | Dit trefwoord is verouderd en de instelling ervan wordt genegeerd door de SQL Server Native Client ODBC-driver. |
| Failover_Partner | De naam van de failover-partnerserver die moet worden gebruikt als er geen verbinding kan worden gemaakt met de primaire server. |
| FailoverPartnerSPN | De SPN voor de failoverpartner. De standaardwaarde is een lege tekenreeks. Een lege string zorgt ervoor dat de SQL Server Native Client het standaard, door de driver gegenereerde SPN gebruikt. |
| FileDSN | Naam van een bestaande ODBC-gebruiker of systeemgegevensbron. |
| Taal | SQL Server-taalnaam (optioneel). SQL Server kan berichten voor meerdere talen opslaan in sysmessages. Bij verbinding met een SQL Server met meerdere talen, specificeert Language welke set berichten voor de verbinding wordt gebruikt. |
| MARS_Connection | Met deze optie kunt u meerdere actieve resultatensets (MARS) in- of uitschakelen voor de verbinding. Erkende waarden zijn "ja" en "nee". De standaard is "nee". |
| MultiSubnetFailover | Specificeer altijd multiSubnetFailover=Yes wanneer je verbinding maakt met de availability group listener van een SQL Server availability group of een SQL Server Failover Cluster Instance.
multiSubnetFailover=Yes configureert SQL Server Native Client om snellere detectie en verbinding met de (huidige) actieve server te bieden. Mogelijke waarden zijn Ja en Nee. De standaardwaarde is Nee. Voorbeeld:MultiSubnetFailover=YesVoor meer informatie over de ondersteuning van SQL Server Native Client's voor Always On-beschikbaarheidsgroepen, zie SQL Server Native Client Support for High Availability, Disaster Recovery. |
| Net | Synoniem voor "netwerk". |
| Network | Geldige waarden zijn dbnmpntw (named pipes) en dbmssocn (TCP/IP). Het is een fout om zowel een waarde voor het netwerk-keyword als een protocolprefix op het Server-sleutelwoord te specificeren. |
| PWD | Het wachtwoord voor het SQL Server-inlogaccount is gespecificeerd in de UID-parameter.
PWD hoeft niet te worden gespecificeerd als de login een NULL-wachtwoord heeft of wanneer Windows-authenticatie wordt gebruikt (Trusted_Connection = yes). |
| QueryLog_On | Wanneer "ja" is, wordt het loggen van langlopende querygegevens ingeschakeld op de verbinding. Wanneer "nee", worden langlopende querygegevens niet gelogd. |
| QueryLogFile | Het volledige pad en de bestandsnaam van een bestand dat wordt gebruikt voor het vastleggen van gegevens op query's met een lange uitvoeringstijd. |
| QueryLogTime | Een tekenreeks met cijfers die de drempel (in milliseconden) voor het loggen van langlopende query's aangeeft. Elke query die geen antwoord krijgt binnen de opgegeven tijd, wordt geschreven naar het langlopende querylogbestand. |
| QuotedId | Wanneer "ja" QUOTED_IDENTIFIER wordt AAN gezet voor de verbinding, gebruikt SQL Server de ISO-regels met betrekking tot het gebruik van aanhalingstekens in SQL-instructies. Als dat niet is, QUOTED_IDENTIFIER is het UIT voor de verbinding. SQL Server volgt vervolgens de legacy Transact-SQL regels met betrekking tot het gebruik van aanhalingstekens in SQL-instructies. Voor meer informatie, zie Effecten van ISO-opties. |
| Regionaal | Wanneer "ja" is, gebruikt de SQL Server Native Client ODBC-driver clientinstellingen bij het omzetten van valuta-, datum- en tijdgegevens naar tekengegevens. De omzetting is slechts eenrichtingsverloop; de driver herkent niet-ODBC standaardformaten voor datumreeksen of valutawaarden binnenin niet; bijvoorbeeld een parameter die in een INSERT OF-verklaring UPDATE wordt gebruikt. Wanneer "nee" is, gebruikt de driver ODBC-standaardstrings om valuta-, datum- en tijdgegevens weer te geven die worden omgezet in tekengegevens. |
| SaveFile | Naam van een ODBC-gegevensbronbestand waarin de kenmerken van de huidige verbinding zijn opgeslagen als de verbinding tot stand is gebracht. |
| Server | 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. Het trefwoord Adres overschrijft het trefwoord Server . Je kunt verbinding maken met de standaardinstantie op de lokale server door een van de volgende op te geven: Server=; Server=.; Server=(lokaal); Server=(lokaal); Server=(localhost); Server=(localdb)\instancename; Voor meer informatie over LocalDB-ondersteuning, zie SQL Server Native Client Support voor LocalDB. 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. Het volgende is een voorbeeld van het specificeren van een benoemde pijp: np:\\.\pipe\MSSQL$MYINST01\sql\queryDeze regel specificeert het benoemde pipe-protocol, een benoemde pipe op de lokale machine ( \\.\pipe), de naam van de SQL Server-instantie (MSSQL$MYINST01), en de standaardnaam van de benoemde pipe (sql/query).Als noch een protocol noch het netwerk-sleutelwoord zijn opgegeven, zal SQL Server Native Client de protocolvolgorde gebruiken die in SQL Server Configuration Manager is gespecificeerd. poort is de poort waarmee verbinding moet worden gemaakt, op de opgegeven server. SQL Server maakt standaard gebruik van poort 1433. Ruimtes worden genegeerd aan het begin van de waarde die aan Server wordt doorgegeven in ODBC-verbindingsstrings wanneer SQL Server Native Client wordt gebruikt. |
| ServerSPN | De SPN voor de server. De standaardwaarde is een lege tekenreeks. Een lege string zorgt ervoor dat de SQL Server Native Client het standaard, door de driver gegenereerde SPN gebruikt. |
| StatsLog_On | Wanneer "ja", wordt het vastleggen van SQL Server Native Client ODBC-driverprestatiegegevens mogelijk. Wanneer "nee", zijn de prestatiegegevens van de SQL Server Native Client ODBC-driver niet beschikbaar op de verbinding. |
| StatsLogFile | Het volledige pad en de bestandsnaam van een bestand dat wordt gebruikt voor het opnemen van SQL Server Native Client ODBC-stuurprogramma prestatiestatistieken. |
| Trusted_Connection | Wanneer "ja", instrueert de SQL Server Native Client ODBC-driver om Windows Authentication Mode te gebruiken voor inlogvalidatie. Anders instrueert het de SQL Server Native Client ODBC-driver om een SQL Server-gebruikersnaam en wachtwoord te gebruiken voor inlogvalidatie, en de UID- en PWD-trefwoorden moeten worden gespecificeerd. |
| TrustServerCertificate | Wanneer gebruikt met Encrypt, maakt het encryptie mogelijk met een zelfondertekend servercertificaat. |
| UID | Een geldig SQL Server-loginaccount. UID hoeft niet gespecificeerd te worden bij gebruik van Windows Authentication. |
| UseProcForPrepare | Dit trefwoord is verouderd en de instelling ervan wordt genegeerd door de SQL Server Native Client ODBC Driver. |
| WSID | De werkstation-id. Meestal is dit de netwerknaam van de computer waarop de applicatie zich bevindt (optioneel). Indien gespecificeerd, wordt deze waarde opgeslagen in de hostnaam van de kolom master.dbo.sysprocesses en wordt deze teruggegeven door sp_who en de functie HOST_NAME. |
Opmerking
Regionale conversie-instellingen zijn van toepassing op valuta-, numeriek-, datum- en tijdgegevens. De conversie-instelling is alleen toepasbaar op uitvoerconversie en is alleen zichtbaar wanneer valuta-, numerieke, datum- of tijdwaarden worden omgezet naar tekenreeksen.
De SQL Server Native Client ODBC-driver gebruikt de lokale registerinstellingen van de huidige gebruiker. De driver respecteert de locatie van de huidige thread niet als de applicatie deze na de verbinding instelt door bijvoorbeeld SetThreadLocale aan te roepen.
Het veranderen van het regionale gedrag van een databron kan leiden tot applicatiefouten. Een applicatie die datumreeksen parseert en verwacht dat datumreeksen verschijnen zoals gedefinieerd door ODBC, kan nadelig worden beïnvloed door het wijzigen van deze waarde.
OLE DB Provider Connection String Sleutelwoorden
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 providerstrings worden ingesteld via DBPROP_INIT_PROVIDERSTRING waarden worden ingesteld met de waarden "ja" en "nee". Booleaanse eigenschappen die in initialisatiestrings worden gezet met IDataInitialize::GetDataSource worden ingesteld met de waarden "true" en "false".
Applicaties die IDataInitialize::GetDataSource gebruiken, kunnen ook de trefwoorden gebruiken die door IDBInitialize::Initialize worden gebruikt, maar alleen voor eigenschappen zonder standaardwaarde. 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 sterk aanbevolen dat applicaties IDBInitialize::Initialize keywords in IDataInitialize:GetDataSource verbindingsstrings niet gebruiken, aangezien dit gedrag mogelijk niet meer in toekomstige releases wordt behouden.
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 je bijvoorbeeld verbindingsreeks Data Source=server1 specificeert; Server=server2, Data Source wordt als property ingesteld, maar Server gaat dan in een providerstring.
Als u meerdere exemplaren van dezelfde providerspecifieke eigenschap opgeeft, wordt de eerste waarde van de eerste eigenschap gebruikt.
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-string
empty-string ::=
attribute ::= attribute-keyword=[{]attribute-value[}]
attribute-value ::= character-string
attribute-keyword ::= identifier
Attribuutwaarden kunnen optioneel worden omsloten door beugels, en het is goede praktijk om dit te doen. Dit voorkomt problemen wanneer attribuutwaarden niet-alfanumerieke tekens bevatten. De eerste sluitende crace in de waarde wordt verondersteld de waarde te beëindigen, dus waarden kunnen geen sluitende crace 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 een exemplaar van SQL Server in de organisatie. Voor meer informatie over geldige adressyntaxis, zie de beschrijving van het Address ODBC-sleutelwoord, later in dit onderwerp. |
| 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 standaard is ReadWrite. Voor meer informatie over de ondersteuning van SQL Server Native Client's voor Always On-beschikbaarheidsgroepen, zie SQL Server Native Client Support for High Availability, Disaster Recovery. |
| 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 was aangesloten, koppelt SQL Server deze niet opnieuw aan (het gebruikt de gekoppelde database als standaard voor de verbinding). |
| Automatisch vertalen | SSPROP_INIT_AUTOTRANSLATE | Synoniem voor "AutoTranslate". |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | Hiermee configureert u OEM/ANSI-tekenomzetting. Erkende waarden zijn "ja" en "nee". |
| 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 provider-datatypes en "80" voor SQL Server 2000-datatypes. |
| Coderen | SSPROP_INIT_ENCRYPT | Hiermee geeft u op of gegevens moeten worden versleuteld voordat ze via het netwerk worden verzonden. Mogelijke waarden zijn "ja" en "nee". De standaardwaarde is "nee". |
| 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 string zorgt ervoor dat de SQL Server Native Client het standaard, door de provider gegenereerde SPN gebruikt. |
| 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 "ja" en "nee". De standaardwaarde is "nee". |
| 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 | Pakketgrootte van het netwerk. De standaardwaarde is 4096. |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepteert de strings "ja" en "nee" als waarden. Wanneer "nee", mag het databronobject gevoelige authenticatiegegevens niet behouden |
| PWD | DBPROP_AUTH_PASSWORD | Het aanmeldingswachtwoord van SQL Server. |
| Server | 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. Voor meer informatie over geldige adressyntaxis, zie de beschrijving van het Server ODBC-sleutelwoord in dit onderwerp. |
| ServerSPN | SSPROP_INIT_SERVERSPN | De SPN voor de server. De standaardwaarde is een lege tekenreeks. Een lege string zorgt ervoor dat de SQL Server Native Client het standaard, door de provider gegenereerde SPN gebruikt. |
| Timeout | DBPROP_INIT_TIMEOUT | De hoeveelheid tijd (in seconden) die moet worden gewacht totdat de initialisatie van de gegevensbron is voltooid. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | Wanneer "ja", instrueert de SQL Server Native Client OLE DB-provider om Windows Authentication Mode te gebruiken voor inlogvalidatie. Anders instrueert hij de SQL Server Native Client OLE DB-provider om een SQL Server-gebruikersnaam en wachtwoord te gebruiken voor inlogvalidatie, en moeten de UID- en PWD-trefwoorden worden gespecificeerd. |
| TrustServerCertificate | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Accepteert de strings "ja" en "nee" als waarden. De standaardwaarde is "nee", wat betekent dat het servercertificaat gevalideerd zal worden. |
| UID | DBPROP_AUTH_USERID | De aanmeldingsnaam van SQL Server. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Dit trefwoord is verouderd en de instelling ervan wordt genegeerd door de SQL Server Native Client OLE DB Provider. |
| WSID | SSPROP_INIT_WSID | De werkstation-id. |
Verbindingsreeksen die worden gebruikt door OLE DB-toepassingen met behulp van IDataInitialize::GetDataSource hebben de volgende syntaxis:
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 ::= " | '
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. Het proberen te citeren van een geheel getal of geïntaleerde eigenschap resulteert in een fout "Connection String voldoet niet aan de OLE DB-specificatie".
Attribuutwaarden kunnen optioneel in enkele of dubbele aanhalingstekens worden geplaatst, en het is goede praktijk om dit te doen. Dit voorkomt problemen wanneer waarden niet-alfanumerieke tekens bevatten. Het gebruikte aanhalingsteken kan ook in waarden voorkomen, mits het verdubbeld 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 |
|---|---|---|
| Applicatienaam | SSPROP_INIT_APPNAME | De tekenreeks die de toepassing identificeert. |
| Toepassingsintentie | SSPROP_INIT_APPLICATIONINTENT | Synoniem voor "ApplicationIntent". |
| 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 standaard is ReadWrite. Voor meer informatie over de ondersteuning van SQL Server Native Client's voor Always On-beschikbaarheidsgroepen, zie SQL Server Native Client Support for High Availability, Disaster Recovery. |
| Automatisch vertalen | SSPROP_INIT_AUTOTRANSLATE | Synoniem voor "AutoTranslate". |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | Hiermee configureert u OEM/ANSI-tekenomzetting. Erkende waarden zijn "waar" en "onwaar". |
| Time-out verbinden | DBPROP_INIT_TIMEOUT | De hoeveelheid tijd (in seconden) die moet worden gewacht totdat de initialisatie van de gegevensbron is voltooid. |
| Huidige taal | SSPROP_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. Voor meer informatie over geldige adressyntaxis, zie de beschrijving van het Server ODBC-sleutelwoord, later in dit onderwerp. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Hiermee specificeert u de modus voor het verwerken van gegevenstypen. Herkende waarden zijn "0" voor provider-datatypes en "80" voor SQL Server 2000 (8.x) datatypes. |
| 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 string zorgt ervoor dat de SQL Server Native Client het standaard, door de provider gegenereerde SPN gebruikt. |
| 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. Om AttachDBFileName te gebruiken, moet je ook de databasenaam opgeven met het provider-string-sleutelwoord DATABASE . Als de database eerder was aangesloten, koppelt SQL Server deze niet opnieuw aan (het gebruikt de gekoppelde database als standaard voor de verbinding). |
| Geïntegreerde beveiliging | DBPROP_AUTH_INTEGRATED | Accepteert de waarde "SSPI" voor Windows-authenticatie. |
| MARS-verbinding | SSPROP_INIT_MARSCONNECTION | Met deze optie kunt u meerdere actieve resultatensets (MARS) in- of uitschakelen voor de verbinding. Erkende waarden zijn "waar" en "onwaar". De standaard is "vals". |
| Netwerkadres | SSPROP_INIT_NETWORKADDRESS | Het netwerkadres van een exemplaar van SQL Server in de organisatie. Voor meer informatie over geldige adressyntaxis, zie de beschrijving van het Address ODBC-sleutelwoord, later in dit onderwerp. |
| 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 | Pakketgrootte van het netwerk. De standaardwaarde is 4096. |
| Wachtwoord | DBPROP_AUTH_PASSWORD | Het aanmeldingswachtwoord van SQL Server. |
| Beveiligingsinformatie behouden | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepteert de strings "true" en "false" als waarden. Wanneer "onwaar", mag het databronobject gevoelige authenticatiegegevens niet behouden |
| Aanbieder | Voor SQL Server Native Client zou dit "SQLNCLI11" moeten zijn. | |
| Server SPN | SSPROP_INIT_SERVERSPN | De SPN voor de server. De standaardwaarde is een lege tekenreeks. Een lege string zorgt ervoor dat de SQL Server Native Client het standaard, door de provider gegenereerde SPN gebruikt. |
| Vertrouwensservercertificaat | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Accepteert de strings "true" en "false" als waarden. De standaardwaarde is "false", wat betekent dat het servercertificaat gevalideerd zal worden. |
| Gebruik encryptie voor data | SSPROP_INIT_ENCRYPT | Hiermee geeft u op of gegevens moeten worden versleuteld voordat ze via het netwerk worden verzonden. Mogelijke waarden zijn "waar" en "onwaar". De standaardwaarde is 'false'. |
| Gebruikers-ID | DBPROP_AUTH_USERID | De aanmeldingsnaam van SQL Server. |
| Werkstation-id | SSPROP_INIT_WSID | De werkstation-id. |
Noot In de verbindingsreeks stelt de eigenschap "Oud wachtwoord" SSPROP_AUTH_OLD_PASSWORD in, wat het huidige (mogelijk verlopen) wachtwoord is dat niet beschikbaar is via een provider-string-eigenschap.
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-applicaties kunnen ook de trefwoorden gebruiken die worden gebruikt door de OLE DB IDBInitialize::Initialize methode, 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 sterk aanbevolen dat applicaties alleen ADO verbindingsreeks-zoekwoorden gebruiken.
Verbindingsreeksen die door ADO worden gebruikt, hebben de volgende syntaxis:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=["]attribute-value["]
attribute-value ::= character-string
attribute-keyword ::= identifier
Attribuutwaarden kunnen optioneel in dubbele aanhalingstekens worden geplaatst, en het is goede praktijk om dit te doen. Dit voorkomt problemen wanneer waarden niet-alfanumerieke tekens bevatten. Attribuutwaarden kunnen geen dubbele aanhalingstekens bevatten.
In de volgende tabel worden de trefwoorden beschreven die kunnen worden gebruikt met een ADO-verbindingsreeks:
| Keyword | Initialisatie-eigenschap | Description |
|---|---|---|
| Toepassingsintentie | SSPROP_INIT_APPLICATIONINTENT | Synoniem voor "ApplicationIntent". |
| 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 standaard is ReadWrite. Voor meer informatie over de ondersteuning van SQL Server Native Client's voor Always On-beschikbaarheidsgroepen, zie SQL Server Native Client Support for High Availability, Disaster Recovery. |
| Applicatienaam | SSPROP_INIT_APPNAME | De tekenreeks die de toepassing identificeert. |
| Automatisch vertalen | SSPROP_INIT_AUTOTRANSLATE | Synoniem voor "AutoTranslate". |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | Hiermee configureert u OEM/ANSI-tekenomzetting. Erkende waarden zijn "waar" en "onwaar". |
| Time-out verbinden | DBPROP_INIT_TIMEOUT | De hoeveelheid tijd (in seconden) die moet worden gewacht totdat de initialisatie van de gegevensbron is voltooid. |
| Huidige taal | SSPROP_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. Voor meer informatie over geldige adressyntaxis, zie de beschrijving van het Server ODBC-sleutelwoord in dit onderwerp. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Specificeert de modus van verwerking van datatypen die wordt gebruikt. Herkende waarden zijn "0" voor provider-datatypes en "80" voor SQL Server 2000-datatypes. |
| 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 string zorgt ervoor dat de SQL Server Native Client het standaard, door de provider gegenereerde SPN gebruikt. |
| 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. Om AttachDBFileName te gebruiken, moet je ook de databasenaam opgeven met het provider-string-sleutelwoord DATABASE . Als de database eerder was aangesloten, koppelt SQL Server deze niet opnieuw aan (het gebruikt de gekoppelde database als standaard voor de verbinding). |
| Geïntegreerde beveiliging | DBPROP_AUTH_INTEGRATED | Accepteert de waarde "SSPI" voor Windows-authenticatie. |
| 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. Erkende waarden zijn "waar" en "onwaar". De standaard is "vals". |
| Netwerkadres | SSPROP_INIT_NETWORKADDRESS | Het netwerkadres van een exemplaar van SQL Server in de organisatie. Voor meer informatie over geldige adressyntaxis, zie de beschrijving van het Address ODBC-sleutelwoord in dit onderwerp. |
| 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 | Pakketgrootte van het netwerk. De standaardwaarde is 4096. |
| Wachtwoord | DBPROP_AUTH_PASSWORD | Het aanmeldingswachtwoord van SQL Server. |
| Beveiligingsinformatie behouden | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepteert de strings "true" en "false" als waarden. Wanneer "onwaar" is het databronobject niet toegestaan om gevoelige authenticatiegegevens te behouden. |
| Aanbieder | Voor SQL Server Native Client zou dit "SQLNCLI11" moeten zijn. | |
| Server SPN | SSPROP_INIT_SERVERSPN | De SPN voor de server. De standaardwaarde is een lege tekenreeks. Een lege string zorgt ervoor dat de SQL Server Native Client het standaard, door de provider gegenereerde SPN gebruikt. |
| Vertrouwensservercertificaat | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Accepteert de strings "true" en "false" als waarden. De standaardwaarde is "false", wat betekent dat het servercertificaat gevalideerd zal worden. |
| Gebruik encryptie voor data | SSPROP_INIT_ENCRYPT | Hiermee geeft u op of gegevens moeten worden versleuteld voordat ze via het netwerk worden verzonden. Mogelijke waarden zijn "waar" en "onwaar". De standaardwaarde is 'false'. |
| Gebruikers-ID | DBPROP_AUTH_USERID | De aanmeldingsnaam van SQL Server. |
| Werkstation-id | SSPROP_INIT_WSID | De werkstation-id. |
Opmerking
In de verbindingsreeks stelt de eigenschap "Oud wachtwoord" SSPROP_AUTH_OLD_PASSWORD in, wat het huidige (mogelijk verlopen) wachtwoord is dat niet beschikbaar is via een provider-string-eigenschap.