Microsoft OLE DB-stuurprogramma voor SQL Server

OLE DB-stuurprogramma downloaden

De Microsoft OLE DB Driver for SQL Server is een zelfstandige data-toegangsapplicatie-programmeerinterface (API) die deel uitmaakt van OLE DB. Het verbindt C- en C++-applicaties met de Microsoft SQL Database Engine in Azure SQL Database, SQL-database in Microsoft Fabric, Azure SQL Managed Instance, en in ondersteunde versies van SQL Server. Microsoft bracht het voor het eerst uit in 2018 als versie 18 en nam het op in SQL Server 2019 (15.x).

MSOLEDBSQL19 is de huidige bestuurder. Het is over het algemeen achterwaarts compatibel met SQL Server Native Client (SNAC) en biedt functionaliteit die verder gaat dan zowel SNAC als de SQL Server OLE DB-provider die Windows Data Access Components (Windows DAC, voorheen Microsoft Data Access Components of MDAC) levert.

Uw beginpunt kiezen

• Om te bepalen of OLE DB de juiste API is voor jouw applicatie, begin je met Wanneer je de OLE DB Driver for SQL Server moet gebruiken.
• Om de driver te installeren en te beginnen met het schrijven van code, ga je naar Download OLE DB Driver for SQL Server, System Requirements en Building applications with OLE DB Driver for SQL Server.
• Om verbinding te maken met Azure SQL met wachtwoordloze authenticatie, ga naar Using Microsoft Entra ID en Using verbindingsreeks keywords.
• Om van SQLNCLI of SQLOLEDB over te stappen, raadpleegt u Updating an application to OLE DB Driver for SQL Server from MDAC en Major version differences.
• Om de driver van ADO te gebruiken, ga je naar Using ADO with OLE DB Driver for SQL Server.
• Om een verbindings- of queryprobleem te diagnosticeren, ga je naar Toegang tot diagnostische informatie in het uitgebreide gebeurtenislogboek en Bekende problemen.

Productiebasislijn voor Azure SQL

Gebruik dit fragment als uitgangspunt voor een productiegerichte Azure SQL-verbinding. Het laadt de servernaam en databasenaam vanuit applicatieconfiguratie, authenticeert met een beheerde identiteit zodat er geen geheim in de verbindingsreeks verschijnt, en schakelt Tabular Data Stream (TDS) 8.0-encryptie in met volledige certificaatvalidatie. Hiermee wordt per poging een time-out voor het maken van verbinding ingesteld, en bij tijdelijke fouten wordt opnieuw geprobeerd met exponentiële back-off en jitter.

Het C++-fragment in dit artikel laat include-directives, COM-initialisatie en de loghelper weg omwille van de beknoptheid.

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 en Connect Retry Interval maken veerkracht van een inactieve verbinding mogelijk, waarmee een verbinding die wegviel terwijl deze inactief was, transparant wordt hersteld. Ze proberen de initiële verbinding niet opnieuw, daarom implementeert dit fragment ook opnieuw proberen op applicatieniveau. Hou ze allebei.

Dit fragment bouwt zijn verbindingsreeks voor IDataInitialize::GetDataSource, die gebruikmaakt van de hier getoonde spreide trefwoordnamen, zoals Use Encryption for Data en Connect Retry Count. IDBInitialize::Initialize en ADO gebruiken verschillende namen voor dezelfde instellingen, zoals Encrypt en ConnectRetryCount.

GetDataSource accepteert een naam uit de verkeerde set zonder fout te veroorzaken, en de instelling treedt nooit in werking. De verbinding gebruikt dan de standaard driver, wat deze kan verzwakken. Encrypt=Strict op dit pad blijft de encryptie op Mandatory , MSOLEDBSQL19dus de verbinding laat TDS 8.0 vallen en onderhandelt de encryptie in de cleartext-prelogin, en laat de encryptie volledig uitgeschakeld op MSOLEDBSQL. Niet elk geval resulteert in een open fail: de onjuiste waarde TrustServerCertificate wordt op dezelfde manier genegeerd, waardoor de eigenschap op de standaardwaarde false blijft staan en certificaatvalidatie ingeschakeld blijft.

Reken er niet op dat een foutmelding de vergissing zal signaleren. Een naam die tot geen enkele verzameling behoort, zoals ZzzNotAKeyword, levert een Invalid verbindingsreeks attribute record op, maar een naam uit de verkeerde verzameling levert niets op. Om te controleren of een instelling van kracht is geworden, lees je de eigenschap opnieuw uit met IDBProperties::GetProperties voordat je verbinding maakt. Voor de trefwoordset die bij elke API hoort, zie Gebruik van verbindingsreeks keywords met OLE DB Driver for SQL Server.

OLE DB rapporteert diagnostiek via het foutobject in plaats van alleen het HRESULT foutobject, dus classificeer fouten voordat je het opnieuw probeert. Een authenticatie- of configuratiefout mislukt dan direct in plaats van het hele retrybudget te verbruiken.

Zie voor meer informatie over elk onderdeel van deze configuratie:

• Verbindingsstring-sleutelwoorden gebruiken met OLE DB Driver voor SQL Server
• Microsoft Entra-id gebruiken
• Versleuteling en certificaatvalidatie
• Idle verbindingsveerkracht
• OLE DB Driver voor SQL Server: ondersteuning van hoge beschikbaarheid en noodherstel

Voor de catalogus van Azure SQL tijdelijke fouten, zie tijdelijke foutcodes.

Belangrijkste kenmerken

• Microsoft Entra ID-authenticatie: Wachtwoordloze verbindingen met beheerde identiteit, service principal, interactieve en geïntegreerde stromen.
• Strikte encryptie: TDS 8.0-verbindingen met volledige certificaatvalidatie, en TLS 1.3 in versie 19.2.0 en latere versies.
• Veerkracht bij inactieve verbindingen: Transparant herstellen van een verbinding die werd verbroken terwijl deze inactief was.
• Meerdere actieve resultaatsets (MARS): Meer dan één in behandeling zijnde opdracht per verbinding.
• Bulkkopie: Invoegingen met hoge verwerkingssnelheid via de bulkkopie-interfaces.
• Parameters met tabelwaarde: Een volledige resultaatset die als één enkele parameter aan de server wordt doorgegeven.
• Always On beschikbaarheidsgroepen: ondersteuning voor listeners met MultiSubnetFailover voor snelle failover.
• UTF-8 en UTF-16 ondersteuning: Karaktergegevens in beide coderingen.
• Dataclassificatie: Gevoeligheidsmetadata voor geclassificeerde kolommen.
• Asynchrone bewerkingen: niet-blokkerende databron- en rijsetoperaties.

Aan de slag

Configureren en verbinding maken

Authenticeren en beveiligen

Voer commando's uit en verwerk resultaten

Werk met rijsets en cursors

Bulksgewijs kopiëren

Parameters met tabelwaarde

Werk met grote en binaire data

Beheer tabellen, indexen en opgeslagen procedures

Gegevenstypen

Transactions

Diagnosticeren en problemen oplossen

Migreren naar de huidige driver

Er zijn drie generaties Microsoft OLE DB-aanbieders voor SQL Server. Gebruik MSOLEDBSQL19 voor nieuwe en bestaande applicaties en zet bestaande verbindingsstrings ernaar om. De OLE DB-provider werd in 2018 niet langer als verouderd beschouwd en opnieuw uitgebracht.

Reference

Verwante inhoud

• Driverfunctieondersteuningsmatrix
• De levenscyclus van SNAC uitgelegd