Verwenden von Verbindungszeichenfolgen-Schlüsselwörtern mit dem OLE DB-Treiber für SQL Server

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

OLE DB-Treiber herunterladen

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-string

  • empty-string ::=

  • attribute ::= attribute-keyword=[{]attribute-value[}]

  • attribute-value ::= character-string

  • attribute-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:
  • (not set): Der Authentifizierungsmodus wird durch andere Schlüsselwörter bestimmt.
  • ActiveDirectoryPassword:Benutzer-ID und Kennwortauthentifizierung mit einer Microsoft Entra-Identität.
  • ActiveDirectoryIntegrated: Integrierte Authentifizierung mit Microsoft Entra ID.

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

  • ActiveDirectoryInteractive: Interaktive Authentifizierung mit einer Microsoft Entra-Identität. Diese Methode unterstützt die Multi-Faktor-Authentifizierung für Microsoft Entra.
  • ActiveDirectoryMSI: Authentifizierung mit verwalteter Identität. Für eine benutzerseitig zugewiesene Identität muss die Benutzer-ID auf die Objekt-ID der Benutzeridentität festgelegt werden.
  • ActiveDirectoryServicePrincipal: Authentifizierung mit einem Microsoft Entra-Dienstprinzipal. Als Benutzer-ID sollte die ID der Anwendung (des Clients) festgelegt werden. Als Kennwort sollte das Geheimnis der Anwendung (des Clients) festgelegt werden.
  • SqlPassword: Authentifizierung über eine Benutzer-ID und ein Kennwort.

  • 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=Yes

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

Diese 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-string

  • empty-string ::=

  • attribute ::= attribute-keyword=[quote]attribute-value[quote]

  • attribute-value ::= character-string

  • attribute-keyword ::= identifier

  • quote ::= " | '

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:
  • (not set): Der Authentifizierungsmodus wird durch andere Schlüsselwörter bestimmt.
  • ActiveDirectoryPassword:Benutzer-ID und Kennwortauthentifizierung mit einer Microsoft Entra-Identität.
  • ActiveDirectoryIntegrated: Integrierte Authentifizierung mit Microsoft Entra ID.

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

  • ActiveDirectoryInteractive: Interaktive Authentifizierung mit einer Microsoft Entra-Identität. Diese Methode unterstützt die Multi-Faktor-Authentifizierung für Microsoft Entra.
  • ActiveDirectoryMSI: Authentifizierung mit verwalteter Identität. Für eine benutzerseitig zugewiesene Identität muss die Benutzer-ID auf die Objekt-ID der Benutzeridentität festgelegt werden.
  • ActiveDirectoryServicePrincipal: Authentifizierung mit einem Microsoft Entra-Dienstprinzipal. Als Benutzer-ID sollte die ID der Anwendung (des Clients) festgelegt werden. Als Kennwort sollte das Geheimnis der Anwendung (des Clients) festgelegt werden.
  • SqlPassword: Authentifizierung über eine Benutzer-ID und ein Kennwort.

  • 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=True

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

  • empty-string ::=

  • attribute ::= attribute-keyword=["]attribute-value["]

  • attribute-value ::= character-string

  • attribute-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:
  • (not set): Der Authentifizierungsmodus wird durch andere Schlüsselwörter bestimmt.
  • ActiveDirectoryPassword:Benutzer-ID und Kennwortauthentifizierung mit einer Microsoft Entra-Identität.
  • ActiveDirectoryIntegrated: Integrierte Authentifizierung mit Microsoft Entra ID.

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

  • ActiveDirectoryInteractive: Interaktive Authentifizierung mit einer Microsoft Entra-Identität. Diese Methode unterstützt die Multi-Faktor-Authentifizierung für Microsoft Entra.
  • ActiveDirectoryMSI: Authentifizierung mit verwalteter Identität. Für eine benutzerseitig zugewiesene Identität muss die Benutzer-ID auf die Objekt-ID der Benutzeridentität festgelegt werden.
  • ActiveDirectoryServicePrincipal: Authentifizierung mit einem Microsoft Entra-Dienstprinzipal. Als Benutzer-ID sollte die ID der Anwendung (des Clients) festgelegt werden. Als Kennwort sollte das Geheimnis der Anwendung (des Clients) festgelegt werden.
  • SqlPassword: Authentifizierung über eine Benutzer-ID und ein Kennwort.

  • 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=True

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