Microsoft OLE DB ドライバー for SQL Server

OLE DB ドライバーのダウンロード

Microsoft OLE DB Driver for SQL ServerはOLE DBの一部であるスタンドアロンのデータアクセスアプリケーションプログラミングインターフェース(API)です。 C および C++ アプリケーションを、Azure SQL Database、Microsoft Fabric の SQL データベース、Azure SQL Managed Instance、およびサポートされているバージョンの SQL Server に含まれる Microsoft SQL データベース エンジン に接続できるようにします。 Microsoftは2018年にバージョン18として初めてリリースし、SQL Server 2019(15.x)に含めました。

MSOLEDBSQL19 が現在のドライバーです。 通常、SQL Server Native Client（SNAC）との後方互換性があり、SNAC と、Windows Data Access Components（Windows DAC、旧称 Microsoft Data Access Components（MDAC））が提供する SQL Server OLE DB プロバイダーの両方を上回る機能を提供します。

出発点を選択する

• OLE DBがあなたのアプリケーションに適したAPIかどうか判断するには、「SQL ServerにOLE DB Driver for SQL Serverを使うタイミング」から始めてください。
• ドライバーをインストールしコードを書き始めるには、「OLE DB Driver for SQL Server、システム要件、アプリケーション構築を OLE DB Driver for SQL Server で作成」からアクセスしてください。
• パスワードレス認証でAzure SQLに接続するには、「Using Microsoft Entra ID and Using 接続文字列 keywords」に行ってください。
• SQLNCLIやSQLOLEDBから移行するには、「MDACとメジャーバージョンの違いからアプリケーションをOLE DB Driver for SQL Serverに更新する」に行ってください。
• ADOのドライバーを使うには、「OLE DB Driver for SQL ServerでADOを使う」へ行ってください。
• 接続やクエリの問題を診断するには、「 拡張イベントログの診断情報へのアクセス 」と 「既知の問題」へ行ってください。

Azure SQLの運用ベースライン

このスニペットは、運用環境向けのAzure SQL接続の開始点として使用します。 アプリケーション設定からサーバー名とデータベース名を読み込み、管理型IDで認証して接続文字列に秘密が現れないようにし、完全な証明書検証付きTabular Data Stream(TDS)8.0暗号化を有効にします。 試行ごとに接続タイムアウトを設定し、一時的な障害が発生した場合は、指数バックオフとジッターを用いて再試行します。

この記事のC++スニペットでは、簡潔にするためにinclude、COM初期化、ログヘルパーを省略しています。

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 Connect Retry Intervalまた、アイドル接続のレジリエンシーを有効にし、アイドル中に切断された接続を透過的に復元します。 彼らは最初の接続を再試行しないため、このスニペットはアプリケーションレベルの再試行も実装しています。 両方持っておけ。

このスニペットは、Use Encryption for Data や Connect Retry Count など、ここに示すスペース入りのキーワード名を使用する IDataInitialize::GetDataSource 用の接続文字列を構築します。 IDBInitialize::Initialize ADOは同じ設定に対して異なる名称を使い、例えば Encrypt や ConnectRetryCountなどがあります。

GetDataSource 誤った集合から名前をエラーなしで受け入れ、設定は決して効果を発揮しません。 その場合、接続ではドライバーのデフォルト設定が使用されるため、接続の安全性が低下することがあります。 Encrypt=Strictこの経路では、Mandatory では暗号化が MSOLEDBSQL19 の設定のままになるため、接続では TDS 8.0 は使用されず、平文の事前ログイン時に暗号化がネゴシエートされ、MSOLEDBSQL では暗号化が完全にオフのままになります。 すべてのケースがフェイルオープンになるわけではありません。誤って設定された TrustServerCertificate も同様に破棄されるため、プロパティは既定値の false のままとなり、証明書の検証は有効のままです。

ミスの発見をエラーに頼らないでください。 ZzzNotAKeywordのように、どの集合にも属さない名前は記録Invalid 接続文字列 attributeを生みますが、間違った集合の名前は何も生成しません。 設定が有効かどうかを確認するために、接続前にプロパティを読み返して IDBProperties::GetProperties してください。 各APIに対応するキーワードセットについては、「OLE DB Driver for SQL Server で接続文字列 keywordsの使用」を参照してください。

OLE DBは HRESULT だけでなくエラーオブジェクトを通じて診断を報告するため、再試行前に故障を分類します。 認証や設定エラーが即座に失敗し、再試行予算を全消費することはありません。

この構成の各部分の詳細については、以下を参照してください。

• OLE DB Driver for SQL Server での接続文字列キーワードの使用
• Microsoft Entra ID を使用する
• 暗号化と証明書の検証
• アイドル状態の接続回復性
• SQL Server 用 OLE DB Driver での高可用性および災害復旧のサポート

Azure SQLの一時的エラーのカタログについては、一時的故障エラーコードを参照してください。

主要な機能

• Microsoft Entra ID認証:パスワードレス接続で、管理されたアイデンティティ、サービスプリンシパル、インタラクティブ、統合フローが利用できます。
• 厳密暗号化:TDS 8.0接続で完全な証明書検証が可能で、バージョン19.2.0以降のTLS 1.3が適用されます。
• アイドル接続の回復力:アイドル中に切断された接続の透明な復旧。
• 複数のアクティブ結果セット(MARS):1つの接続に複数の保留中のリクエストがある場合。
• バルクコピー:バルクコピーインターフェースを通じた高スループットの挿入。
• テーブル値パラメータ:サーバーに単一のパラメータとして渡される結果セット全体。
• 常時オンの可用性グループ:迅速なフェイルオーバーのための MultiSubnetFailover リスナーサポート。
• UTF-8およびUTF-16のサポート:両方のエンコーディングで文字データ。
• データ分類:分類された列の感度メタデータ。
• 非同期操作:非ブロッキングデータソースおよび行セット操作。

概要

構成と接続

認証とセキュリティ

実行コマンドと処理結果

行セットとカーソルを使用する

一括コピー

テーブル値パラメーター

大規模およびバイナリデータの扱い

テーブル、インデックス、ストアドプロシージャの管理

データの種類

Transactions

診断とトラブルシューティング

現在のドライバーに移行する

SQL Server向けのMicrosoft OLE DBプロバイダーには3つの世代があります。 新規および既存のアプリケーションには MSOLEDBSQL19 を使い、既存の接続文字列を変換してください。 OLE DB プロバイダーは 2018 年に 非推奨が解除され、再リリースされました。

Reference

関連コンテンツ

• ドライバー機能サポートマトリックス
• SNAC ライフサイクルの説明