Driver OLE DB di Microsoft per SQL Server

Download del driver OLE DB

Il Microsoft OLE DB Driver per SQL Server è un'interfaccia di programmazione applicativa (API) autonoma per l'accesso ai dati che fa parte di OLE DB. Collega applicazioni in C e C++ al Microsoft SQL motore di database in database SQL di Azure, SQL database in Microsoft Fabric, Istanza gestita di SQL di Azure e nelle versioni supportate di SQL Server. Microsoft lo ha rilasciato per la prima volta nel 2018 come versione 18 e l'ha incluso in SQL Server 2019 (15.x).

MSOLEDBSQL19 è l'attuale pilota. È generalmente retrocompatibile con SQL Server Native Client (SNAC) e offre funzionalità oltre sia SNAC che il provider SQL Server OLE DB che Windows Data Access Components (Windows DAC, precedentemente Microsoft Data Access Components, o MDAC) fornisce.

Scegliere il punto di partenza

• Per decidere se OLE DB è l'API giusta per la tua applicazione, inizia con Quando usare OLE DB Driver per SQL Server.
• Per installare il driver e iniziare a scrivere codice, vai su Download OLE DB Driver per SQL Server, Requisiti di sistema e Costruzione di applicazioni con OLE DB Driver per SQL Server.
• Per connetterti ad Azure SQL con autenticazione senza password, vai su Uso di Microsoft Entra ID e Uso delle parole chiave di stringa di connessione.
• Per passare da SQLNCLI opSQLOLEDB, vai su Aggiornare un'applicazione a OLE DB Driver per SQL Server da MDAC e differenze principali di versione.
• Per usare il driver da ADO, vai su Utilizzo di ADO con OLE DB Driver per SQL Server.
• Per diagnosticare un problema di connessione o di query, vai su Accesso alle informazioni diagnostiche nel log degli eventi esteso e Problemi noti.

Baseline di produzione per Azure SQL

Usare questo frammento di codice come punto di partenza per una connessione Azure SQL orientata alla produzione. Carica il nome del server e il nome del database dalla configurazione dell'applicazione, si autentica con un'identità gestita in modo che non compaia alcun segreto nella stringa di connessione e abilita la crittografia Tabular Data Stream (TDS) 8.0 con validazione completa del certificato. Imposta un timeout per ogni tentativo di connessione e riprova i fallimenti transitori con retrocesso esponenziale e jitter.

Il frammento in C++ in questo articolo omette include, inizializzazione COM e l'aiuto per la loging, per brevità.

std::wstring BuildConnectionString(const wchar_t* server, const wchar_t* database) {
    std::wstring cs = L"Provider=MSOLEDBSQL19";
    cs += L";Data Source=tcp:"; cs += server; cs += L",1433";
    cs += L";Initial Catalog="; cs += database;
    cs += L";Authentication=ActiveDirectoryMSI";   // managed identity, no stored secret
    cs += L";Use Encryption for Data=Strict";      // TDS 8.0 with certificate validation
    cs += L";Connect Timeout=30";                  // per-attempt connect timeout, in seconds
    cs += L";Connect Retry Count=3";               // idle connection resiliency, not initial connect
    cs += L";Connect Retry Interval=10";
    return cs;
}

// Transient fault codes documented for Azure SQL, plus the resource governance
// codes. Network termination and timeout errors (64, 233, 258, 10053, 10054,
// 10060) are retried a bounded number of times, which is the documented
// guidance for them. 258 is the code the driver reports for a connect timeout.
// 10053 and 10054 can also mean the encryption handshake failed rather than a
// plain network reset, so read the error text before assuming a network fault.
bool IsTransient(LONG nativeError) {
    switch (nativeError) {
        case 615: case 926: case 4060: case 4221:
        case 10928: case 10929: case 10936:
        case 40197: case 40501: case 40613:
        case 42108: case 42109:
        case 49918: case 49919: case 49920:
        case 40020: case 40143: case 40166: case 40540:   // failover subcodes
        case 64: case 233: case 258:
        case 10053: case 10054: case 10060:
            return true;
        default:
            return false;
    }
}

// Retries only errors that a new connection can clear, with exponential backoff
// plus jitter so that concurrent clients don't retry in lockstep.
HRESULT ConnectWithRetry(IDataInitialize* pDataInit, const std::wstring& connectionString,
                         int maxAttempts, IDBInitialize** ppDbInit) {
    HRESULT hr = E_FAIL;
    *ppDbInit = nullptr;
    for (int attempt = 1; attempt <= maxAttempts; ++attempt) {
        IDBInitialize* pDbInit = nullptr;
        hr = pDataInit->GetDataSource(nullptr, CLSCTX_INPROC_SERVER, connectionString.c_str(),
                                      IID_IDBInitialize, reinterpret_cast<IUnknown**>(&pDbInit));
        if (SUCCEEDED(hr) && SUCCEEDED(hr = pDbInit->Initialize())) {
            Log("INFO", "connected on attempt %d/%d", attempt, maxAttempts);
            *ppDbInit = pDbInit;
            return S_OK;
        }

        // Walks IErrorRecords and returns the first record that carries a real
        // SQL Server error number. Transport and timeout failures report a
        // generic wrapper record first, whose native error is 0. Errors the
        // server returns carry the number on the first record.
        LONG native = LogProviderErrors("connect", hr);
        if (pDbInit) pDbInit->Release();
        if (attempt == maxAttempts || !IsTransient(native)) return hr;

        // Cap the backoff at 64 seconds. This also keeps the shift in range
        // when a caller passes a large maxAttempts.
        int shift = (attempt - 1 < 6) ? attempt - 1 : 6;
        DWORD delayMs = (1UL << shift) * 1000UL + (DWORD)(GetTickCount64() % 500);
        Log("WARN", "retrying in %lu ms (attempt %d/%d)", delayMs, attempt + 1, maxAttempts);
        Sleep(delayMs);
    }
    return hr;
}

