Driver do Microsoft OLE DB para SQL Server

Baixar o driver do OLE DB

O Microsoft Driver do OLE DB para SQL Server é uma interface independente de programação de aplicações (API) de acesso a dados que faz parte do OLE DB. Ele conecta aplicações em C e C++ ao Microsoft SQL Mecanismo de Banco de Dados no Banco de Dados SQL do Azure, SQL Database no Microsoft Fabric, Instância Gerenciada de SQL do Azure e em versões suportadas do SQL Server. A Microsoft lançou o jogo pela primeira vez em 2018 como versão 18 e o incluiu no SQL Server 2019 (15.x).

MSOLEDBSQL19 é o driver atual. Em geral, é compatível com versões anteriores do SQL Server Native Client (SNAC) e oferece recursos além dos fornecidos pelo SNAC e pelo provedor OLE DB do SQL Server fornecido pelo Windows Data Access Components (Windows DAC, anteriormente Microsoft Data Access Components, ou MDAC).

Escolha o ponto de partida

• Para decidir se o OLE DB é a API certa para sua aplicação, comece com Quando usar o Driver do OLE DB para SQL Server.
• Para instalar o driver e começar a escrever código, vá em Download Driver do OLE DB para SQL Server, Requisitos do Sistema e Construção de aplicações com Driver do OLE DB para SQL Server.
• Para se conectar ao SQL do Azure com autenticação sem senha, acesse Usar o Microsoft Entra ID e Usar palavras-chave da cadeia de conexão.
• Para migrar de SQLNCLI ou SQLOLEDB, vá em Atualizar uma aplicação para o Driver do OLE DB para SQL Server a partir do MDAC e diferenças principais de versão.
• Para usar o driver do ADO, vá em Usando ADO com o Driver do OLE DB para SQL Server.
• Para diagnosticar um problema de conexão ou consulta, vá em Acessar informações de diagnóstico no log de eventos estendido e Problemas conhecidos.

Linha de base de produção para SQL do Azure

Use esse snippet como ponto de partida para uma conexão de SQL do Azure orientada à produção. Ele carrega o nome do servidor e o nome do banco de dados a partir da configuração da aplicação, autentica com uma identidade gerenciada para que nenhum segredo apareça na cadeia de conexão e permite a criptografia Tabular Data Stream (TDS) 8.0 com validação completa do certificado. Define um tempo limite de conexão por tentativa e repete as tentativas após falhas transitórias com retardo exponencial e jitter.

O trecho em C++ neste artigo omite as diretivas de inclusão, a inicialização de COM e o helper de log por questão de brevidade.

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 habilitam a resiliência de conexão ociosa, que restaura de forma transparente uma conexão que foi perdida enquanto estava ociosa. Eles não fazem nova tentativa de conexão inicial, por isso este trecho também implementa novas tentativas em nível de aplicação. Mantenha ambos.

Esse snippet constrói sua cadeia de conexão para IDataInitialize::GetDataSource, que usa os nomes de palavras-chave espaçados mostrados aqui, como Use Encryption for Data e Connect Retry Count. IDBInitialize::Initialize e ADO usam nomes diferentes para as mesmas configurações, como Encrypt e ConnectRetryCount.

GetDataSource aceita um nome do conjunto errado sem gerar erro, e a configuração nunca entra em vigor. A conexão então usa o driver padrão, o que pode enfraquecê-la. Encrypt=Strict nesse caminho deixa a criptografia em Mandatory em MSOLEDBSQL19, então a conexão cai no TDS 8.0 e negocia a criptografia no pré-login em texto claro, deixando a criptografia totalmente desligada em MSOLEDBSQL. Nem todo caso falha em aberto: o valor incorretamente definido TrustServerCertificate é descartado da mesma forma, o que deixa a propriedade no valor padrão false e mantém a validação do certificado ativada.

Não conte com um erro para identificar o engano. Um nome que não pertence a nenhum conjunto, como ZzzNotAKeyword, produz um Invalid cadeia de conexão attribute registro, mas um nome do conjunto errado não produz nada. Para confirmar que uma configuração foi aplicada, leia a propriedade novamente com IDBProperties::GetProperties antes de se conectar. Para ver o conjunto de palavras-chave associado a cada API, consulte Usando palavras-chave de cadeia de conexão com Driver do OLE DB para SQL Server.

O OLE DB reporta diagnósticos através do objeto de erro em vez do HRESULT isolado, então classifique as falhas antes de tentar novamente. Nesse caso, a operação falha imediatamente devido a um erro de autenticação ou de configuração, em vez de consumir todo o orçamento de retentativas.

Para obter mais informações sobre cada parte dessa configuração, consulte:

• Uso de palavras-chave de cadeia de conexão com o Driver do OLE DB para SQL Server
• Usando Microsoft Entra ID
• Criptografia e validação de certificado
• Resiliência da conexão ociosa
• Suporte do Driver do OLE DB para SQL Server a alta disponibilidade e recuperação de desastres

Para o catálogo de erros transientes do SQL do Azure, veja códigos de erro de falha transitória.

Características principais

• Autenticação Microsoft Entra ID: Conexões sem senha com identidade gerenciada, principal de serviço, fluxos interativos e integrados.
• Criptografia rigorosa: conexões TDS 8.0 com validação completa de certificados, e TLS 1.3 na versão 19.2.0 e versões posteriores.
• Resiliência da conexão ociosa: Restauração transparente de uma conexão que caiu enquanto estava ociosa.
• Múltiplos conjuntos de resultados ativos (MARS): Mais de uma solicitação pendente por conexão.
• Cópia em lote: Inserções de alta vazão por meio das interfaces de cópia em lote.
• Parâmetros com valores de tabela: Um conjunto inteiro de resultados passado para o servidor como um único parâmetro.
• Grupos de disponibilidade Always On: Suporte a listener com MultiSubnetFailover para failover rápido.
• Suporte a UTF-8 e UTF-16: Dados de caracteres em ambas as codificações.
• Classificação de dados: Metadados de sensibilidade para colunas classificadas.
• Operações assíncronas: Operações de fonte de dados e de conjunto de linhas não bloqueantes.

Introdução

Configuração e conexão

Autenticar e proteger

Executar comandos e processar resultados

Trabalhar com conjuntos de linhas e cursores

Cópia em lote

Parâmetros com valor de tabela

Trabalho com dados grandes e binários

Gerenciar tabelas, índices e procedimentos armazenados

Tipos de dados

Transactions

Diagnosticar e solucionar problemas

Migrar para o driver atual

Existem três gerações de provedores Microsoft OLE DB para SQL Server. Use MSOLEDBSQL19 para aplicações novas e existentes, e converta as strings de conexão existentes para ele. O provedor OLE DB foi desatualizado e relançado em 2018.

Reference

Conteúdo relacionado

• Matriz de suporte a recursos de driver
• Ciclo de vida SNAC explicado