Verwenden von Verbindungszeichenfolgen-Schlüsselwörtern mit dem OLE DB-Treiber für SQL Server
Gilt für:
SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Einige APIs im OLE DB-Treiber für SQL Server verwenden Verbindungszeichenfolgen, um Verbindungsattribute anzugeben. Verbindungszeichenfolgen sind Listen von Schlüsselwörtern und zugehörigen Werten. Jedes Schlüsselwort bezeichnet ein spezielles Verbindungsattribut.
Hinweis
Der OLE DB-Treiber für SQL Server lässt aus Gründen der Abwärtskompatibilität Mehrdeutigkeit in Verbindungszeichenfolgen zu. Einige Schlüsselwörter können also beispielsweise mehrmals angegeben werden, und Konflikt verursachende Schlüsselwörter sind unter Umständen zulässig, wenn Konflikte anhand der Position oder Rangfolge aufgelöst werden. Zukünftige Versionen des OLE DB-Treibers für SQL Server lassen möglicherweise keine Mehrdeutigkeit in Verbindungszeichenfolgen zu. Beim Ändern von Anwendungen hat es sich bewährt, den OLE DB-Treiber für SQL Server zu verwenden, um eine Abhängigkeit von der Mehrdeutigkeit von Verbindungszeichenfolgen zu vermeiden.
In den folgenden Abschnitten werden die Schlüsselwörter beschrieben, die mit dem OLE DB-Treiber für SQL Server und ADO (ActiveX Data Objects) verwendet werden können, wenn der OLE DB-Treiber für SQL Server als Datenanbieter verwendet wird.
Verbindungszeichenfolgen-Schlüsselwörter für den OLE DB-Treiber
OLE DB-Anwendungen können Datenquellenobjekte auf zweierlei Weise initialisieren:
IDBInitialize::Initialize
IDataInitialize::GetDataSource
Im ersten Fall kann die Anbieterzeichenfolge zum Initialisieren der Verbindungseigenschaften verwendet werden, indem die DBPROP_INIT_PROVIDERSTRING-Eigenschaft im DBPROPSET_DBINIT-Eigenschaftensatz festgelegt wird. Im zweiten Fall kann eine Initialisierungszeichenfolge an die IDataInitialize::GetDataSource-Methode übergeben werden, um die Verbindungseigenschaften zu initialisieren. Beide Methoden initialisieren die gleichen OLE DB-Verbindungseigenschaften, es werden jedoch andere Sätze von Schlüsselwörtern verwendet. Die von IDataInitialize::GetDataSource verwendeten Schlüsselwörter entsprechen mindestens der Beschreibung der in der Gruppe der Initialisierungseigenschaften enthaltenen Eigenschaften.
Bei jeder Anbieterzeichenfolgeneinstellung, für die eine zugehörige OLE DB-Eigenschaft vorhanden ist, die auf einen bestimmten Standardwert festgelegt ist oder auf einen spezifischen Wert festgelegt wird, überschreibt der OLE DB-Eigenschaftswert die Einstellung in der Anbieterzeichenfolge.
Für boolesche Eigenschaften, die in Anbieterzeichenfolgen über DBPROP_INIT_PROVIDERSTRING-Werte festgelegt werden, werden die Werte yes und no angegeben. Für boolesche Eigenschaften, die in Initialisierungszeichenfolgen über IDataInitialize::GetDataSource festgelegt werden, werden die Werte true und false angegeben.
In Anwendungen, in denen IDataInitialize::GetDataSource verwendet wird, können auch die Schlüsselwörter für IDBInitialize::Initialize verwendet werden, allerdings nur für Eigenschaften, die über keinen Standardwert verfügen. Wenn eine Anwendung sowohl das IDataInitialize::GetDataSource-Schlüsselwort als auch das IDBInitialize::Initialize-Schlüsselwort in der Initialisierungszeichenfolge angibt, dann wird die IDataInitialize::GetDataSource-Schlüsselworteinstellung verwendet. Es wird empfohlen, dass Anwendungen keine IDBInitialize::Initialize-Schlüsselwörter in IDataInitialize:GetDataSource-Verbindungszeichenfolgen verwenden, da dieses Verhalten in künftigen Releases möglicherweise nicht beibehalten wird.
Hinweis
Eine von IDataInitialize::GetDataSource übergebene Verbindungszeichenfolge wird in Eigenschaften konvertiert und mithilfe von IDBProperties::SetProperties angewendet. Wenn Komponentendienste die Eigenschaftenbeschreibung in IDBProperties::GetPropertyInfo gefunden haben, wird diese Eigenschaft als eigenständige Eigenschaft angewendet. Andernfalls wird sie mithilfe der DBPROP_PROVIDERSTRING-Eigenschaft angewendet. Wenn Sie z. B. die Verbindungszeichenfolge Data Source=server1;Server=server2 angeben, wird Data Source als Eigenschaft festgelegt, aber Server wird in einer Anbieterzeichenfolge verwendet.
Wenn Sie mehrere Instanzen einer anbieterspezifischen Eigenschaft angeben, wird der erste Wert der ersten Eigenschaft verwendet.
IDBInitialize::Initialize verwenden
Für Verbindungszeichenfolgen, die in OLE DB-Anwendungen unter Verwendung von DBPROP_INIT_PROVIDERSTRING mit IDBInitialize::Initialize verwendet werden, gilt die folgende Syntax:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
Attributwerte können optional in geschweifte Klammern eingeschlossen werden, und es wird empfohlen, dies zu tun. Dadurch werden Probleme vermieden, wenn Attributwerte nicht alphanumerische Zeichen enthalten. Da die erste schließende geschweifte Klammer als Endzeichen des Werts interpretiert wird, können Werte keine schließenden geschweiften Klammern enthalten.
Ein Leerzeichen nach dem Zeichen = eines Verbindungszeichenfolgen-Schlüsselworts wird als Literal interpretiert. Dies gilt auch, wenn der Wert in Anführungszeichen gesetzt ist.
In der folgenden Tabelle werden die Schlüsselwörter beschrieben, die mit DBPROP_INIT_PROVIDERSTRING verwendet werden können.
| Schlüsselwort | Initialisierungseigenschaft | BESCHREIBUNG |
|---|---|---|
| Addr | SSPROP_INIT_NETWORKADDRESS | Synonym für Address |
| Adresse | SSPROP_INIT_NETWORKADDRESS | Die Netzwerkadresse des Servers, auf dem eine Instanz von SQL Server ausgeführt wird. Address ist normalerweise der Netzwerkname des Servers, kann jedoch auch ein anderer Name sein, beispielsweise der einer Pipe, einer IP-Adresse oder eines TCP/IP-Ports und einer Socketadresse. Wenn Sie eine IP-Adresse angeben, stellen Sie im SQL Server-Konfigurations-Manager sicher, dass die Protokolle für TCP/IP oder Named Pipes aktiviert sind. Der Wert von Address hat Vorrang vor dem in Verbindungszeichenfolgen an Server übergebenen Wert, wenn der OLE DB-Treiber für SQL Server verwendet wird. Zudem ist zu beachten, dass mit der Angabe Address=; eine Verbindung mit dem im Server-Schlüsselwort angegebenen Server hergestellt wird. Die Angaben Address= ;, Address=.;, Address=localhost; und Address=(local); führen dagegen zu einer Verbindungsherstellung mit dem lokalen Server.Die vollständige Syntax für das Address-Schlüsselwort ist folgendermaßen: [protocol:]Address[,port |\pipe\pipename] Protokoll kann Folgendes sein: tcp (TCP/IP), lpc (Shared Memory) oder np (Named Pipes). Weitere Informationen zu Protokollen finden Sie unter Konfigurieren von Clientprotokollen. Wenn weder das Protokoll noch das Schlüsselwort Network angegeben wird, verwendet der OLE DB-Treiber für SQL Server die in SQL Server Configuration Manager angegebene Protokollreihenfolge. port gibt den Port auf dem angegebenen Server an, zu dem eine Verbindung hergestellt werden soll. In der Standardeinstellung verwendet SQL Server den Port 1433. |
| APP | SSPROP_INIT_APPNAME | Die Zeichenfolge, die die Anwendung identifiziert. |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | Deklariert den Arbeitsauslastungstyp der Anwendung beim Herstellen einer Verbindung mit einem Server. Mögliche Werte sind ReadOnly und ReadWrite.Der Standardwert lautet ReadWrite. Weitere Informationen zur OLE DB-Treiber für SQL Server-Unterstützung für Always On-Verfügbarkeitsgruppen finden Sie unter OLE DB-Treiber für SQL Server-Unterstützung für Hochverfügbarkeit, Notfallwiederherstellung. |
| AttachDBFileName | SSPROP_INIT_FILENAME | Der Name der Primärdatenbank (einschließlich des vollständigen Pfadnamens) einer anfügbaren Datenbank. Für die Verwendung von AttachDBFileName muss auch der Datenbankname mit dem Schlüsselwort „Database“ für die Anbieterzeichenfolge angegeben werden. Wenn die Datenbank bereits angefügt war, fügt SQL Server sie nicht noch mal an (die angefügte Datenbank wird standardmäßig für die Verbindung verwendet). |
| Authentication1 | SSPROP_AUTH_MODE | Gibt die verwendete SQL oder Microsoft Entra-Authentifizierung an. Gültige Werte sind:
HINWEIS: Das Schlüsselwort ActiveDirectoryIntegrated kann auch für die Windows-Authentifizierung gegenüber SQL Server verwendet werden. Es ersetzt die Authentifizierungsschlüsselwörter Integrated Security (oder Trusted_Connection). Es wird empfohlen, dass Anwendungen mit Verwendung der Schlüsselwörter Integrated Security (oder Trusted_Connection) der zugehörigen Eigenschaften den Wert des Schlüsselwerts Authentication (oder der zugehörigen Eigenschaft) auf ActiveDirectoryIntegrated festlegen, um ein neues Verhalten für Verschlüsselung und Zertifikatvalidierung zu aktivieren.HINWEIS: Es wird empfohlen, dass Anwendungen mit Verwendung des Authentifizierungssatzes SQL Server den Wert des Schlüsselwerts Authentication (oder der zugehörigen Eigenschaft) auf SqlPassword festlegen, um ein neues Verhalten für Verschlüsselung und Zertifikatvalidierung zu aktivieren. |
| Automatisches Übersetzen | SSPROP_INIT_AUTOTRANSLATE | Synonym für AutoTranslate |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | Konfiguriert die OEM-/ANSI-Zeichenübersetzung. Gültige Werte sind yes und no. |
| ConnectRetryCount | SSPROP_INIT_CONNECT_RETRY_COUNT | Steuert die Anzahl der erneuten Versuche zur Verbindungsherstellung bei einem Verbindungsverlust. Gültige Werte reichen von 0 bis 255. Standardwert: 1. Ein Wert von 0 bedeutet, dass kein erneuter Verbindungsversuch unternommen wird. Weitere Informationen finden Sie unter Resilienz bei Verbindungen im Leerlauf. |
| ConnectRetryInterval | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Gibt die Anzahl der Sekunden zwischen den erneuten Versuchen zur Verbindungsherstellung im Falle eines Verbindungsverlusts an. Gültige Werte reichen von 1 bis 60. Standardwert: 10. Weitere Informationen finden Sie unter Resilienz bei Verbindungen im Leerlauf. |
| Datenbank | DBPROP_INIT_CATALOG | Der Datenbankname. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Gibt den Modus der zu verwendenden Datentypbehandlung an. Zulässig sind der Wert 0 für Anbieterdatentypen und der Wert 80 für SQL Server 2000-Datentypen. |
| Encrypt1 | SSPROP_INIT_ENCRYPT | Gibt an, ob Daten vor dem Senden über das Netzwerk verschlüsselt werden sollen. Mögliche Werte sind Optional, Mandatory und Strict. Standardwert: Mandatory. Informationen zu 18.x.x-Versionen finden Sie unter Hauptversionsunterschiede für MSOLEDBSQL. |
| FailoverPartner | SSPROP_INIT_FAILOVERPARTNER | Der Name des für die Datenbankspiegelung zu verwendenden Failoverservers. |
| FailoverPartnerSPN | SSPROP_INIT_FAILOVERPARTNERSPN | Der SPN für den Failoverpartner. Der Standardwert ist eine leere Zeichenfolge. Eine leere Zeichenfolge bewirkt, dass der OLE DB-Treiber für SQL Server den vorgegebenen, vom Anbieter generierten SPN verwendet. |
| HostNameInCertificate | SSPROP_INIT_HOST_NAME_CERTIFICATE | Der Hostname, der beim Überprüfen des TLS/SSL-Zertifikats von SQL Server verwendet werden soll. Wird das Schlüsselwort Hostname im Zertifikat nicht festgelegt, verwendet der Treiber den Wert des Schlüsselworts Server in der Verbindungs-URL als Hostnamen, um das TLS/SSL-Zertifikat von SQL Server zu überprüfen. HINWEIS: Diese Eigenschaft wird ignoriert, wenn das Serverzertifikat vertrauenswürdig ist. Wenn Verschlüsseln auf Strict festgelegt ist, wird das Zertifikat immer überprüft. |
| Sprache | SSPROP_INIT_CURRENTLANGUAGE | Die SQL Server-Sprache. |
| MarsConn | SSPROP_INIT_MARSCONNECTION | Ermöglicht oder unterbindet die Verwendung von mehreren aktiven Resultsets (MARS) bei einer Verbindung, wenn auf dem Server SQL Server 2005 (9.x) oder höher ausgeführt wird. Mögliche Werte sind yes und no. Standardwert: no. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Geben Sie immer MultiSubnetFailover=Yes an, wenn Sie eine Verbindung mit dem Verfügbarkeitsgruppenlistener einer SQL Server-Verfügbarkeitsgruppe oder einer SQL Server-Failoverclusterinstanz herstellen. MultiSubnetFailover=Yes konfiguriert den OLE DB-Treiber für SQL Server, um eine schnellere Erkennung sowie die Verbindung zu dem (gerade) aktiven Server zu gewährleisten. Mögliche Werte sind Yes und No. Der Standardwert lautet No. Beispiel:MultiSubnetFailover=YesWeitere Informationen zur OLE DB-Treiber für SQL Server-Unterstützung für Always On-Verfügbarkeitsgruppen finden Sie unter OLE DB-Treiber für SQL Server-Unterstützung für Hochverfügbarkeit, Notfallwiederherstellung. |
| Net | SSPROP_INIT_NETWORKLIBRARY | Synonym für Network |
| Network | SSPROP_INIT_NETWORKLIBRARY | Die Netzwerkbibliothek, die zum Herstellen einer Verbindung mit einer Instanz von SQL Server in der Organisation verwendet wird. |
| Network Library | SSPROP_INIT_NETWORKLIBRARY | Synonym für Network |
| PacketSize | SSPROP_INIT_PACKETSIZE | Dies ist die TDS-Paketgröße (Tabular Data Stream). Der Standardwert ist 0, der tatsächliche Wert wird vom Server bestimmt. |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Bei diesem Schlüsselwort werden die Zeichenfolgen yes und no als Werte akzeptiert. Bei no darf das Datenquellenobjekt vertrauliche Authentifizierungsinformationen nicht dauerhaft speichern. |
| PWD | DBPROP_AUTH_PASSWORD | Das Anmeldekennwort für SQL Server. |
| Server | DBPROP_INIT_DATASOURCE | Der Name einer SQL Server-Instanz. Als Wert muss entweder der Name eines Servers im Netzwerk, eine IP-Adresse oder der Aliasname eines SQL Server-Konfigurations-Managers angegeben werden. Ohne Angabe eines Namens wird eine Verbindung mit der Standardinstanz auf dem lokalen Computer hergestellt. Das Address-Schlüsselwort setzt das Server-Schlüsselwort außer Kraft. Geben Sie eine der folgenden Optionen an, um eine Verbindung mit der Standardinstanz auf dem lokalen Server herzustellen: Server=.; Server=.; Server=(local); Server=(local); Server=(localhost); Server=(localdb)\instancename; Weitere Informationen zur LocalDB-Unterstützung finden Sie unter OLE DB-Treiber für SQL Server-Unterstützung für LocalDB. Um eine benannte Instanz von SQL Server anzugeben, fügen Sie \Instanzname an. Ohne Angabe eines Servers wird eine Verbindung mit der Standardinstanz auf dem lokalen Computer hergestellt. Wenn Sie eine IP-Adresse angeben, stellen Sie im SQL Server-Konfigurations-Manager sicher, dass die Protokolle für TCP/IP oder Named Pipes aktiviert sind. Die vollständige Syntax für das Server-Schlüsselwort ist folgendermaßen: Server= [Protokoll: ]Server[ ,Port] Protokoll kann Folgendes sein: tcp (TCP/IP), lpc (Shared Memory) oder np (Named Pipes). Im folgenden Beispiel wird eine Named Pipe angegeben: np:\\.\pipe\MSSQL$MYINST01\sql\queryDiese Zeile gibt das Named Pipe-Protokoll ( np), eine Named Pipe auf dem lokalen Computer (\\.\pipe), den Namen der SQL Server-Instanz (MSSQL$MYINST01) und den Standardnamen der Named Pipe (sql/query) an.Wenn weder ein Protokoll noch das Schlüsselwort Network angegeben wird, verwendet der OLE DB-Treiber für SQL Server die in SQL Server Configuration Manager angegebene Protokollreihenfolge. port gibt den Port auf dem angegebenen Server an, zu dem eine Verbindung hergestellt werden soll. In der Standardeinstellung verwendet SQL Server den Port 1433. Bei Verwendung des OLE DB-Treibers für SQL Server werden Leerzeichen am Anfang des an Server übergebenen Werts in Verbindungszeichenfolgen ignoriert. |
| ServerCertificate | SSPROP_INIT_SERVER_CERTIFICATE | Gibt den Pfad zu einer Zertifikatdatei an, die mit dem TLS-/SSL-Zertifikat von SQL Server abgeglichen werden soll. Diese Option kann nur verwendet werden, wenn die Strict-Verschlüsselung aktiviert ist. Die akzeptierten Zertifikatformate sind PEM, DER und CER. Wenn angegeben, wird das SQL Server-Zertifikat überprüft, indem festgestellt wird, ob das bereitgestellte Zertifikat eine exakte Übereinstimmung ist. |
| ServerSPN | SSPROP_INIT_SERVERSPN | Der SPN für den Server. Der Standardwert ist eine leere Zeichenfolge. Eine leere Zeichenfolge bewirkt, dass der OLE DB-Treiber für SQL Server den vorgegebenen, vom Anbieter generierten SPN verwendet. |
| Timeout | DBPROP_INIT_TIMEOUT | Der Zeitraum (in Sekunden), der bis zum Abschluss der Datenquelleninitialisierung abgewartet werden soll. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Wirkt sich auf die Verbindungssequenz aus, wenn die erste aufgelöste IP-Adresse des Hostnamens nicht reagiert und dem Hostnamen mehrere IP-Adressen zugeordnet sind. TNIR interagiert mit MultiSubnetFailover, um verschiedene Verbindungssequenzen bereitzustellen. Mögliche Werte sind Yes und No. Standardwert: Yes. Weitere Informationen finden Sie unter Verwenden der transparenten Netzwerk-IP-Adressauflösung. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | Bei yes wird der OLE DB-Treiber für SQL Server angewiesen, zur Überprüfung der Anmeldung die Windows-Authentifizierung zu verwenden. Andernfalls verwendet der OLE DB-Treiber für SQL Server einen SQL Server-Benutzernamen und ein Kennwort zur Überprüfung der Anmeldung. In diesem Fall müssen die Schlüsselwörter UID und PWD angegeben werden. |
| TrustServerCertificate1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Bei diesem Schlüsselwort werden die Zeichenfolgen yes und no als Werte akzeptiert. Der Standardwert lautet no und bedeutet, dass das Serverzertifikat überprüft wird. |
| UID | DBPROP_AUTH_USERID | Der SQL Server-Anmeldename. |
| UseFMTONLY | SSPROP_INIT_USEFMTONLY | Steuert, wie Metadaten abgerufen wird, wenn eine Verbindung mit SQL Server 2012 (11.x) und höher hergestellt wird. Mögliche Werte sind yes und no. Standardwert: no.Standardmäßig verwendet der OLE DB-Treiber für SQL Server die gespeicherten Prozeduren sp_describe_first_result_set und sp_describe_undeclared_parameters, um Metadaten abzurufen. Für diese gespeicherten Prozeduren gelten einige Einschränkungen (beispielsweise treten bei der Verwendung für temporäre Tabellen Fehler auf). Durch die Festlegung von UseFMTONLY auf yes wird der Treiber angewiesen, für den Abruf von Metadaten stattdessen SET FMTONLY zu verwenden. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Dieses Schlüsselwort ist veraltet, und seine Festlegung wird vom OLE DB-Treiber für SQL Server ignoriert. |
| WSID | SSPROP_INIT_WSID | Der Bezeichner der Arbeitsstation. |
[1]: Zur Verbesserung der Sicherheit wird bei der Verwendung von Eigenschaften für die Authentifizierungs-/Zugriffstokeninitialisierung oder der entsprechenden Verbindungszeichenfolgen-Schlüsselwörter das Verschlüsselungs- und Zertifikatüberprüfungsverhalten geändert. Weitere Informationen finden Sie unter Verschlüsselung und Zertifikatüberprüfung.
IDataInitialize::GetDataSource verwenden
Verbindungszeichenfolgen, die von OLE DB-Anwendungen verwendet werden, welche IDataInitialize::GetDataSource verwenden, haben die folgende Syntax:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
Die Verwendung von Eigenschaften muss der jeweils dafür zulässigen Syntax entsprechen. Beispielsweise verwendet WSID geschweifte Klammern ( {} ) als Anführungszeichen, und Application Name verwendet einfache ( ' ) oder doppelte ( " ) Anführungszeichen. Es können nur Zeichenfolgeneigenschaften in Anführungszeichen gesetzt werden. Wenn Sie versuchen, einen Integer oder eine aufgezählte Eigenschaft in Anführungszeichen zu setzen, führt dies zu folgender Fehlermeldung: Connection String doesn't conform to OLE DB specification (Verbindungszeichenfolge entspricht nicht der OLE DB-Spezifikation).
Es wird empfohlen, Attributwerte in einfache oder doppelte Anführungszeichen zu setzen. Dadurch werden Probleme vermieden, wenn Werte nicht alphanumerische Zeichen enthalten. Werte dürfen auch Zeichen in Anführungszeichen enthalten, sofern es sich dabei um doppelte Anführungszeichen handelt.
Ein Leerzeichen nach dem Gleichheitszeichen (=) eines Verbindungszeichenfolgen-Schlüsselworts wird als Literal interpretiert. Dies gilt auch, wenn der Wert in Anführungszeichen gesetzt ist.
Wenn eine Verbindungszeichenfolge mehrere der in der folgenden Tabelle aufgeführten Eigenschaften aufweist, wird der Wert der letzten Eigenschaft verwendet.
In der folgenden Tabelle werden die Schlüsselwörter beschrieben, die mit IDataInitialize::GetDataSource verwendet werden können:
| Schlüsselwort | Initialisierungseigenschaft | BESCHREIBUNG |
|---|---|---|
| Access Token1 | SSPROP_AUTH_ACCESS_TOKEN | Das für die Authentifizierung bei Microsoft Entra ID verwendete Zugriffstoken. HINWEIS: Es ist ein Fehler, dieses Schlüsselwort und auch die Schlüsselwörter UID, PWD, Trusted_Connection oder Authentication für Verbindungszeichenfolgen oder die entsprechenden Eigenschaften/Schlüsselwörter anzugeben. |
| Anwendungsname | SSPROP_INIT_APPNAME | Die Zeichenfolge, die die Anwendung identifiziert. |
| Application Intent | SSPROP_INIT_APPLICATIONINTENT | Deklariert den Arbeitsauslastungstyp der Anwendung beim Herstellen einer Verbindung mit einem Server. Mögliche Werte sind ReadOnly und ReadWrite.Der Standardwert lautet ReadWrite. Weitere Informationen zur OLE DB-Treiber für SQL Server-Unterstützung für Always On-Verfügbarkeitsgruppen finden Sie unter OLE DB-Treiber für SQL Server-Unterstützung für Hochverfügbarkeit, Notfallwiederherstellung. |
| Authentication1 | SSPROP_AUTH_MODE | Gibt die verwendete SQL oder Microsoft Entra-Authentifizierung an. Gültige Werte sind:
HINWEIS: Das Schlüsselwort ActiveDirectoryIntegrated kann auch für die Windows-Authentifizierung gegenüber SQL Server verwendet werden. Es ersetzt die Authentifizierungsschlüsselwörter Integrated Security (oder Trusted_Connection). Es wird empfohlen, dass Anwendungen mit Verwendung der Schlüsselwörter Integrated Security (oder Trusted_Connection) der zugehörigen Eigenschaften den Wert des Schlüsselwerts Authentication (oder der zugehörigen Eigenschaft) auf ActiveDirectoryIntegrated festlegen, um ein neues Verhalten für Verschlüsselung und Zertifikatvalidierung zu aktivieren.HINWEIS: Es wird empfohlen, dass Anwendungen mit Verwendung des Authentifizierungssatzes SQL Server den Wert des Schlüsselwerts Authentication (oder der zugehörigen Eigenschaft) auf SqlPassword festlegen, um ein neues Verhalten für Verschlüsselung und Zertifikatvalidierung zu aktivieren. |
| Automatisches Übersetzen | SSPROP_INIT_AUTOTRANSLATE | Konfiguriert die OEM-/ANSI-Zeichenübersetzung. Gültige Werte sind true und false. |
| Connect Timeout | DBPROP_INIT_TIMEOUT | Der Zeitraum (in Sekunden), der bis zum Abschluss der Datenquelleninitialisierung abgewartet werden soll. |
| Connect Retry Count (Anzahl der Verbindungsversuche) | SSPROP_INIT_CONNECT_RETRY_COUNT | Steuert die Anzahl der erneuten Versuche zur Verbindungsherstellung bei einem Verbindungsverlust. Gültige Werte reichen von 0 bis 255. Standardwert: 1. Ein Wert von 0 bedeutet, dass kein erneuter Verbindungsversuch unternommen wird. Weitere Informationen finden Sie unter Resilienz bei Verbindungen im Leerlauf. |
| Connect Retry Interval (Verbindungswiederholungsintervall) | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Gibt die Anzahl der Sekunden zwischen den erneuten Versuchen zur Verbindungsherstellung im Falle eines Verbindungsverlusts an. Gültige Werte reichen von 1 bis 60. Standardwert: 10. Weitere Informationen finden Sie unter Resilienz bei Verbindungen im Leerlauf. |
| Current Language | SSPROPT_INIT_CURRENTLANGUAGE | Der SQL Server-Sprachenname. |
| Data Source | DBPROP_INIT_DATASOURCE | Der Name einer SQL Server-Instanz in der Organisation. Ohne Angabe eines Namens wird eine Verbindung mit der Standardinstanz auf dem lokalen Computer hergestellt. Weitere Informationen zur Syntax einer gültigen Adresse finden Sie in der Beschreibung des Schlüsselworts Server in diesem Artikel. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Gibt den Modus der zu verwendenden Datentypbehandlung an. Zulässig sind der Wert 0 für Anbieterdatentypen und der Wert 80 für SQL Server 2000 (8.x)-Datentypen. |
| Failoverpartner | SSPROP_INIT_FAILOVERPARTNER | Der Name des für die Datenbankspiegelung zu verwendenden Failoverservers. |
| Failover Partner SPN | SSPROP_INIT_FAILOVERPARTNERSPN | Der SPN für den Failoverpartner. Der Standardwert ist eine leere Zeichenfolge. Eine leere Zeichenfolge bewirkt, dass der OLE DB-Treiber für SQL Server den vorgegebenen, vom Anbieter generierten SPN verwendet. |
| Hostname im Zertifikat | SSPROP_INIT_HOST_NAME_CERTIFICATE | Der Hostname, der beim Überprüfen des TLS/SSL-Zertifikats von SQL Server verwendet werden soll. Wird das Schlüsselwort Hostname im Zertifikat nicht festgelegt, verwendet der Treiber den Wert des Schlüsselworts Datenquelle in der Verbindungs-URL als Hostnamen, um das TLS/SSL-Zertifikat von SQL Server zu überprüfen. HINWEIS: Diese Eigenschaft wird ignoriert, wenn das Serverzertifikat vertrauenswürdig ist. Wenn Verschlüsselung für Daten verwenden auf Strict festgelegt ist, wird das Zertifikat immer überprüft. |
| Anfangskatalog | DBPROP_INIT_CATALOG | Der Datenbankname. |
| Anfangsdateiname | SSPROP_INIT_FILENAME | Der Name der Primärdatenbank (einschließlich des vollständigen Pfadnamens) einer anfügbaren Datenbank. Für die Verwendung von AttachDBFileName muss auch der Datenbankname mit dem Schlüsselwort DATABASE für die Anbieterzeichenfolge angegeben werden. Wenn die Datenbank bereits angefügt war, fügt SQL Server sie nicht noch mal an (die angefügte Datenbank wird standardmäßig für die Verbindung verwendet). |
| Integrierte Sicherheit | DBPROP_AUTH_INTEGRATED | Akzeptiert den Wert SSPI für die Windows-Authentifizierung |
| MARS-Verbindung | SSPROP_INIT_MARSCONNECTION | Ermöglicht oder unterbindet die Verwendung von mehreren aktiven Resultsets (MARS) bei einer Verbindung. Gültige Werte sind true und false. Der Standardwert lautet false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Geben Sie immer MultiSubnetFailover=True an, wenn Sie eine Verbindung mit dem Verfügbarkeitsgruppenlistener einer SQL Server-Verfügbarkeitsgruppe oder einer SQL Server-Failoverclusterinstanz herstellen. MultiSubnetFailover=TRUE konfiguriert den OLE DB-Treiber für SQL Server so, dass der (derzeit) aktive Server schneller erkannt und eine Verbindung zu ihm hergestellt wird. Mögliche Werte sind True und False. Der Standardwert lautet False. Beispiel:MultiSubnetFailover=TrueWeitere Informationen zur OLE DB-Treiber für SQL Server-Unterstützung für Always On-Verfügbarkeitsgruppen finden Sie unter OLE DB-Treiber für SQL Server-Unterstützung für Hochverfügbarkeit, Notfallwiederherstellung. |
| Network Address | SSPROP_INIT_NETWORKADDRESS | Die Netzwerkadresse einer Instanz von SQL Server in der Organisation. Weitere Informationen zur Syntax einer gültigen Adresse finden Sie in der Beschreibung des Schlüsselworts Adresse in diesem Artikel. |
| Network Library | SSPROP_INIT_NETWORKLIBRARY | Die Netzwerkbibliothek, die zum Herstellen einer Verbindung mit einer Instanz von SQL Server in der Organisation verwendet wird. |
| Packet Size | SSPROP_INIT_PACKETSIZE | Dies ist die TDS-Paketgröße (Tabular Data Stream). Der Standardwert ist 0, der tatsächliche Wert wird vom Server bestimmt. |
| Kennwort | DBPROP_AUTH_PASSWORD | Das Anmeldekennwort für SQL Server. |
| Persist Security Info | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Bei diesem Schlüsselwort werden die Zeichenfolgen true und false als Werte akzeptiert. Bei false darf das Datenquellenobjekt vertrauliche Authentifizierungsinformationen nicht dauerhaft speichern. |
| Anbieter | Für den OLE DB-Treiber für SQL Server sollte dieser Wert „MSOLEDBSQL19“ oder „MSOLEDBSQL“ lauten. | |
| Serverzertifikat | SSPROP_INIT_SERVER_CERTIFICATE | Gibt den Pfad zu einer Zertifikatdatei an, die mit dem TLS-/SSL-Zertifikat von SQL Server abgeglichen werden soll. Diese Option kann nur verwendet werden, wenn die Strict-Verschlüsselung aktiviert ist. Die akzeptierten Zertifikatformate sind PEM, DER und CER. Wenn angegeben, wird das SQL Server-Zertifikat überprüft, indem festgestellt wird, ob das bereitgestellte Zertifikat eine exakte Übereinstimmung ist. |
| Server SPN | SSPROP_INIT_SERVERSPN | Der SPN für den Server. Der Standardwert ist eine leere Zeichenfolge. Eine leere Zeichenfolge bewirkt, dass der OLE DB-Treiber für SQL Server den vorgegebenen, vom Anbieter generierten SPN verwendet. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Wirkt sich auf die Verbindungssequenz aus, wenn die erste aufgelöste IP-Adresse des Hostnamens nicht reagiert und dem Hostnamen mehrere IP-Adressen zugeordnet sind. TNIR interagiert mit MultiSubnetFailover, um verschiedene Verbindungssequenzen bereitzustellen. Mögliche Werte sind True und False. Standardwert: True. Weitere Informationen finden Sie unter Verwenden der transparenten Netzwerk-IP-Adressauflösung. |
| Trust Server Certificate1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Bei diesem Schlüsselwort werden die Zeichenfolgen true und false als Werte akzeptiert. Der Standardwert lautet false und bedeutet, dass das Serverzertifikat überprüft wird. |
| Use Encryption for Data1 | SSPROP_INIT_ENCRYPT | Gibt an, ob Daten vor dem Senden über das Netzwerk verschlüsselt werden sollen. Mögliche Werte sind Optional, Mandatory und Strict. Standardwert: Mandatory. Informationen zu 18.x.x-Versionen finden Sie unter Hauptversionsunterschiede für MSOLEDBSQL. |
| Use FMTONLY | SSPROP_INIT_USEFMTONLY | Steuert, wie Metadaten abgerufen wird, wenn eine Verbindung mit SQL Server 2012 (11.x) und höher hergestellt wird. Mögliche Werte sind true und false. Standardwert: false.Standardmäßig verwendet der OLE DB-Treiber für SQL Server die gespeicherten Prozeduren sp_describe_first_result_set und sp_describe_undeclared_parameters, um Metadaten abzurufen. Für diese gespeicherten Prozeduren gelten einige Einschränkungen (beispielsweise treten bei der Verwendung für temporäre Tabellen Fehler auf). Durch die Festlegung von Use FMTONLY auf true wird der Treiber angewiesen, für den Abruf von Metadaten stattdessen SET FMTONLY zu verwenden. |
| Benutzer-ID | DBPROP_AUTH_USERID | Der SQL Server-Anmeldename. |
| Workstation ID | SSPROP_INIT_WSID | Der Bezeichner der Arbeitsstation. |
[1]: Zur Verbesserung der Sicherheit wird das Verschlüsselungs- und Zertifikatvalidierungsverhalten bei Verwendung von Eigenschaften für die Authentifizierungs-/Zugriffstokeninitialisierung oder den entsprechenden Verbindungszeichenfolgen-Schlüsselwörtern geändert. Ausführliche Informationen finden Sie unter Verschlüsselung und Zertifikatüberprüfung.
Hinweis
In der Verbindungszeichenfolge legt die Eigenschaft Old Password den Wert „SSPROP_AUTH_OLD_PASSWORD“ fest. Dies entspricht dem aktuellen (möglicherweise abgelaufenen) Kennwort, das nicht über eine Eigenschaft der Anbieterzeichenfolge verfügbar ist.
Schlüsselwörter für ActiveX Data Objects (ADO)-Verbindungszeichenfolgen
ADO-Anwendungen legen die ConnectionString-Eigenschaft von ADODBConnection-Objekten fest oder stellen eine Verbindungszeichenfolge als Parameter für die Open-Methode von ADODBConnection-Objekten bereit.
In ADO-Anwendungen können Sie auch die Schlüsselwörter für die OLE DB-Methode IDBInitialize::Initialize verwenden, allerdings nur für Eigenschaften, die über keinen Standardwerte verfügen. Wenn eine Anwendung sowohl ADO-Schlüsselwörter als auch die IDBInitialize::Initialize-Schlüsselwörter in der Initialisierungszeichenfolge verwendet, dann wird die ADO-Schlüsselworteinstellung verwendet. Es wird empfohlen, dass Anwendungen nur Schlüsselwörter für ADO-Verbindungszeichenfolgen verwenden.
Die für ADO verwendeten Verbindungszeichenfolge haben folgende Syntax:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
Es wird empfohlen, Attributwerte in doppelte Anführungszeichen zu setzen. Dadurch werden Probleme vermieden, wenn Werte nicht alphanumerische Zeichen enthalten. Attributwerte dürfen keine doppelten Anführungszeichen enthalten.
In der folgenden Tabelle werden die Schlüsselwörter beschrieben, die in einer ADO-Verbindungszeichenfolge verwendet werden können.
| Schlüsselwort | Initialisierungseigenschaft | BESCHREIBUNG |
|---|---|---|
| Access Token1 | SSPROP_AUTH_ACCESS_TOKEN | Das für die Authentifizierung bei Microsoft Entra ID verwendete Zugriffstoken. HINWEIS: Es ist ein Fehler, dieses Schlüsselwort und auch die Schlüsselwörter UID, PWD, Trusted_Connection oder Authentication für Verbindungszeichenfolgen oder die entsprechenden Eigenschaften/Schlüsselwörter anzugeben. |
| Application Intent | SSPROP_INIT_APPLICATIONINTENT | Deklariert den Arbeitsauslastungstyp der Anwendung beim Herstellen einer Verbindung mit einem Server. Mögliche Werte sind ReadOnly und ReadWrite.Der Standardwert lautet ReadWrite. Weitere Informationen zur OLE DB-Treiber für SQL Server-Unterstützung für Always On-Verfügbarkeitsgruppen finden Sie unter OLE DB-Treiber für SQL Server-Unterstützung für Hochverfügbarkeit, Notfallwiederherstellung. |
| Anwendungsname | SSPROP_INIT_APPNAME | Die Zeichenfolge, die die Anwendung identifiziert. |
| Authentication1 | SSPROP_AUTH_MODE | Gibt die verwendete SQL oder Microsoft Entra-Authentifizierung an. Gültige Werte sind:
HINWEIS: Das Schlüsselwort ActiveDirectoryIntegrated kann auch für die Windows-Authentifizierung gegenüber SQL Server verwendet werden. Es ersetzt die Authentifizierungsschlüsselwörter Integrated Security (oder Trusted_Connection). Es wird empfohlen, dass Anwendungen mit Verwendung der Schlüsselwörter Integrated Security (oder Trusted_Connection) der zugehörigen Eigenschaften den Wert des Schlüsselwerts Authentication (oder der zugehörigen Eigenschaft) auf ActiveDirectoryIntegrated festlegen, um ein neues Verhalten für Verschlüsselung und Zertifikatvalidierung zu aktivieren.HINWEIS: Es wird empfohlen, dass Anwendungen mit Verwendung des Authentifizierungssatzes SQL Server den Wert des Schlüsselwerts Authentication (oder der zugehörigen Eigenschaft) auf SqlPassword festlegen, um ein neues Verhalten für Verschlüsselung und Zertifikatvalidierung zu aktivieren. |
| Automatisches Übersetzen | SSPROP_INIT_AUTOTRANSLATE | Konfiguriert die OEM-/ANSI-Zeichenübersetzung. Gültige Werte sind true und false. |
| Connect Timeout | DBPROP_INIT_TIMEOUT | Der Zeitraum (in Sekunden), der bis zum Abschluss der Datenquelleninitialisierung abgewartet werden soll. |
| Connect Retry Count (Anzahl der Verbindungsversuche) | SSPROP_INIT_CONNECT_RETRY_COUNT | Steuert die Anzahl der erneuten Versuche zur Verbindungsherstellung bei einem Verbindungsverlust. Gültige Werte reichen von 0 bis 255. Standardwert: 1. Ein Wert von 0 bedeutet, dass kein erneuter Verbindungsversuch unternommen wird. Weitere Informationen finden Sie unter Resilienz bei Verbindungen im Leerlauf. |
| Connect Retry Interval (Verbindungswiederholungsintervall) | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Gibt die Anzahl der Sekunden zwischen den erneuten Versuchen zur Verbindungsherstellung im Falle eines Verbindungsverlusts an. Gültige Werte reichen von 1 bis 60. Standardwert: 10. Weitere Informationen finden Sie unter Resilienz bei Verbindungen im Leerlauf. |
| Current Language | SSPROPT_INIT_CURRENTLANGUAGE | Der SQL Server-Sprachenname. |
| Data Source | DBPROP_INIT_DATASOURCE | Der Name einer SQL Server-Instanz in der Organisation. Ohne Angabe eines Namens wird eine Verbindung mit der Standardinstanz auf dem lokalen Computer hergestellt. Weitere Informationen zur Syntax einer gültigen Adresse finden Sie in der Beschreibung des Schlüsselworts Server in diesem Artikel. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Gibt den Modus der zu verwendenden Datentypbehandlung an. Zulässig sind der Wert 0 für Anbieterdatentypen und der Wert 80 für SQL Server 2000-Datentypen. |
| Failoverpartner | SSPROP_INIT_FAILOVERPARTNER | Der Name des für die Datenbankspiegelung zu verwendenden Failoverservers. |
| Failover Partner SPN | SSPROP_INIT_FAILOVERPARTNERSPN | Der SPN für den Failoverpartner. Der Standardwert ist eine leere Zeichenfolge. Eine leere Zeichenfolge bewirkt, dass der OLE DB-Treiber für SQL Server den vorgegebenen, vom Anbieter generierten SPN verwendet. |
| Hostname im Zertifikat | SSPROP_INIT_HOST_NAME_CERTIFICATE | Der Hostname, der beim Überprüfen des TLS/SSL-Zertifikats von SQL Server verwendet werden soll. Wird das Schlüsselwort Hostname im Zertifikat nicht festgelegt, verwendet der Treiber den Wert des Schlüsselworts Datenquelle in der Verbindungs-URL als Hostnamen, um das TLS/SSL-Zertifikat von SQL Server zu überprüfen. HINWEIS: Diese Eigenschaft wird ignoriert, wenn das Serverzertifikat vertrauenswürdig ist. Wenn Verschlüsselung für Daten verwenden auf Strict festgelegt ist, wird das Zertifikat immer überprüft. |
| Anfangskatalog | DBPROP_INIT_CATALOG | Der Datenbankname. |
| Anfangsdateiname | SSPROP_INIT_FILENAME | Der Name der Primärdatenbank (einschließlich des vollständigen Pfadnamens) einer anfügbaren Datenbank. Für die Verwendung von AttachDBFileName muss auch der Datenbankname mit dem Schlüsselwort DATABASE für die Anbieterzeichenfolge angegeben werden. Wenn die Datenbank bereits angefügt war, fügt SQL Server sie nicht noch mal an (die angefügte Datenbank wird standardmäßig für die Verbindung verwendet). |
| Integrierte Sicherheit | DBPROP_AUTH_INTEGRATED | Akzeptiert den Wert SSPI für die Windows-Authentifizierung |
| MARS-Verbindung | SSPROP_INIT_MARSCONNECTION | Ermöglicht oder unterbindet die Verwendung von mehreren aktiven Resultsets (MARS) bei einer Verbindung, wenn auf dem Server SQL Server 2005 (9.x) oder höher ausgeführt wird. Gültige Werte sind true und false. Der Standardwert lautet false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Geben Sie immer MultiSubnetFailover=True an, wenn Sie eine Verbindung mit dem Verfügbarkeitsgruppenlistener einer SQL Server-Verfügbarkeitsgruppe oder einer SQL Server-Failoverclusterinstanz herstellen. MultiSubnetFailover=TRUE konfiguriert den OLE DB-Treiber für SQL Server so, dass der (derzeit) aktive Server schneller erkannt und eine Verbindung zu ihm hergestellt wird. Mögliche Werte sind True und False. Der Standardwert lautet False. Beispiel:MultiSubnetFailover=TrueWeitere Informationen zur OLE DB-Treiber für SQL Server-Unterstützung für Always On-Verfügbarkeitsgruppen finden Sie unter OLE DB-Treiber für SQL Server-Unterstützung für Hochverfügbarkeit, Notfallwiederherstellung. |
| Network Address | SSPROP_INIT_NETWORKADDRESS | Die Netzwerkadresse einer Instanz von SQL Server in der Organisation. Weitere Informationen zur Syntax einer gültigen Adresse finden Sie in der Beschreibung des Schlüsselworts Adresse in diesem Artikel. |
| Network Library | SSPROP_INIT_NETWORKLIBRARY | Die Netzwerkbibliothek, die zum Herstellen einer Verbindung mit einer Instanz von SQL Server in der Organisation verwendet wird. |
| Packet Size | SSPROP_INIT_PACKETSIZE | Dies ist die TDS-Paketgröße (Tabular Data Stream). Der Standardwert ist 0, der tatsächliche Wert wird vom Server bestimmt. |
| Kennwort | DBPROP_AUTH_PASSWORD | Das Anmeldekennwort für SQL Server. |
| Persist Security Info | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Bei diesem Schlüsselwort werden die Zeichenfolgen true und false als Werte akzeptiert. Bei false darf das Datenquellenobjekt vertrauliche Authentifizierungsinformationen nicht dauerhaft speichern. |
| Anbieter | Für den OLE DB-Treiber für SQL Server lautet der Wert MSOLEDBSQL19 oder MSOLEDBSQL. |
|
| Serverzertifikat | SSPROP_INIT_SERVER_CERTIFICATE | Gibt den Pfad zu einer Zertifikatdatei an, die mit dem TLS-/SSL-Zertifikat von SQL Server abgeglichen werden soll. Diese Option kann nur verwendet werden, wenn die Strict-Verschlüsselung aktiviert ist. Die akzeptierten Zertifikatformate sind PEM, DER und CER. Wenn angegeben, wird das SQL Server-Zertifikat überprüft, indem festgestellt wird, ob das bereitgestellte Zertifikat eine exakte Übereinstimmung ist. |
| Server SPN | SSPROP_INIT_SERVERSPN | Der SPN für den Server. Der Standardwert ist eine leere Zeichenfolge. Eine leere Zeichenfolge bewirkt, dass der OLE DB-Treiber für SQL Server den vorgegebenen, vom Anbieter generierten SPN verwendet. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Wirkt sich auf die Verbindungssequenz aus, wenn die erste aufgelöste IP-Adresse des Hostnamens nicht reagiert und dem Hostnamen mehrere IP-Adressen zugeordnet sind. TNIR interagiert mit MultiSubnetFailover, um verschiedene Verbindungssequenzen bereitzustellen. Mögliche Werte sind True und False. Standardwert: True. Weitere Informationen finden Sie unter Verwenden der transparenten Netzwerk-IP-Adressauflösung. |
| Trust Server Certificate1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Bei diesem Schlüsselwort werden die Zeichenfolgen true und false als Werte akzeptiert. Der Standardwert lautet false und bedeutet, dass das Serverzertifikat überprüft wird. |
| Use Encryption for Data1 | SSPROP_INIT_ENCRYPT | Gibt an, ob Daten vor dem Senden über das Netzwerk verschlüsselt werden sollen. Mögliche Werte sind Optional, Mandatory und Strict. Standardwert: Mandatory. Informationen zu 18.x.x-Versionen finden Sie unter Hauptversionsunterschiede für MSOLEDBSQL. |
| Use FMTONLY | SSPROP_INIT_USEFMTONLY | Steuert, wie Metadaten abgerufen wird, wenn eine Verbindung mit SQL Server 2012 (11.x) und höher hergestellt wird. Mögliche Werte sind true und false. Standardwert: false.Standardmäßig verwendet der OLE DB-Treiber für SQL Server die gespeicherten Prozeduren sp_describe_first_result_set und sp_describe_undeclared_parameters, um Metadaten abzurufen. Für diese gespeicherten Prozeduren gelten einige Einschränkungen (beispielsweise treten bei der Verwendung für temporäre Tabellen Fehler auf). Durch die Festlegung von Use FMTONLY auf true wird der Treiber angewiesen, für den Abruf von Metadaten stattdessen SET FMTONLY zu verwenden. |
| Benutzer-ID | DBPROP_AUTH_USERID | Der SQL Server-Anmeldename. |
| Workstation ID | SSPROP_INIT_WSID | Der Bezeichner der Arbeitsstation. |
[1]: Zur Verbesserung der Sicherheit wird das Verschlüsselungs- und Zertifikatvalidierungsverhalten bei Verwendung von Eigenschaften für die Authentifizierungs-/Zugriffstokeninitialisierung oder den entsprechenden Verbindungszeichenfolgen-Schlüsselwörtern geändert. Ausführliche Informationen finden Sie unter Verschlüsselung und Zertifikatüberprüfung.
Hinweis
In der Verbindungszeichenfolge legt die Eigenschaft „Altes Kennwort“ den Wert „SSPROP_AUTH_OLD_PASSWORD“ fest. Dies entspricht dem aktuellen (möglicherweise abgelaufenen) Kennwort, das nicht über eine Eigenschaft der Anbieterzeichenfolge verfügbar ist.
Weitere Informationen
Erstellen von Anwendungen mit dem OLE DB-Treiber für SQL Server
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für