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

Применимо:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azureazure Synapse Analytics AnalyticsPlatform 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.

Связанные материалы

  • Last updated on