SQL Server Native Client Data Source Properties (OLE DB)
Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)
Wichtig
Der SQL Server Native Client (häufig abgekürzt mit SNAC) wurde aus SQL Server 2022 (16.x) und SQL Server Management Studio 19 (SSMS) entfernt. Sowohl der OLE DB-Anbieter für den SQL Server Native Client (SQLNCLI oder SQLNCLI11) als auch der Microsoft OLE DB-Legacyanbieter für SQL Server (SQLOLEDB) werden für Neuentwicklungen nicht empfohlen. Verwenden Sie in Zukunft den neuen Microsoft OLE DB-Treiber für SQL Server (MSOLEDBSQL).
Der OLE DB-Anbieter von SQL Server Native Client implementiert Datenquelleneigenschaften wie folgt.
Eigenschafts-ID | BESCHREIBUNG |
---|---|
DBPROP_CURRENTCATALOG | R/W: Lesen/Schreiben; Standardwert: Keiner Beschreibung: Der Wert von DBPROP_CURRENTCATALOG meldet die aktuelle Datenbank für eine SQL Server Native Client OLE DB-Anbietersitzung. Das Festlegen des Eigenschaftswerts hat dieselbe Auswirkung wie das Festlegen der aktuellen Datenbank mithilfe der Transact-SQL-Anweisung „USE database“. Ab SQL Server 2005 (9.x) gibt DBPROP_CURRENTCATALOG den Datenbanknamen in Kleinbuchstaben zurück, wenn Sie sp_defaultdb aufrufen und den Datenbanknamen in Kleinbuchstaben angeben, auch wenn die Datenbank ursprünglich mit einem Namen in Groß- und Kleinbuchstaben erstellt wurde. In früheren Versionen von SQL Server gibt DBPROP_CURRENTCATALOG den erwarteten Namen mit Groß- und Kleinbuchstaben zurück. |
DBPROP_MULTIPLECONNECTIONS | R/W: Lesen/Schreiben; Standardwert: VARIANT_FALSE Beschreibung: Wenn während der Verbindung ein Befehl ausgeführt wird, der kein Rowset produziert, oder der ein Rowset produziert, das kein Servercursor ist, und Sie einen anderen Befehl ausführen, wird eine neue Verbindung erstellt, um den neuen Befehl auszuführen, wenn für DBPROP_MULTIPLECONNECTIONS VARIANT_TRUE festgelegt ist. Der OLE DB-Anbieter von SQL Server Native Client erstellt keine weitere Verbindung, wenn DBPROP_MULTIPLECONNECTION VARIANT_FALSE ist oder eine Transaktion für die Verbindung aktiv ist. Der OLE DB-Anbieter von SQL Server Native Client gibt DB_E_OBJECTOPEN zurück, wenn DBPROP_MULTIPLECONNECTIONS VARIANT_FALSE ist, und gibt E_FAIL zurück, wenn eine aktive Transaktion vorhanden ist. Transaktionen und Sperren werden von SQL Server auf Verbindungsbasis verwaltet. Wenn eine zweite Verbindung hergestellt wird, nutzen die Befehle auf den anderen Verbindungen Sperren nicht gemeinsam. Um zu gewährleisten, dass ein Befehl einen anderen nicht blockiert, halten Sie Zeilen gesperrt, die von dem anderen Befehl angefordert werden. Dies gilt auch beim Erstellen mehrerer Sitzungen. Jede Sitzung verfügt über eine separate Verbindung. |
Im anbieterspezifischen Eigenschaftensatz DBPROPSET_SQLSERVERDATASOURCE definiert der OLE DB-Anbieter von SQL Server Native Client die folgenden zusätzlichen Datenquelleneigenschaften.
Eigenschafts-ID | BESCHREIBUNG |
---|---|
SSPROP_ENABLEFASTLOAD | R/W: Lesen/Schreiben; Standardwert: VARIANT_FALSE Beschreibung: Um Massenkopiervorgänge aus dem Speicher zu aktivieren, sollte die SSPROP_ENABLEFASTLOAD-Eigenschaft auf VARIANT_TRUE festgelegt werden. Wenn diese Eigenschaft für die Datenquelle festgelegt wurde, lässt die neu erstellte Sitzung den Consumerzugriff auf die IRowsetFastLoad-Schnittstelle zu. Wenn die Eigenschaft auf VARIANT_TRUE festgelegt ist, ist die IRowsetFastLoad-Schnittstelle über IOpenRowset::OpenRowset verfügbar, indem die IID_IRowsetFastLoad-Schnittstelle angefordert oder SSPROP_IRowsetFastLoad auf VARIANT_TRUE festgelegt wird. |
SSPROP_ENABLEBULKCOPY | R/W: Lesen/Schreiben; Standardwert: VARIANT_FALSE Beschreibung: Um Massenkopiervorgänge aus Dateien zu aktivieren, sollte die SSPROP_ENABLEBULKCOPY-Eigenschaft auf VARIANT_TRUE festgelegt werden. Wenn diese Eigenschaft für die Datenquelle festgelegt wurde, ist der Consumerzugriff auf die IBCPSession-Schnittstelle auf derselben Ebene verfügbar wie Sessions. Auch SSPROP_IRowsetFastLoad muss auf VARIANT_TRUE festgelegt werden. |