Requisitos del sistema, instalación y archivos del controlador

Descargar controlador ODBC

En este artículo se describen los controladores ODBC que se conectan a SQL Server.

Compatibilidad con versiones de SQL

La compatibilidad indica que se ha probado la compatibilidad de un controlador con las versiones existentes de SQL en el momento de la versión del controlador. Por lo general, las versiones de SQL Server intentan mantener la compatibilidad hacia atrás con los controladores de cliente existentes. No obstante, es posible que las nuevas características de las versiones de SQL Server no estén disponibles con controladores de cliente anteriores.

Versión de la base de datos →
↓ Versión del controlador		 Base de datos SQL de Microsoft Fabric Azure SQL Database Azure Synapse Analytics Instancia administrada de Azure SQL SQL Server 2025 SQL Server 2022 SQL Server 2019 SQL Server 2017
18.7 Sí Sí Sí Sí Sí Sí Sí Sí
18.6 Sí Sí Sí Sí Sí Sí Sí Sí
18.5 Sí Sí Sí Sí Sí Sí Sí Sí
18.4 Sí Sí Sí Sí Sí Sí Sí Sí
18.3 Sí Sí Sí Sí Sí Sí Sí
18.2 Sí Sí Sí Sí Sí Sí Sí
18.1 Sí Sí Sí Sí Sí Sí Sí
18.0 Sí Sí Sí Sí Sí Sí Sí
17,11 Sí Sí Sí Sí Sí Sí Sí Sí
17.10 Sí Sí Sí Sí Sí Sí Sí Sí
17.9 Sí Sí Sí Sí Sí
17.8 Sí Sí Sí Sí Sí
17,7 Sí Sí Sí Sí Sí
17.6 Sí Sí Sí Sí Sí
17.5 Sí Sí Sí Sí Sí
17.4 Sí Sí Sí Sí Sí
17.3 Sí Sí Sí Sí Sí
17.2 Sí Sí Sí Sí
17.1 Sí Sí Sí Sí
17,0 Sí Sí Sí Sí
13.1 Sí
13
11

Detalles de la cadena de conexión

El nombre del controlador que especifique en una cadena de conexión es uno de los valores siguientes:

  • ODBC Driver 11 for SQL Server
  • ODBC Driver 13 for SQL Server (para 13 y 13.1)
  • ODBC Driver 17 for SQL Server
  • ODBC Driver 18 for SQL Server

Sistemas operativos admitidos

En la matriz siguiente se indica la compatibilidad de la versión del controlador con las versiones del sistema operativo Windows:

Sistema operativo →
↓ Versión del controlador		 Windows Server 2025 Windows Server 2022 Windows Server 2019 Windows Server 2016 Windows 11
18.7 Sí Sí Sí Sí Sí
18.6 Sí Sí Sí Sí Sí
18.5 Sí Sí Sí Sí Sí
18.4 Sí Sí Sí Sí
18.3 Sí Sí Sí Sí
18.2 Sí Sí Sí Sí
18.1 Sí Sí Sí Sí
18.0 Sí Sí Sí Sí
17.10 Sí Sí Sí Sí Sí
17.9 Sí Sí Sí Sí
17.8 Sí Sí
17,7 Sí Sí
17.6 Sí Sí
17.5 Sí Sí
17.4 Sí Sí
17.3 Sí Sí
17.2 Sí
17.1 Sí
17,0 Sí
13.1 Sí
13
11

Instalación de Microsoft ODBC Driver for SQL Server

El controlador se instala al ejecutar msodbcsql.msi desde una de las Descargas para Windows.

Nota

Se recomienda a los usuarios con driver versión 17.1.0.1 o anterior desinstalar manualmente el controlador existente antes de continuar con la instalación de la versión actualizada.

Compatibilidad con el entorno de ejecución de C

Importante

Una aplicación nativa que utiliza despliegue local para un entorno de ejecución Microsoft Visual C++ antiguo puede forzar que un controlador ODBC más reciente cargue ese tiempo de ejecución en lugar de la versión requerida por el controlador. Por ejemplo, este problema puede ocurrir cuando una aplicación construida con el conjunto de herramientas de la plataforma Visual Studio 2019 (v142) incluye un entorno de ejecución antiguo en el directorio de la aplicación. La desadaptación de versiones puede causar fallos cuando la aplicación carga o utiliza el controlador ODBC.

No uses despliegue local para el entorno de ejecución Visual C++. Si tu aplicación requiere despliegue local, asegúrate de que su tiempo de ejecución sea al menos tan nuevo como las herramientas de compilación más recientes utilizadas para construir cualquier componente de la aplicación, incluido el controlador ODBC. Para más información, véase compatibilidad binaria en C++ entre versiones de Visual Studio: Restricciones.

En paralelo con Native Client

El controlador se puede instalar en paralelo con SQL Server Native Client. También se pueden instalar las versiones principales del controlador (11, 13, 17, 18) en paralelo con las demás.

Cuando se llama a msodbcsql.msi, solo se instalan los componentes de cliente de forma predeterminada. Los componentes de cliente son archivos que permiten ejecutar aplicaciones desarrolladas mediante el controlador. Para instalar los componentes de SDK, especifique ADDLOCAL=ALL en la línea de comandos. Aquí tiene un ejemplo.

