Share via

SQL Server Native Client proprietà origine dati (OLE DB)

  • Articolo

Si applica a: SQL Server Azure SQL DatabaseIstanza gestita di SQL di Azure Azure SynapseAnalytics AnalyticsPlatform System (PDW)

Importante

La SQL Server Native Client (spesso abbreviata SNAC) è stata rimossa da SQL Server 2022 (16.x) e SQL Server Management Studio 19 (SSMS). Sia il provider OLE DB SQL Server Native Client (SQLNCLI o SQLNCLI11) che il provider Microsoft OLE DB legacy per SQL Server (SQLOLEDB) non è consigliato per il nuovo sviluppo. Passare al nuovo driver Microsoft OLE DB (MSOLEDBSQL) per SQL Server in futuro.

Il provider OLE DB SQL Server Native Client implementa le proprietà dell'origine dati come indicato di seguito.

ID proprietà Descrizione
DBPROP_CURRENTCATALOG L/S: Lettura/scrittura Impostazione predefinita: Nessuna

Descrizione: il valore di DBPROP_CURRENTCATALOG segnala il database corrente per una sessione del provider OLE DB SQL Server Native Client. Se si imposta il valore della proprietà, si ottiene lo stesso effetto che si ottiene impostando il database corrente utilizzando l'istruzione Transact-SQL USE database.

A partire da SQL Server 2005 (9.x), se si chiama sp_defaultdb e si specifica il nome del database in caratteri minuscoli, anche se il database è stato creato usando sia maiuscole che minuscole, DBPROP_CURRENTCATALOG restituirà il nome in minuscolo. Con le versioni precedenti di SQL Server, DBPROP_CURRENTCATALOG restituisce invece la combinazione di maiuscole e minuscole prevista.
DBPROP_MULTIPLECONNECTIONS L/S: Lettura/scrittura Impostazione predefinita: VARIANT_FALSE

Descrizione: Se la connessione esegue un comando che non produce un set di righe o produce un set di righe che non è un cursore server e si esegue un altro comando, verrà creata una nuova connessione per eseguire il nuovo comando se DBPROP_MULTIPLECONNECTIONS è VARIANT_TRUE.

Il provider OLE DB SQL Server Native Client non creerà un'altra connessione se DBPROP_MULTIPLECONNECTION è VARIANT_FALSE o se una transazione è attiva nella connessione. Il provider OLE DB SQL Server Native Client restituisce DB_E_OBJECTOPEN se DBPROP_MULTIPLECONNECTIONS è VARIANT_FALSE e restituisce E_FAIL se è presente una transazione attiva. Le transazioni e il blocco vengono gestiti da SQL Server per singola connessione. Se viene generata una seconda connessione, i comandi sulle connessioni separate non condividono blocchi. Per assicurarsi che un comando non blocchi un altro comando, mantenere attivi i blocchi sulle righe richieste da quest'ultimo. Ciò vale anche nel caso di creazione di più sessioni.

Ogni sessione ha una connessione separata.

Nel set di proprietà specifiche del provider DBPROPSET_SQLSERVERDATASOURCE, il provider OLE DB SQL Server Native Client definisce le proprietà aggiuntive dell'origine dati seguenti.

ID proprietà Descrizione
SSPROP_ENABLEFASTLOAD L/S: Lettura/scrittura Impostazione predefinita: VARIANT_FALSE

Descrizione: Per abilitare la copia bulk dalla memoria, la proprietà SSPROP_ENABLEFASTLOAD deve essere impostata su VARIANT_TRUE. Se questa proprietà è impostata sull'origine dati, la sessione appena creata consente al consumer di accedere all'interfaccia IRowsetFastLoad.

Se la proprietà è impostata su VARIANT_TRUE, l'interfaccia IRowsetFastLoad è disponibile attraverso IOpenRowset::OpenRowset richiedendo l'interfaccia IID_IRowsetFastLoad o impostando SSPROP_IRowsetFastLoad su VARIANT_TRUE.
SSPROP_ENABLEBULKCOPY L/S: Lettura/scrittura Impostazione predefinita: VARIANT_FALSE

Descrizione: Per abilitare la copia bulk dai file, la proprietà SSPROP_ENABLEBULKCOPY deve essere impostata su VARIANT_TRUE. Se questa proprietà è impostata sull'origine dati, l'accesso del consumer all'interfaccia IBCPSession è disponibile allo stesso livello delle sessioni.

Anche SSPROP_IRowsetFastLoad deve essere impostato su VARIANT_TRUE.

Vedere anche

Oggetti origine dati (OLE DB)