Controlador Microsoft OLE DB para SQL Server

Descargar controlador OLE DB

El Microsoft OLE DB Driver for SQL Server es una interfaz de programación de aplicaciones (API) independiente para acceso a datos que forma parte de OLE DB. Conecta aplicaciones en C y C++ con el Microsoft SQL Motor de base de datos en Azure SQL Database, la base de datos SQL en Microsoft Fabric, Azure SQL Managed Instance y en versiones compatibles de SQL Server. Microsoft lo lanzó por primera vez en 2018 como versión 18 e incluyó en SQL Server 2019 (15.x).

MSOLEDBSQL19 es el controlador actual. Generalmente es compatible hacia atrás con SQL Server Native Client (SNAC), y ofrece funcionalidades más allá de SNAC y del proveedor de SQL Server OLE DB que proporciona Windows Data Access Components (Windows DAC, anteriormente Microsoft Data Access Components, o MDAC).

Elija el punto de partida.

• Para decidir si OLE DB es la API adecuada para tu aplicación, empieza con Cuándo usar OLE DB Driver for SQL Server.
• Para instalar el controlador y empezar a escribir código, ve a Descargar OLE DB Driver for SQL Server, Requisitos del sistema y Construcción de aplicaciones con OLE DB Driver for SQL Server.
• Para conectarse a Azure SQL con autenticación sin contraseña, vaya a Uso de Microsoft Entra ID y Uso de palabras clave de la cadena de conexión.
• Para pasar de SQLNCLI o SQLOLEDB, consulta Actualizar una aplicación de MDAC a OLE DB Driver for SQL Server y Principales diferencias entre versiones.
• Para usar el controlador de ADO, ve a Usando ADO con OLE DB Driver for SQL Server.
• Para diagnosticar un problema de conexión o consulta, ve a Acceder a información de diagnóstico en el registro de eventos extendido y Problemas conocidos.

Línea base de producción para Azure SQL

Use este fragmento de código como punto de partida para una conexión Azure SQL orientada a producción. Carga el nombre del servidor y el nombre de la base de datos desde la configuración de la aplicación, se autentica con una identidad gestionada para que no aparezca ningún secreto en la cadena de conexión, y permite el cifrado Tabular Data Stream (TDS) 8.0 con validación completa del certificado. Establece un tiempo de espera para la conexión en cada intento y reintenta los errores transitorios con retardo exponencial y variación aleatoria.

El fragmento de C++ de este artículo omite las directivas `#include`, la inicialización de COM y la función auxiliar de registro por motivos de brevedad.

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 y Connect Retry Interval habilitan la resistencia de las conexiones inactivas, que restaura de forma transparente una conexión interrumpida durante la inactividad. No vuelven a intentar la conexión inicial, por eso este fragmento también implementa reintentos a nivel de aplicación. Conservar ambos.

Este fragmento construye su cadena de conexión para IDataInitialize::GetDataSource, que utiliza los nombres de palabras clave espaciadas que se muestran aquí, como Use Encryption for Data y Connect Retry Count. IDBInitialize::Initialize y ADO usan nombres diferentes para los mismos ajustes, como Encrypt y ConnectRetryCount.

GetDataSource acepta un nombre del conjunto equivocado sin generar errores, y la configuración nunca se aplica. La conexión pasa entonces a usar el controlador predeterminado, lo que puede debilitarla. Encrypt=Strict en esta ruta deja el cifrado en Mandatory en MSOLEDBSQL19, por lo que la conexión descarta TDS 8.0 y negocia el cifrado en texto claro durante la fase previa al inicio de sesión, y deja el cifrado totalmente desactivado en MSOLEDBSQL. No todos los casos fallan abiertos: el conjunto TrustServerCertificate incorrecto se descarta de la misma manera, lo que deja la propiedad en su estado predeterminado false y mantiene activada la validación del certificado.

No cuentes con un error para detectarlo. Un nombre que no pertenece a ningún conjunto, como ZzzNotAKeyword, produce un Invalid cadena de conexión attribute registro, pero un nombre del conjunto equivocado no produce nada. Para confirmar que una configuración surtió efecto, vuelve a leer la propiedad con IDBProperties::GetProperties antes de conectarte. Para consultar el conjunto de palabras clave que acompaña a cada API, vea Uso de palabras clave de cadena de conexión con OLE DB Driver for SQL Server.

OLE DB informa de diagnósticos a través del objeto de error en lugar de solo HRESULT , por lo que clasifica los fallos antes de intentarlo de nuevo. Entonces, un error de autenticación o de configuración provoca un fallo inmediato en lugar de consumir todo el presupuesto total de reintentos.

Para obtener más información sobre cada parte de esta configuración, consulte:

• Uso de palabras clave de cadena de conexión con el controlador OLE DB para SQL Server
• Uso de Microsoft Entra ID
• Cifrado y validación de certificados
• Resiliencia de la conexión en reposo
• Soporte para alta disponibilidad y recuperación ante desastres del controlador OLE DB Driver for SQL Server

Para el catálogo de errores transitorios de Azure SQL, véase códigos de error de fallo transitorio.

Características clave

• Autenticación Microsoft Entra ID: Conexiones sin contraseña con identidad gestionada, principal de servicio, flujos interactivos e integrados.
• Cifrado estricto: conexiones TDS 8.0 con validación completa de certificados, y TLS 1.3 en la versión 19.2.0 y versiones posteriores.
• Resiliencia de la conexión en reposo: Restauración transparente de una conexión que se cayó mientras estaba inactiva.
• Múltiples conjuntos de resultados activos (MARS): Más de una solicitud pendiente por conexión.
• Copia masiva: insertos de alto rendimiento a través de las interfaces de copia masiva.
• Parámetros con valores de tabla: Un conjunto completo de resultados pasado al servidor como un solo parámetro.
• Grupos de disponibilidad Always On: compatibilidad con MultiSubnetFailover para la conmutación por error rápida.
• Soporte UTF-8 y UTF-16: datos de caracteres en ambas codificaciones.
• Clasificación de datos: Metadatos de sensibilidad para columnas clasificadas.
• Operaciones asíncronas: Operaciones de fuente de datos y conjunto de filas no bloqueantes.

Empieza ahora

Configuración y conexión

Autenticar y asegurar

Ejecutar comandos y procesar resultados

Trabajar con conjuntos de filas y cursores

Copia masiva

Parámetros con valores de tabla

Trabajo con datos grandes y binarios

Gestionar tablas, índices y procedimientos almacenados

Tipos de datos

Transactions

Diagnóstico y solución de problemas

Migrar al controlador actual

Existen tres generaciones de proveedores de Microsoft OLE DB para SQL Server. Usa MSOLEDBSQL19 para aplicaciones nuevas y existentes, y convierte las cadenas de conexión existentes para usarlo. El proveedor OLE DB quedó obsoleto y se volvió a lanzar en 2018.

Reference

Contenido relacionado

• Matriz de compatibilidad de funciones del controlador
• Ciclo de vida de SNAC explicado