Sterownik OLE DB firmy Microsoft dla programu SQL Server

pobierz sterownik OLE DB

Microsoft OLE DB Driver for SQL Server to samodzielny interfejs programowania aplikacji (API) do dostępu do danych, będący częścią OLE DB. Łączy aplikacje C i C++ z Microsoft SQL Database Engine w Azure SQL Database, bazą SQL w Microsoft Fabric, Azure SQL Managed Instance oraz w obsługiwanych wersjach SQL Server. Microsoft po raz pierwszy wydał go w 2018 roku jako wersję 18 i dołączył do SQL Server 2019 (15.x).

MSOLEDBSQL19 jest obecnym kierowcą. Zazwyczaj jest kompatybilny wstecznie z SQL Server Native Client (SNAC) i oferuje funkcje wykraczające poza SNAC oraz dostawcę OLE DB SQL Server, który oferuje Windows Data Access Components (Windows DAC, dawniej Microsoft Data Access Components lub MDAC).

Wybieranie punktu początkowego

• Aby zdecydować, czy OLE DB to odpowiednie API dla Twojej aplikacji, zacznij od Kiedy używać sterownika OLE DB Driver for SQL Server.
• Aby zainstalować sterownik i zacząć pisać kod, przejdź do Pobierz OLE DB Driver for SQL Server, Wymagania systemowe oraz Budowanie aplikacji z OLE DB Driver for SQL Server.
• Aby połączyć się z usługą Azure SQL przy użyciu uwierzytelniania bezhasłowego, przejdź do Korzystanie z Microsoft Entra ID i Korzystanie ze słów kluczowych parametrów połączenia.
• Aby przejść z SQLNCLI lub SQLOLEDB, przejdź do Aktualizowanie aplikacji do OLE DB Driver for SQL Server z MDAC i Główne różnice między wersjami.
• Aby użyć sterownika z ADO, przejdź do Using ADO with OLE DB Driver for SQL Server.
• Aby zdiagnozować problem z połączeniem lub zapytaniem, przejdź do Dostępu do informacji diagnostycznych w rozszerzonym dzienniku zdarzeń oraz Znane problemy.

Plan bazowy produkcji dla Azure SQL

Użyj tego fragmentu kodu jako punktu wyjścia dla połączenia zorientowanego na środowisko produkcyjne Azure SQL. Ładuje nazwę serwera i nazwę bazy danych z konfiguracji aplikacji, uwierzytelnia się za pomocą zarządzanej tożsamości, aby żadna tajemnica nie pojawiała się w parametry połączenia, oraz umożliwia szyfrowanie Tabular Data Stream (TDS) 8.0 z pełną weryfikacją certyfikatów. Ustawia limit czasu dla każdej próby połączenia i ponawia próby w przypadku przejściowych błędów, stosując wykładniczo wydłużany czas ponawiania i losowy rozrzut.

Fragment kodu C++ w tym artykule pomija dyrektywy #include, inicjalizację COM oraz pomocniczą funkcję logowania dla zachowania zwięzłości.

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 oraz Connect Retry Interval umożliwiają odporność połączenia w stanie bezczynności, co automatycznie przywraca połączenie przerwane w stanie bezczynności. Nie ponawiają początkowej próby połączenia, dlatego ten fragment implementuje także mechanizm ponawiania na poziomie aplikacji. Zachowaj oba.

Ten fragment kodu tworzy swój ciąg połączenia dla IDataInitialize::GetDataSource, który używa nazw słów kluczowych zawierających spacje, pokazanych tutaj, takich jak Use Encryption for Data i Connect Retry Count. IDBInitialize::Initialize a ADO używają różnych nazw dla tych samych ustawień, takich jak Encrypt i ConnectRetryCount.

GetDataSource przyjmuje nazwę z niewłaściwego zbioru, nie zgłaszając błędu, a ustawienie nigdy nie zaczyna obowiązywać. Połączenie wtedy korzysta z domyślnego sterownika, co może je osłabić. Encrypt=Strictna tej ścieżce pozostawia szyfrowanie na Mandatory na MSOLEDBSQL19, więc połączenie rezygnuje z TDS 8.0 i negocjuje szyfrowanie w fazie prelogin przesyłanej otwartym tekstem, a na MSOLEDBSQL pozostawia szyfrowanie całkowicie wyłączone. Nie każdy przypadek kończy się trybem fail-open: nieprawidłowo ustawiona wartość TrustServerCertificate jest odrzucana w ten sam sposób, co pozostawia właściwość przy domyślnej wartości false i pozostawia włączoną walidację certyfikatów.

