Requisitos del sistema, instalación y archivos del controlador
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. 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 |
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.4 | Sí | Sí | Sí | Sí | Sí | Sí | Sí | Sí | ||||
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.4 | Sí | Sí | Sí | Sí | Sí | ||||||
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 omsodbcsql17.dll omsodbcsql13.dll omsodbcsql11.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 omsodbcdiag17.dll omsodbcdiag13.dll omsodbcdiag11.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 omsodbcsqlr17.rll omsodbcsqlr13.rll omsodbcsqlr11.rll |
El archivo de recursos asociado de la biblioteca de controladores. Este archivo se instala en %SYSTEMROOT%\System32\1033 . |
s13ch_msodbcsql.chm os11ch_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 omsodbcsql17.lib omsodbcsql13.lib omsodbcsql11.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 . |