Proprietà dell'origine dati di SQL Server Native Client (OLE DB)

Si applica a: SQL Server database SQL di Azure Istanza gestita di SQL di Azure azure Synapse Analytics Analytics Platform System (PDW)

Importante

SQL Server Native Client (spesso abbreviato SNAC) è stato rimosso da SQL Server 2022 (16.x) e da SQL Server Management Studio 19 (SSMS). Il provider OLE DB di SQL Server Native Client (SQLNCLI o SQLNCLI11) e il provider OLE DB legacy Microsoft per SQL Server (SQLOLEDB) non sono consigliati per lo sviluppo di nuove applicazioni. In futuro, passare al nuovo driver Microsoft OLE DB (MSOLEDBSQL) per SQL Server.

Il provider OLE DB di 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 di 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 di 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 di 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à specifico del provider DBPROPSET_SQLSERVERDATASOURCE, il provider OLE DB di 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.

Vedi anche

Oggetti di origine dati (OLE DB)