Requisitos del sistema, instalación y archivos del controlador

Artículo
09/21/2023

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 con versiones anteriores con los controladores de cliente existentes. Pero 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	Azure SQL Database	Azure Synapse Analytics	Instancia administrada de Azure SQL	SQL Server 2022	SQL Server 2019	SQL Server 2017	SQL Server 2016	SQL Server 2014	SQL Server 2012	SQL Server 2008 R2	SQL Server 2008	SQL Server 2005
18.3	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
18.2	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
18.1	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
18.0	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
17.10	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
17.9	Sí	Sí	Sí		Sí	Sí	Sí	Sí	Sí
17.8	Sí	Sí	Sí		Sí	Sí	Sí	Sí	Sí
17,7	Sí	Sí	Sí		Sí	Sí	Sí	Sí	Sí
17.6	Sí	Sí	Sí		Sí	Sí	Sí	Sí	Sí
17.5	Sí	Sí	Sí		Sí	Sí	Sí	Sí	Sí
17.4	Sí	Sí	Sí		Sí	Sí	Sí	Sí	Sí
17.3	Sí	Sí	Sí		Sí	Sí	Sí	Sí	Sí	Sí	Sí
17.2	Sí	Sí	Sí			Sí	Sí	Sí	Sí	Sí	Sí
17.1	Sí	Sí	Sí			Sí	Sí	Sí	Sí	Sí	Sí
17,0	Sí	Sí	Sí			Sí	Sí	Sí	Sí	Sí	Sí
13.1						Sí	Sí	Sí	Sí	Sí	Sí
13							Sí	Sí	Sí	Sí	Sí
11								Sí	Sí	Sí	Sí	Sí

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 2022	Windows Server 2019	Windows Server 2016	Windows Server 2012 R2	Windows Server 2012	Windows Server 2008 R2	Windows 11	Windows 10	Windows 8.1	Windows 7	Windows Vista SP2
18.3	Sí	Sí	Sí	Sí			Sí	Sí
18.2	Sí	Sí	Sí	Sí			Sí	Sí
18.1	Sí	Sí	Sí	Sí	Sí		Sí	Sí	Sí
18.0	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í		Sí	Sí	Sí
17.8		Sí	Sí	Sí	Sí			Sí	Sí
17,7		Sí	Sí	Sí	Sí			Sí	Sí
17.6		Sí	Sí	Sí	Sí			Sí	Sí
17.5		Sí	Sí	Sí	Sí			Sí	Sí
17.4		Sí	Sí	Sí	Sí	Sí		Sí	Sí	Sí
17.3		Sí	Sí	Sí	Sí	Sí		Sí	Sí	Sí
17.2			Sí	Sí	Sí	Sí		Sí	Sí	Sí
17.1			Sí	Sí	Sí	Sí		Sí	Sí	Sí
17,0			Sí	Sí	Sí	Sí		Sí	Sí	Sí
13.1			Sí	Sí	Sí	Sí		Sí	Sí	Sí
13					Sí	Sí			Sí	Sí
11					Sí	Sí				Sí	Sí

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

Para aquellos que tengan instalado Driver en la versión 17.1.0.1 o una posterior, se recomienda desinstalarlo manualmente antes de instalar la versión más reciente del controlador.

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 con la misma versión que aparece en el archivo de encabezado y la biblioteca usada 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 (DLL) de la biblioteca de vínculos dinámicos 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 (DLL) de la biblioteca de vínculos dinámicos que contiene toda la interfaz de diagnósticos 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 el controlador ODBC 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 llamar a 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`.

Consulte también

Microsoft ODBC Driver for SQL Server en Windows