Partilhar via


Propriedades da fonte de dados do SQL Server Native Client (OLE DB)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Importante

O SQL Server Native Client (geralmente abreviado como SNAC) foi removido do SQL Server 2022 (16.x) e do SSMS (SQL Server Management Studio) 19. O provedor OLE DB do SQL Server Native Client (SQLNCLI ou SQLNCLI11) e o Provedor OLE DB herdado da Microsoft para o SQL Server (SQLOLEDB) não são recomendados para um novo desenvolvimento. Alterne para o novo Driver do Microsoft OLE DB para SQL Server (MSOLEDBSQL) no futuro.

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 Leitura/gravação: leitura/gravação Padrã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. A definição do valor da propriedade tem o mesmo efeito de definir o banco de dados atual usando a instrução USE database do Transact-SQL.

Do SQL Server 2005 (9.x) em diante, 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á 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 retorna DB_E_OBJECTOPEN se DBPROP_MULTIPLECONNECTIONS estiver VARIANT_FALSE e retorna 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íficas 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 ficará 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

Objetos de fonte de dados (OLE DB)