Connect Retry Count e Connect Retry Interval abilitano la resilienza delle connessioni inattive, che ripristina automaticamente una connessione caduta durante l'inattività. Non riprovano il collegamento iniziale, motivo per cui questo frammento implementa anche il retry a livello di applicazione. Tieni entrambi.

Questo snippet costruisce la sua stringa di connessione per IDataInitialize::GetDataSource, che utilizza i nomi di parole chiave distanziate mostrati qui, come Use Encryption for Data e Connect Retry Count. IDBInitialize::Initialize e ADO usano nomi diversi per le stesse impostazioni, come Encrypt e ConnectRetryCount.

GetDataSource accetta un nome dal set sbagliato senza generare errori, e l'impostazione non si verifica mai. La connessione poi usa il driver predefinito, il che può indebolirla. Encrypt=Strict su questo percorso lascia la crittografia su MandatoryMSOLEDBSQL19, quindi la connessione interrompe TDS 8.0 e negozia la crittografia nel prelogin cleartext, lasciando la crittografia completamente disattivata su MSOLEDBSQL. Non in tutti i casi il sistema passa a una modalità aperta: l'impostazione errata TrustServerCertificate viene scartata allo stesso modo, lasciando la proprietà al valore predefinito false e lasciando attiva la convalida del certificato.

Non fare affidamento su un messaggio di errore per individuare lo sbaglio. Un nome che non appartiene a nessun insieme, come ZzzNotAKeyword, produce un Invalid stringa di connessione attribute record, ma un nome proveniente dall'insieme sbagliato non produce nulla. Per confermare che un'impostazione abbia avuto effetto, leggi nuovamente la proprietà con IDBProperties::GetProperties prima di connetterti. Per il set di parole chiave che accompagna ogni API, vedi Using stringa di connessione keywords with OLE DB Driver per SQL Server.

OLE DB fornisce le informazioni diagnostiche tramite l'oggetto errore anziché tramite il solo HRESULT, quindi classifica gli errori prima di riprovare. Un errore di autenticazione o di configurazione provoca un fallimento immediato, anziché consumare l'intero limite di tentativi.

Per altre informazioni su ogni parte di questa configurazione, vedere:

• Uso delle parole chiave delle stringhe di connessione con OLE DB Driver per SQL Server
• Come usare Microsoft Entra ID
• Crittografia e convalida di certificati
• Resilienza della connessione inattiva
• OLE DB Driver per SQL Server supporto per alta disponibilità, ripristino di emergenza

Per il catalogo degli errori transitori di Azure SQL, vedere codici di errore transitorio.

Funzionalità principali

• Autenticazione Microsoft Entra ID: Connessioni senza password con identità gestita, service principal, flussi interattivi e integrati.
• Crittografia rigorosa: connessioni TDS 8.0 con validazione completa dei certificati, e TLS 1.3 nella versione 19.2.0 e successive.
• Resilienza della connessione inattiva: Ripristino trasparente di una connessione che si è interrotta mentre era inattiva.
• Set di risultati attivi multipli (MARS): più di una richiesta in sospeso per una connessione.
• Copia in massa: inserti ad alta produttività tramite le interfacce di copia in massa.
• Parametri a valori di tabella: un intero set di risultati passato al server come un singolo parametro.
• Gruppi di disponibilità Always On: supporto del listener con MultiSubnetFailover per il failover rapido.
• Supporto per UTF-8 e UTF-16: Dati di caratteri in entrambe le codifiche.
• Classificazione dei dati: Metadati di sensibilità per colonne classificate.
• Operazioni asincrone: operazioni di sorgenti dati non bloccanti e di set di righe.

Inizia subito

Configurazione e connessione

Autenticazione e sicurezza

Eseguire comandi e processare i risultati

Lavorare con righe e cursori

Copia in blocco

Parametri con valori di tabella

Lavoro con dati grandi e binari

Gestione di tabelle, indici e procedure memorizzate

Tipi di dati

Transactions

Diagnosticare e risolvere i problemi

Migra al driver corrente

Esistono tre generazioni di provider Microsoft OLE DB per SQL Server. Usa MSOLEDBSQL19 per le applicazioni nuove ed esistenti e converti in MSOLEDBSQL19 le stringhe di connessione esistenti. Il provider OLE DB non è più stato considerato deprecato ed è stato rilasciato nuovamente nel 2018.

Reference

Contenuti correlati

• Matrice di supporto alle funzionalità dei driver
• Descrizione del ciclo di vita di SNAC