Panoramica del provider Microsoft OLE DB per SQL Server

Il provider Microsoft OLE DB per SQL Server, SQLOLEDB, consente ad ADO di accedere a Microsoft SQL Server.

Parametri della stringa di connessione

Per connettersi a questo provider, impostare l'argomento Provider della proprietà ConnectionString come segue:

SQLOLEDB

È possibile impostare o leggere questo valore anche usando la proprietà Provider.

Stringa di connessione tipica

Una stringa di connessione tipica per questo provider è:

"Provider=SQLOLEDB;Data Source=serverName;"
Initial Catalog=databaseName;
User ID=MyUserID;Password=MyPassword;"

La stringa è costituita da queste parole chiave:

Parametri Connection specifici del provider

Il provider supporta diversi parametri di connessione specifici del provider oltre a quelli definiti da ADO. Come per le proprietà di connessione ADO, queste proprietà specifiche del provider possono essere impostate tramite la raccolta Properties di un oggetto Connection o possono essere impostate come parte dell'oggetto ConnectionString.

Utilizzo dell'oggetto Command

SQLOLEDB accetta una combinazione di ODBC, ANSI e Transact-SQL specifico di SQL Server come sintassi valida. L'istruzione SQL seguente, ad esempio, utilizza una sequenza di escape ODBC SQL per specificare la funzione per i valori stringa LCASE:

SELECT customerid={fn LCASE(CustomerID)} FROM Customers

LCASE restituisce una stringa di caratteri, convertendo tutti i caratteri maiuscoli nei rispettivi equivalenti minuscoli. Poiché la funzione per i valori stringa ANSI SQL LOWER esegue la stessa operazione, l'istruzione SQL seguente è un equivalente ANSI dell'istruzione ODBC presentata nell'esempio precedente:

SELECT customerid=LOWER(CustomerID) FROM Customers

SQLOLEDB elabora correttamente entrambe le forme dell'istruzione se specificate come testo per un comando.

Stored procedure

Quando si esegue una stored procedure di SQL Server con un comando SQLOLEDB, usare la sequenza di escape della chiamata di procedura ODBC nel testo del comando. SQLOLEDB usa quindi il meccanismo Remote Procedure Call di SQL Server per ottimizzare l'elaborazione del comando. L'istruzione ODBC SQL seguente, ad esempio, rappresenta il testo del comando preferito rispetto al formato Transact-SQL:

ODBC SQL

{call SalesByCategory('Produce', '1995')}

Transact-SQL

EXECUTE SalesByCategory 'Produce', '1995'

Funzionalità di SQL Server

Con SQL Server, ADO può usare il codice XML per l'input dei comandi e recuperare i risultati in formato di flusso XML anziché negli oggetti Recordset. Per altre informazioni, vedere Uso dei flussi per l'input dei comandi e Recupero di set di risultati nei flussi.

Accesso ai dati sql_variant con MDAC 2.7, MDAC 2.8 o Windows DAC 6.0

Microsoft SQL Server dispone di un tipo di dati denominato sql_variant. Simile a DBTYPE_VARIANT di OLE DB, il tipo di dati sql_variant può archiviare dati di diversi tipi. Esistono tuttavia alcune differenze fondamentali tra DBTYPE_VARIANT e sql_variant. ADO gestisce anche i dati archiviati come valore sql_variant diversamente da come gestisce altri tipi di dati. L'elenco seguente descrive i problemi da considerare quando si accede ai dati di SQL Server archiviati in colonne di tipo sql_variant.

• In MDAC 2.7, MDAC 2.8 e Windows Data Access Components (Windows DAC) 6.0, il provider OLE DB per SQL Server supporta il tipo sql_variant. Il provider OLE DB per ODBC non lo supporta.

• Il tipo sql_variant non corrisponde esattamente al tipo di dati DBTYPE_VARIANT. Il tipo sql_variant supporta alcuni nuovi sottotipi non supportati da DBTYPE_VARIANT, tra cui GUID, stringhe ANSI (non UNICODE) e BIGINT. L'uso di sottotipi diversi da quelli elencati in precedenza funzionerà correttamente.

