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. |