msiexec /i msodbcsql.msi ADDLOCAL=ALL

Licencia de usuario final

Especifique IACCEPTMSODBCSQLLICENSETERMS=YES para aceptar los términos de la licencia para el usuario final si utiliza la opción de instalación /passive, /qn, /qb o /qr. Esta opción se debe especificar con todas las letras mayúsculas. Aquí tiene un ejemplo.

msiexec /quiet /passive /qn /i msodbcsql.msi IACCEPTMSODBCSQLLICENSETERMS=YES ADDLOCAL=ALL

Desinstalación silenciosa

En el ejemplo siguiente se muestra cómo se realiza una desinstalación silenciosa.

msiexec /quiet /passive /qn /uninstall msodbcsql.msi

Indicación de dependencia

Cuando una aplicación utiliza el controlador, esta debe indicar que depende del controlador mediante la opción de instalación APPGUID. Esta indicación habilita al instalador del controlador para notificar cuáles son las aplicaciones dependientes antes de que se lleve a cabo la desinstalación. Para especificar una dependencia del controlador, establezca el parámetro de línea de comandos APPGUID en el código de producto cuando se instale en modo silencioso el controlador. Se debe crear un código de producto al usar Microsoft Installer para empaquetar su programa de instalación de la aplicación. Aquí tiene un ejemplo.

msiexec /i msodbcsql.msi APPGUID={ <Your dependent application's APPGUID> }

Herramientas de línea de comandos: sqlcmd.exe y bcp.exe

Las herramientas de bcp.exe y sqlcmd.exe para su uso con el controlador se pueden descargar en Utilidades de la línea de comandos 11 de Microsoft para SQL Server, Utilidades de la línea de comandos 13 de Microsoft para SQL Server o Utilidades de línea de la comandos 13.1 de Microsoft para SQL Server. El controlador es un requisito previo para instalar sqlcmd.exe y bcp.exe.

bcp.exe y sqlcmd.exe se instalan en la subcarpeta 110\Tools de %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC para la versión 11 y 130\Tools para 13 y 13.1.

Las aplicaciones que utilizan funciones BCP deben especificar el controlador de la misma versión, que se entregaron con el archivo de encabezado y la biblioteca usados para compilar la aplicación.

Por ejemplo, cuando compile una aplicación de ODBC con msodbcsql11.lib y msodbcsql.h, use DRIVER={ODBC Driver 11 for SQL Server} en la cadena de conexión.

Componentes de Microsoft ODBC Driver for SQL Server en Windows

El controlador ODBC en Windows contiene los siguientes componentes:

Componente Descripción
msodbcsql18.dll o
msodbcsql17.dll o
msodbcsql13.dll o
msodbcsql11.dll		 El archivo de biblioteca de vínculos dinámicos (DLL) que contiene toda la funcionalidad del controlador. Este archivo se instala en %SYSTEMROOT%\System32.
msodbcdiag18.dll o
msodbcdiag17.dll o
msodbcdiag13.dll o
msodbcdiag11.dll		 El archivo de biblioteca de vínculos dinámicos (DLL) que contiene toda la interfaz de diagnóstico del controlador (seguimiento). Este archivo se instala en %SYSTEMROOT%\System32.
msodbcsqlr18.rll o
msodbcsqlr17.rll o
msodbcsqlr13.rll o
msodbcsqlr11.rll		 El archivo de recursos asociado de la biblioteca de controladores. Este archivo se instala en %SYSTEMROOT%\System32\1033.
s13ch_msodbcsql.chm o
s11ch_msodbcsql.chm		 El archivo de Ayuda del Asistente para orígenes de datos que documenta cómo crear un origen de datos para el controlador. Este archivo se instala en %SYSTEMROOT%\System32\1033.

NOTA: No hay ningún archivo chm para ODBC Driver 17 y versiones posteriores.
msodbcsql.h El archivo de encabezado que contiene todas las definiciones nuevas necesarias para utilizar el controlador.

Nota: No se puede hacer referencia a msodbcsql.h y a odbcss.h en el mismo programa.
msodbcsql.h para ODBC Driver 18 se instala en %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK.
msodbcsql.h para ODBC Driver 17 se instala en %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK.
msodbcsql.h para ODBC Driver 13 se instala en %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK.
msodbcsql.h para ODBC Driver 11 se instala en %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK.
msodbcsql18.lib o
msodbcsql17.lib o
msodbcsql13.lib o
msodbcsql11.lib		 El archivo de biblioteca necesario para invocar las funciones de la utilidad bcp, que forman parte del controlador.

Nota: Si hace referencia a este archivo de biblioteca en el programa, asegúrese de que se encuentra en la ruta de acceso de su sistema y en la de los usuarios que utilicen la aplicación.
msodbcsql18.lib se instala en %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK.
msodbcsql17.lib se instala en %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK.
msodbcsql13.lib se instala en %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK.
msodbcsql11.lib se instala en %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK.

Contenido relacionado

  • Se actualizó por última vez el