Nie licz na błąd, który go wykryje. Nazwa, która nie należy do żadnego zbioru, taka jak ZzzNotAKeyword, powoduje utworzenie rekordu Invalid parametry połączenia attribute, ale nazwa z błędnego zbioru nie powoduje utworzenia żadnego rekordu. Aby potwierdzić, że ustawienie zostało zastosowane, odczytaj ponownie właściwość za pomocą IDBProperties::GetProperties przed nawiązaniem połączenia. Informacje o zestawie słów kluczowych używanych z każdym interfejsem API można znaleźć w artykule Using parametry połączenia keywords with OLE DB Driver for SQL Server.

OLE DB zgłasza informacje diagnostyczne za pośrednictwem obiektu błędu, a nie tylko przez samo HRESULT, dlatego przed ponowną próbą sklasyfikuj niepowodzenia. Wtedy błąd uwierzytelniania lub konfiguracji od razu kończy się niepowodzeniem, zamiast wyczerpywać cały limit ponownych prób.

Aby uzyskać więcej informacji na temat każdej części tej konfiguracji, zobacz:

• Korzystanie ze słów kluczowych parametrów połączenia w sterowniku OLE DB Driver for SQL Server
• Korzystanie z identyfikatora Entra firmy Microsoft
• Szyfrowanie i walidacja certyfikatów
• Odporność na połączenie bezczynne
• Obsługa wysokiej dostępności i odzyskiwania po awarii w sterowniku OLE DB Driver for SQL Server

Aby zobaczyć katalog przejściowych błędów Azure SQL, zobacz kody błędów przejściowych.

Kluczowe funkcje

• Uwierzytelnianie Microsoft Entra ID: połączenia bezhasłowe z zarządzaną tożsamością, zasadą usługi, interaktywnymi i zintegrowanymi przepływami.
• Ścisłe szyfrowanie: połączenia TDS 8.0 z pełną walidacją certyfikatów oraz TLS 1.3 w wersjach 19.2.0 i nowszych.
• Odporność połączenia bezczynnego: Przezroczyste przywrócenie połączenia, które zerwało się podczas bezczynności.
• Wiele aktywnych zestawów wyników (MARS): Więcej niż jedno oczekujące żądanie na połączenie.
• Kopiowanie zbiorcze: Wstawianie danych z dużą przepustowością za pomocą interfejsów kopiowania zbiorczego.
• Parametry tabelowe: Cały zbiór wyników przekazywany serwerowi jako jeden parametr.
• Grupy dostępności Always On: Obsługa listenera z użyciem MultiSubnetFailover w celu szybkiego przełączania awaryjnego.
• Obsługa UTF-8 i UTF-16: Dane znakowe w obu kodowaniach.
• Klasyfikacja danych: Metadane wrażliwości dla kolumn klasyfikowanych.
• Operacje asynchroniczne: Nieblokujące operacje na źródłach danych i zestawach wierszy.

Wprowadzenie

Konfigurowanie i łączenie

Uwierzytelnianie i zabezpieczenie

Wykonaj polecenia i przetwarzaj wyniki

Pracuj z zestawami wierszy i kursorami

Kopiowanie zbiorcze

Parametry tabelaryczne

Praca z dużymi i binarnymi danymi

Zarządzaj tabelami, indeksami i procedurami przechowywanymi

Typy danych

Transactions

Diagnozowanie i rozwiązywanie problemów

Migracja do aktualnego sterownika

Istnieją trzy generacje dostawców Microsoft OLE DB dla SQL Server. Używaj MSOLEDBSQL19 dla nowych i istniejących aplikacji oraz konwertuj istniejące ciągi połączeń na nie. Dostawca OLE DB został przywrócony i ponownie udostępniony w 2018 roku.

Reference

Treści powiązane

• Macierz wsparcia funkcji sterowników
• Wyjaśnienie cyklu życia SNAC