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

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

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 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 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 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 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 SQL Server Native Client define as propriedades adicionais da fonte de dados a seguir.

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)