Поделиться через


Свойства источника данных собственного клиента SQL Server (OLE DB)

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Внимание

Собственный клиент SQL Server (часто сокращенный SNAC) был удален из SQL Server 2022 (16.x) и SQL Server Management Studio 19 (SSMS). Поставщик OLE DB собственного клиента SQL Server (SQLNCLI или SQLNCLI11) и устаревший поставщик Microsoft OLE DB для SQL Server (SQLOLEDB) не рекомендуется для новой разработки. Перейдите на новый драйвер Microsoft OLE DB (MSOLEDBSQL) для SQL Server .

Поставщик OLE DB собственного клиента SQL Server реализует свойства источника данных следующим образом.

Идентификатор свойства Description
DBPROP_CURRENTCATALOG R/W: чтение и запись по умолчанию: Нет

Описание. Значение DBPROP_CURRENTCATALOG сообщает текущую базу данных для сеанса поставщика OLE DB собственного клиента SQL Server. Установка значения этого свойства равноценна установке текущей базы данных с помощью инструкции Transact-SQL USE база_данных.

Начиная с SQL Server 2005 (9.x), при вызове sp_defaultdb и указании имени базы данных в нижнем регистре, даже если база данных была создана с смешанным именем регистра, DBPROP_CURRENTCATALOG вернет имя в нижнем регистре. В предыдущих версиях SQL Server DBPROP_CURRENTCATALOG возвращает ожидаемый смешанный случай.
DBPROP_MULTIPLECONNECTIONS R/W: чтение и запись по умолчанию: VARIANT_FALSE

Описание: если в рамках подключения выполняется команда, не создающая набор строк или создающая набор строк, который не является серверным курсором, и одновременно выполняется другая команда, для выполнения этой команды создается новое подключение, если свойство DBPROP_MULTIPLECONNECTIONS имеет значение VARIANT_TRUE.

Поставщик OLE DB собственного клиента SQL Server не создаст другое подключение, если DBPROP_MULTIPLECONNECTION VARIANT_FALSE или если транзакция активна в соединении. Поставщик OLE DB собственного клиента SQL Server возвращает DB_E_OBJECTOPEN, если DBPROP_MULTIPLECONNECTIONS VARIANT_FALSE и возвращает E_FAIL, если существует активная транзакция. Транзакции и блокировка управляются SQL Server на основе каждого подключения. Если создано второе соединение, команды в отдельных соединениях не используют общие блокировки. Чтобы убедиться, что одна команда не блокирует другую, удерживайте блокировки строк, запрошенных другой командой. Это верно и при создании нескольких сеансов.

Каждый сеанс имеет отдельное соединение.

В наборе свойств для конкретного поставщика DBPROPSET_SQLSERVERDATASOURCE поставщик OLE DB sql Server Native Client определяет следующие дополнительные свойства источника данных.

Идентификатор свойства Description
SSPROP_ENABLEFASTLOAD R/W: чтение и запись по умолчанию: VARIANT_FALSE

Описание: чтобы включить массовое копирование из памяти, свойству SSPROP_ENABLEFASTLOAD необходимо присвоить значение VARIANT_TRUE. Если это свойство установлено в источнике данных, вновь созданный сеанс позволяет потребителю получить доступ к интерфейсу IRowsetFastLoad.

Если это свойство имеет значение VARIANT_TRUE, доступ к интерфейсу IRowsetFastLoad можно получить через метод IOpenRowset::OpenRowset, запросив интерфейс IID_IRowsetFastLoad, или с помощью присвоения свойству SSPROP_IRowsetFastLoad значения VARIANT_TRUE.
SSPROP_ENABLEBULKCOPY R/W: чтение и запись по умолчанию: VARIANT_FALSE

Описание: чтобы включить массовое копирование из файлов, свойству SSPROP_ENABLEBULKCOPY необходимо присвоить значение VARIANT_TRUE. Если это свойство установлено в источнике данных, потребитель получает доступ к интерфейсу IBCPSession с тем же уровнем, что и сеанс.

Свойство SSPROP_IRowsetFastLoad также должно быть установлено в значение VARIANT_TRUE.

См. также

Объекты источников данных (OLE DB)