• Il sottotipo sql_variant NUMERIC non corrisponde a DBTYPE_DECIMAL in termini di dimensioni.

• Le coercizioni di più tipi di dati daranno luogo a tipi che non corrispondono. Ad esempio, la coercizione di un tipo sql_variant con un sottotipo GUID in un tipo DBTYPE_VARIANT comporterà un sottotipo safearray(byte). La riconversione di questo tipo in un tipo sql_variant comporta un nuovo sottotipo array(byte).

• I campi degli oggetti Recordset contenenti dati sql_variant possono essere usati in remoto (sottoposti a marshalling) o essere resi persistenti solo se il tipo sql_variant contiene sottotipi specifici. Il tentativo di usare i dati in remoto o di renderli persistenti con i seguenti sottotipi non supportati causerà un errore di runtime (conversione non supportata) da parte del provider di persistenza Microsoft (MSPersist): VT_VARIANT, VT_RECORD, VT_ILLEGAL, VT_UNKNOWN, VT_BSTR e VT_DISPATCH.

• Il provider OLE DB per SQL Server in MDAC 2.7, MDAC 2.8 e Windows DAC 6.0 ha una proprietà dinamica denominata Allow Native Variants che, come suggerisce il nome, consente agli sviluppatori di accedere al tipo sql_variant nel formato nativo anziché al tipo DBTYPE_VARIANT. Se questa proprietà è impostata e un oggetto Recordset viene aperto con il motore del cursore client (adUseClient), la chiamata Recordset.Open avrà esito negativo. Se questa proprietà è impostata e un oggetto Recordset viene aperto con i cursori del server (adUseServer), la chiamata Recordset.Open avrà esito positivo, ma l'accesso alle colonne di tipo sql_variant genererà un errore.

• Nelle applicazioni client che usano MDAC 2.5, è possibile usare i dati sql_variant con query su Microsoft SQL Server. Tuttavia, i valori dei dati sql_variant vengono considerati come stringhe. Tali applicazioni client devono essere aggiornate a MDAC 2.7, MDAC 2.8 o Windows DAC 6.0.

Comportamento dell'oggetto Recordset

SQLOLEDB non può usare i cursori di SQL Server per supportare i risultati multipli generati da molti comandi. Se un consumer richiede un recordset per cui è necessario il supporto del cursore SQL Server, si verifica un errore se il testo del comando usato genera più di un recordset come risultato.

I recordset SQLOLEDB scorrevoli sono supportati dai cursori di SQL Server. SQL Server impone limitazioni sui cursori che sono sensibili alle modifiche apportate dagli altri utenti del database. In particolare, le righe in alcuni cursori non possono essere ordinate e il tentativo di creare un recordset usando un comando contenente una clausola SQL ORDER BY può non riuscire.

Proprietà dinamiche

Il provider Microsoft OLE DB per SQL Server inserisce diverse proprietà dinamiche nella raccolta Properties degli oggetti Connection, Recordset e Command non aperti.

Le tabelle seguenti sono un indice incrociato dei nomi ADO e OLE DB per ogni proprietà dinamica. La Guida di riferimento per programmatori OLE DB fa riferimento al nome di una proprietà ADO con il termine "Description". Altre informazioni su queste proprietà sono disponibili nella Guida di riferimento per programmatori OLE DB. Cercare il nome della proprietà OLE DB nell'indice o vedere Appendice C: Proprietà OLE DB.

Proprietà dinamiche di Connection

Le proprietà seguenti vengono aggiunte alla raccolta Properties dell'oggetto Connection.

Proprietà dinamiche dell'oggetto Recordset

Le proprietà seguenti vengono aggiunte alla raccolta Properties dell'oggetto Recordset.

Proprietà dinamiche di Command

Le proprietà seguenti vengono aggiunte alla raccolta Properties dell'oggetto Command.

Per informazioni specifiche sull'implementazione e informazioni funzionali sul provider OLE DB di Microsoft SQL Server, vedere Provider di SQL Server.

Vedi anche

Proprietà ConnectionString (ADO)Proprietà Provider (ADO)Oggetto Recordset (ADO)