Partilhar via


Propriedades da fonte de dados (OLE DB)

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

ID da propriedade

Descrição

DBPROP_CURRENTCATALOG

Leitura/gravação: leitura/gravação Padrão: nenhum

Descrição: o valor de DBPROP_CURRENTCATALOG informa o banco de dados atual para uma sessão do provedor OLE DB do SQL Server Native Client. A configuração do valor da propriedade tem o mesmo efeito de configurar o banco de dados atual usando a instrução database USE do Transact-SQL.

A partir do SQL Server 2005, se você chamar sp_defaultdb e especificar o nome do banco de dados em minúsculas, mesmo que o banco de dados tenha sido criado originalmente com um nome com maiúsculas e minúsculas, DBPROP_CURRENTCATALOG retornará o nome em minúsculas. Nas versões anteriores do SQL Server, DBPROP_CURRENTCATALOG retornará as maiúsculas e minúsculas esperadas.

DBPROP_MULTIPLECONNECTIONS

Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE

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

O provedor OLE DB do SQL Server Native Client não criará uma outra conexão se DBPROP_MULTIPLECONNECTION for VARIANT_FALSE ou se houver uma transação ativa na conexão. O provedor OLE DB do SQL Server Native Client retornará DB_E_OBJECTOPEN se DBPROP_MULTIPLECONNECTIONS for 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 assegurar um comando não bloqueie o outro, mantenha os bloqueios em linhas solicitadas pelo outro comando. Isto também se aplica à criação de 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 adicionais da fonte de dados.

ID da propriedade

Descrição

SSPROP_ENABLEFASTLOAD

Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE

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

Se a propriedade for 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

Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE

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

SSPROP_IRowsetFastLoad também deve ser definido como VARIANT_TRUE.

Consulte também

Conceitos