Compartilhar via


Propriedades da fonte de dados (OLE DB)

O provedor OLE DB do SQL Server Native Client implementa as propriedades da fonte de dados da seguinte maneira.

ID da Propriedade Descrição
DBPROP_CURRENTCATALOG R/W: Padrão de leitura/gravação: Nenhum

Descrição: O valor de DBPROP_CURRENTCATALOG relata o banco de dados atual para uma sessão de provedor OLE DB do SQL Server Native Client. Definir o valor da propriedade tem o efeito idêntico ao definir o banco de dados atual usando a instrução de banco de dados USE Transact-SQL.

A partir do SQL Server 2005, se você chamar sp_defaultdb e especificar o nome do banco de dados em letras minúsculas, mesmo que o banco de dados tenha sido criado originalmente com um nome de caso misto, DBPROP_CURRENTCATALOG retornará o nome em letras minúsculas. Com as versões anteriores do SQL Server, DBPROP_CURRENTCATALOG retornará o caso misto esperado.
DBPROP_MULTIPLECONNECTIONS R/W: Padrão de leitura/gravação: VARIANT_FALSE

Descrição: se a conexão estiver executando um comando que não produz um conjunto de linhas ou produz um conjunto de linhas que não seja um cursor de servidor e você executar outro comando, uma nova conexão será criada para executar o novo comando se DBPROP_MULTIPLECONNECTIONS for VARIANT_TRUE.

O provedor OLE DB do SQL Server Native Client não criará outra conexão se DBPROP_MULTIPLECONNECTION estiver VARIANT_FALSE ou se uma transação estiver ativa na conexão. O provedor OLE DB do SQL Server Native Client retornará DB_E_OBJECTOPEN se DBPROP_MULTIPLECONNECTIONS estiver VARIANT_FALSE e retornar E_FAIL se houver uma transação ativa. As transações e o bloqueio são gerenciados pelo SQL Server por conexão. Se uma segunda conexão for gerada, os comandos nas conexões separadas não compartilharão bloqueios. Para garantir que um comando não bloqueie outro, mantenha os bloqueios nas linhas solicitadas pelo outro comando. Isso também é verdadeiro ao criar várias sessões.

Cada sessão tem uma conexão separada.

No conjunto de propriedades específico do provedor DBPROPSET_SQLSERVERDATASOURCE, o provedor OLE DB do SQL Server Native Client define as seguintes propriedades de fonte de dados adicionais.

ID da Propriedade Descrição
SSPROP_ENABLEFASTLOAD R/W: Padrão de leitura/gravação: VARIANT_FALSE

Descrição: para habilitar a cópia em massa da memória, SSPROP_ENABLEFASTLOAD propriedade deve ser definida como VARIANT_TRUE. Com essa propriedade definida na fonte de dados, a sessão recém-criada permite o acesso do consumidor à interface IRowsetFastLoad .

Se a propriedade estiver definida como VARIANT_TRUE, a interface IRowsetFastLoad estará disponível por meio de IOpenRowset::OpenRowset solicitando a interface IID_IRowsetFastLoad ou definindo SSPROP_IRowsetFastLoad como VARIANT_TRUE.
SSPROP_ENABLEBULKCOPY R/W: Padrão de leitura/gravação: VARIANT_FALSE

Descrição: para habilitar a cópia em massa de arquivos, SSPROP_ENABLEBULKCOPY propriedade deve ser definida como VARIANT_TRUE. Com essa propriedade definida na fonte de dados, o acesso do consumidor à interface IBCPSession está disponível no mesmo nível que Sessões.

SSPROP_IRowsetFastLoad também deve ser definido como VARIANT_TRUE.

Consulte Também

Objetos de fonte de dados (OLE DB)