Requisitos del sistema para el controlador JDBC
Para usar Microsoft JDBC Driver para SQL Server para acceder a los datos desde SQL Server o mediante Azure SQL Database, debe tener los siguientes componentes instalados en el equipo:
- Microsoft JDBC Driver para SQL Server (descargar)
- Java Runtime Environment
Requisitos de Java Runtime Environment
A partir de Microsoft JDBC Driver 12.8 para SQL Server, se admiten Java Development Kit (JDK) 22.0 y Java Runtime Environment (JRE) 22.0.
A partir de Microsoft JDBC Driver 12.6 para SQL Server, se admiten Java Development Kit (JDK) 21.0 y Java Runtime Environment (JRE) 21.0.
A partir de Microsoft JDBC Driver 12.4 para SQL Server, se admiten Java Development Kit (JDK) 20.0 y Java Runtime Environment (JRE) 20.0.
A partir de Microsoft JDBC Driver 12.2 para SQL Server, se admiten Java Development Kit (JDK) 19.0 y Java Runtime Environment (JRE) 19.0.
A partir de Microsoft JDBC Driver 11.2 para SQL Server, se admiten Java Development Kit (JDK) 18.0 y Java Runtime Environment (JRE) 18.0.
A partir de Microsoft JDBC Driver 10.2 para SQL Server, se admiten Java Development Kit (JDK) 17.0 y Java Runtime Environment (JRE) 17.0.
A partir de Microsoft JDBC Driver 9.4 para SQL Server, se admiten Java Development Kit (JDK) 16.0 y Java Runtime Environment (JRE) 16.0.
A partir de Microsoft JDBC Driver 9.2 para SQL Server, se admiten Java Development Kit (JDK) 15.0 y Java Runtime Environment (JRE) 15.0.
A partir de Microsoft JDBC Driver 8.4 para SQL Server, se admiten Java Development Kit (JDK) 14.0 y Java Runtime Environment (JRE) 14.0.
A partir de Microsoft JDBC Driver 8.2 para SQL Server, se admiten Java Development Kit (JDK) 13.0 y Java Runtime Environment (JRE) 13.0.
A partir de Microsoft JDBC Driver 7.4 para SQL Server, se admiten Java Development Kit (JDK) 12.0 y Java Runtime Environment (JRE) 12.0.
A partir de Microsoft JDBC Driver 7.2 para SQL Server, se admiten Java Development Kit (JDK) 11.0 y Java Runtime Environment (JRE) 11.0.
A partir de Microsoft JDBC Driver 7.0 para SQL Server, se admiten Java Development Kit (JDK) 10.0 y Java Runtime Environment (JRE) 10.0.
A partir de Microsoft JDBC Driver 6.4 para SQL Server, se admiten Java Development Kit (JDK) 9.0 y Java Runtime Environment (JRE) 9.0.
A partir de Microsoft JDBC Driver 4.2 para SQL Server, se admiten Java Development Kit (JDK) 8.0 y Java Runtime Environment (JRE) 8.0. La compatibilidad con la API de especificaciones de JDBC se ha ampliado para incluir la API de JDBC 4.1 y 4.2.
A partir de Microsoft JDBC Driver 4.1 para SQL Server, se admiten Java Development Kit (JDK) 7.0 y Java Runtime Environment (JRE) 7.0.
A partir de Microsoft JDBC Driver 4.0 para SQL Server, la compatibilidad del controlador JDBC con la API de especificaciones de JDBC se ha ampliado para incluir la API de JDBC 4.0. La API de JDBC 4.0 se presentó como parte de Java Development Kit (JDK) 6.0 y de Java Runtime Environment (JRE) 6.0. JDBC 4.0 es un superconjunto de la API de JDBC 3.0.
Cuando se implementa Microsoft JDBC Driver para SQL Server en sistemas operativos Windows y UNIX, se deben usar los paquetes de instalación, sqljdbc_<version>_enu.exe y sqljdbc_<version>_enu.tar.gz, respectivamente. Para obtener más información sobre cómo implementar el controlador JDBC, vea el artículo Implementación del controlador JDBC.
Microsoft JDBC Driver 12.8 para SQL Server:
El controlador JDBC 12.8 incluye dos bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-12.8.0.jre8.jar y mssql-jdbc-12.8.0.jre11.jar.
El controlador JDBC 12.8 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, OpenJDK 21.0, OpenJDK 22.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0, y Azul Zulu JRE 17.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 12.8 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-12.8.0.jre8.jar | 4.2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. |
mssql-jdbc-12.8.0.jre11.jar | 4.3 | 22 | Requiere una versión de Java Runtime Environment (JRE) 11.0 o superior. El uso de JRE 10.0 o anterior lanza una excepción. |
El controlador JDBC Driver 12.8 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>12.8.0.jre11</version>
</dependency>
Microsoft JDBC Driver 12.6 para SQL Server:
El controlador JDBC 12.6 incluye dos bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-12.6.0.jre8.jar y mssql-jdbc-12.6.0.jre11.jar.
El controlador JDBC 12.6 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, OpenJDK 21.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0, y Azul Zulu JRE 17.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 12.6 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-12.6.0.jre8.jar | 4.2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. |
mssql-jdbc-12.6.0.jre11.jar | 4.3 | 21 | Requiere una versión de Java Runtime Environment (JRE) 11.0 o superior. El uso de JRE 10.0 o anterior lanza una excepción. |
El controlador JDBC Driver 12.6 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>12.6.0.jre11</version>
</dependency>
Microsoft JDBC Driver 12.4 para SQL Server:
El controlador JDBC Driver 12.4 incluye dos bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-12.4.0.jre8.jar y mssql-jdbc-12.4.0.jre11.jar.
El controlador JDBC Driver 12.4 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, OpenJDK 20.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0, y Azul Zulu JRE 17.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 12.4 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-12.4.0.jre8.jar | 4.2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. |
mssql-jdbc-12.4.0.jre11.jar | 4.3 | 20 | Requiere una versión de Java Runtime Environment (JRE) 11.0 o superior. El uso de JRE 10.0 o anterior lanza una excepción. |
El controlador JDBC Driver 12.4 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>12.4.0.jre11</version>
</dependency>
Microsoft JDBC Driver 12.2 para SQL Server:
El controlador JDBC Driver 12.2 incluye dos bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-12.2.0.jre8.jar y mssql-jdbc-12.2.0.jre11.jar.
El controlador JDBC Driver 12.2 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, OpenJDK 19.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0, y Azul Zulu JRE 17.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 12.2 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-12.2.0.jre8.jar | 4,2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. |
mssql-jdbc-12.2.0.jre11.jar | 4.3 | 19 | Requiere una versión de Java Runtime Environment (JRE) 11.0 o superior. El uso de JRE 10.0 o anterior lanza una excepción. |
El controlador JDBC Driver 12.2 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>12.2.0.jre11</version>
</dependency>
Microsoft JDBC Driver 11.2 para SQL Server:
JDBC Driver 11.2 incluye tres bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar y mssql-jdbc-11.2.0.jre17.jar y mssql-jdbc-11.2.0.jre18.jar.
JDBC Driver 11.2 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, OpenJDK 18.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0, y Azul Zulu JRE 17.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los cuatro archivos JAR incluidos en Microsoft JDBC Driver 11.2 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-11.2.0.jre8.jar | 4,2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. |
mssql-jdbc-11.2.0.jre11.jar | 4.3 | 11 | Requiere Java Runtime Environment (JRE) 11.0. El uso de JRE 10.0 o anterior lanza una excepción. |
mssql-jdbc-11.2.0.jre17.jar | 4.3 | 17 | Requiere la versión 17.0 de Java Runtime Environment (JRE). El uso de JRE 16.0 o una versión anterior produce una excepción. |
mssql-jdbc-11.2.0.jre18.jar | 4.3 | 18 | Requiere la versión 18.0 de Java Runtime Environment (JRE). El uso de JRE 17.0 o una versión anterior produce una excepción. |
JDBC Driver 11.2 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>11.2.0.jre11</version>
</dependency>
Microsoft JDBC Driver 10.2 para SQL Server:
JDBC Driver 10.2 incluye tres bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar y mssql-jdbc-10.2.0.jre17.jar.
JDBC Driver 10.2 está diseñado para funcionar con todas las máquinas virtuales Java principales y admitirlas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 y Azul Zulu JRE 17.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 10.2 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-10.2.0.jre8.jar | 4,2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. |
mssql-jdbc-10.2.0.jre11.jar | 4.3 | 11 | Requiere Java Runtime Environment (JRE) 11.0. El uso de JRE 10.0 o anterior lanza una excepción. |
mssql-jdbc-10.2.0.jre17.jar | 4.3 | 17 | Requiere la versión 17.0 de Java Runtime Environment (JRE). El uso de JRE 16.0 o una versión anterior produce una excepción. |
JDBC Driver 10.2 está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si con el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>10.2.0.jre11</version>
</dependency>
Microsoft JDBC Driver 9.4 para SQL Server:
JDBC Driver 9.4 incluye tres bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar y mssql-jdbc-9.4.1.jre16.jar.
JDBC Driver 9.4 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 16.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 y Azul Zulu JRE 16.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 9.4 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-9.4.1.jre8.jar | 4,2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. |
mssql-jdbc-9.4.1.jre11.jar | 4.3 | 11 | Requiere Java Runtime Environment (JRE) 11.0. El uso de JRE 10.0 o anterior lanza una excepción. |
mssql-jdbc-9.4.1.jre16.jar | 4.3 | 16 | Requiere la versión 16.0 de Java Runtime Environment (JRE). El uso de JRE 15.0 o una versión anterior lanza una excepción. |
JDBC Driver 9.4 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>9.4.1.jre11</version>
</dependency>
Microsoft JDBC Driver 9.2 para SQL Server:
JDBC Driver 9.2 incluye tres bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar y mssql-jdbc-9.2.1.jre15.jar.
JDBC Driver 9.2 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 15.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 y Azul Zulu JRE 15.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 9.2 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-9.2.1.jre8.jar | 4,2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. Las nuevas características de la versión 9.2 incluyen lo siguiente: compatibilidad con JDK 15, compatibilidad con la autenticación interactiva de Azure Active Directory, compatibilidad con la autenticación de la entidad de servicio de Azure Active Directory y compatibilidad con useBulkCopyForBatchInsert para servidores que no son de Azure Synapse Analytics. |
mssql-jdbc-9.2.1.jre11.jar | 4.3 | 11 | Requiere Java Runtime Environment (JRE) 11.0. El uso de JRE 10.0 o anterior lanza una excepción. Las nuevas características de la versión 9.2 incluyen lo siguiente: compatibilidad con JDK 15, compatibilidad con la autenticación interactiva de Azure Active Directory, compatibilidad con la autenticación de la entidad de servicio de Azure Active Directory y compatibilidad con useBulkCopyForBatchInsert para servidores que no son de Azure Synapse Analytics. |
mssql-jdbc-9.2.1.jre15.jar | 4.3 | 15 | Requiere la versión 15.0 de Java Runtime Environment (JRE). El uso de JRE 14.0 o una versión anterior lanza una excepción. Las nuevas características de la versión 9.2 incluyen lo siguiente: compatibilidad con JDK 15, compatibilidad con la autenticación interactiva de Azure Active Directory, compatibilidad con la autenticación de la entidad de servicio de Azure Active Directory y compatibilidad con useBulkCopyForBatchInsert para servidores que no son de Azure Synapse Analytics. |
JDBC Driver 9.2 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>9.2.1.jre11</version>
</dependency>
Microsoft JDBC Driver 8.4 para SQL Server:
El controlador JDBC Driver 8.4 incluye tres bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar y mssql-jdbc-8.4.1.jre14.jar.
JDBC Driver 8.4 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 14.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 y Azul Zulu JRE 14.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 8.4 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-8.4.1.jre8.jar | 4,2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. Las nuevas características de la versión 8.4 incluyen lo siguiente: compatibilidad con JDK 14, compatibilidad con la autenticación en Azure Key Vault mediante la identidad administrada, soporte extendido para la copia masiva de Almacenamiento de datos de Azure, almacenamiento en caché de DNS de SQL Azure, compatibilidad con versiones anteriores para hacer streaming de objetos LOB y autenticación de certificado de cliente para escenarios de bucles invertidos. |
mssql-jdbc-8.4.1.jre11.jar | 4.3 | 11 | Requiere Java Runtime Environment (JRE) 11.0. El uso de JRE 10.0 o anterior lanza una excepción. Las nuevas características de la versión 8.4 incluyen lo siguiente: compatibilidad con JDK 14, compatibilidad con la autenticación en Azure Key Vault mediante la identidad administrada, soporte extendido para la copia masiva de Almacenamiento de datos de Azure, almacenamiento en caché de DNS de SQL Azure, compatibilidad con versiones anteriores para hacer streaming de objetos LOB y autenticación de certificado de cliente para escenarios de bucles invertidos. |
mssql-jdbc-8.4.1.jre13.jar | 4.3 | 14 | Requiere la versión 14.0 de Java Runtime Environment (JRE). El uso de JRE 13.0 o anterior lanza una excepción. Las nuevas características de la versión 8.4 incluyen lo siguiente: compatibilidad con JDK 14, compatibilidad con la autenticación en Azure Key Vault mediante la identidad administrada, soporte extendido para la copia masiva de Almacenamiento de datos de Azure, almacenamiento en caché de DNS de SQL Azure, compatibilidad con versiones anteriores para hacer streaming de objetos LOB y autenticación de certificado de cliente para escenarios de bucles invertidos. |
JDBC Driver 8.4 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>8.4.1.jre11</version>
</dependency>
Microsoft JDBC Driver 8.2 para SQL Server:
El controlador JDBC Driver 8.2 incluye tres bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar y mssql-jdbc-8.2.2.jre13.jar.
JDBC Driver 8.2 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 13.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 y Azul Zulu JRE 13.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 8.2 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-8.2.2.jre8.jar | 4,2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. Las nuevas características de la versión 8.2 incluyen lo siguiente: compatibilidad con JDK 13, Always Encrypted con enclaves seguros y mejoras de rendimiento del tipo de datos temporal. |
mssql-jdbc-8.2.2.jre11.jar | 4.3 | 11 | Requiere Java Runtime Environment (JRE) 11.0. El uso de JRE 10.0 o anterior lanza una excepción. Las nuevas características de la versión 8.2 incluyen lo siguiente: compatibilidad con JDK 13, Always Encrypted con enclaves seguros y mejoras de rendimiento del tipo de datos temporal. |
mssql-jdbc-8.2.2.jre13.jar | 4.3 | 13 | Requiere la versión 13.0 de Java Runtime Environment (JRE). El uso de JRE 11.0 o anterior lanza una excepción. Las nuevas características de la versión 8.2 incluyen lo siguiente: compatibilidad con JDK 13, Always Encrypted con enclaves seguros y mejoras de rendimiento del tipo de datos temporal. |
JDBC Driver 8.2 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>8.2.2.jre11</version>
</dependency>
Microsoft JDBC Driver 7.4 para SQL Server:
JDBC Driver 7.4 incluye tres bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar y mssql-jdbc-7.4.1.jre12.jar.
JDBC Driver 7.4 está diseñado para funcionar con todas las máquinas virtuales Java principales y ser compatible con ellas, aunque solo se ha probado en OpenJDK 1.8, OpenJDK 11.0, OpenJDK 12.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 y Azul Zulu JRE 12.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 7.4 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-7.4.1.jre8.jar | 4,2 | 8 | Requiere la versión 1.8 de Java Runtime Environment (JRE). El uso de JRE 1.7 o anterior lanza una excepción. Las nuevas características en 7.4 incluyen: compatibilidad con JDK 12, autenticación NTLM y useFmtOnly. |
mssql-jdbc-7.4.1.jre11.jar | 4.3 | 11 | Requiere Java Runtime Environment (JRE) 11.0. El uso de JRE 10.0 o anterior lanza una excepción. Las nuevas características en 7.4 incluyen: compatibilidad con JDK 12, autenticación NTLM y useFmtOnly. |
mssql-jdbc-7.4.1.jre12.jar | 4.3 | 12 | Requiere la versión 12.0 de Java Runtime Environment (JRE). El uso de JRE 11.0 o anterior lanza una excepción. Las nuevas características en 7.4 incluyen: compatibilidad con JDK 12, autenticación NTLM y useFmtOnly. |
JDBC Driver 7.4 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>7.4.1.jre11</version>
</dependency>
Microsoft JDBC Driver 7.2 para SQL Server:
JDBC Driver 7.2 incluye dos bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-7.2.2.jre8.jar y mssql-jdbc-7.2.2.jre11.jar.
JDBC Driver 7.2 está diseñado para funcionar con todas las máquinas virtuales Java principales y admitirlas, aunque solo se ha probado en OpenJDK 8.0, OpenJDK 11.0, Azul Zulu JRE 8.0 y Azul Zulu JRE 11.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 7.2 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-7.2.2.jre8.jar | 4,2 | 8 | Requiere la versión 8.0 de Java Runtime Environment (JRE). El uso de JRE 7.0 o anterior lanza una excepción. Las nuevas características en 7.2 incluyen: compatibilidad con JDK 11, autenticación de Managed Service Identity (MSI) de Active Directory, compatibilidad con OSGi, API de SQLServerError. |
mssql-jdbc-7.2.2.jre11.jar | 4.3 | 10 | Requiere Java Runtime Environment (JRE) 11.0. El uso de JRE 10.0 o anterior lanza una excepción. Las nuevas características en 7.2 incluyen: compatibilidad con JDK 11, autenticación de Managed Service Identity (MSI) de Active Directory, compatibilidad con OSGi, API de SQLServerError. |
JDBC Driver 7.2 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>7.2.2.jre11</version>
</dependency>
Microsoft JDBC Driver 7.0 para SQL Server
JDBC Driver 7.0 incluye dos bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-7.0.0.jre8.jar y mssql-jdbc-7.0.0.jre10.jar.
JDBC Driver 7.0 está diseñado para funcionar con todas las máquinas virtuales de Java y admitirlas, aunque solo se ha probado en OpenJDK 8.0 y 10.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 7.0 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-7.0.0.jre8.jar | 4,2 | 8 | Requiere la versión 8.0 de Java Runtime Environment (JRE). El uso de JRE 7.0 o anterior lanza una excepción. Las nuevas características en 7.0 incluyen compatibilidad con JDK 10, nivel de cumplimiento predeterminado actualizado a las especificaciones JDBC 4.2, compatibilidad con tipos de datos espaciales, propiedad de conexión cancelQueryTimeout, métodos de límite de solicitud, propiedad de conexión useBulkCopyForBatchInsert, información sobre detección y clasificación de datos, extensión de características UTF-8 y compatibilidad con CityHash. |
mssql-jdbc-7.0.0.jre10.jar | 4.3 | 10 | Requiere Java Runtime Environment (JRE) 10.0. El uso de JRE 9.0 o anterior lanza una excepción. Las nuevas características en 7.0 incluyen compatibilidad con JDK 10, nivel de cumplimiento predeterminado actualizado a las especificaciones JDBC 4.2, compatibilidad con tipos de datos espaciales, propiedad de conexión cancelQueryTimeout, métodos de límite de solicitud, propiedad de conexión useBulkCopyForBatchInsert, información sobre detección y clasificación de datos, extensión de características UTF-8 y compatibilidad con CityHash. |
JDBC Driver 7.0 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>7.0.0.jre10</version>
</dependency>
Microsoft JDBC Driver 6.4 para SQL Server:
JDBC Driver 6.4 incluye tres bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar y mssql-jdbc-6.4.0.jre9.jar.
JDBC Driver 6.4 está diseñado para funcionar con todas las máquinas virtuales de Java y admitirlas, aunque solo se ha probado en OpenJDK 7.0, 8.0 y 9.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los tres archivos JAR incluidos en Microsoft JDBC Driver 6.4 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-6.4.0.jre7.jar | 4,1 | 7 | Requiere la versión 7.0 de Java Runtime Environment (JRE). El uso de JRE 6.0 o anterior lanza una excepción. Las nuevas características en 6.4 incluyen: autenticación de Azure AD para Linux, método de entidad de seguridad y contraseña para Kerberos, detección automática de REALM en SPN para la autenticación entre dominios, delegación restringida de Kerberos, tiempo de expiración de consultas, tiempo de expiración de socket y reutilización del identificador de instrucción preparada. |
mssql-jdbc-6.4.0.jre8.jar | 4,2 | 8 | Requiere la versión 8.0 de Java Runtime Environment (JRE). El uso de JRE 7.0 o anterior lanza una excepción. Las nuevas características en 6.4 incluyen: autenticación de Azure AD para Linux, método de entidad de seguridad y contraseña para Kerberos, detección automática de REALM en SPN para la autenticación entre dominios, delegación restringida de Kerberos, tiempo de expiración de consultas, tiempo de expiración de socket y reutilización del identificador de instrucción preparada. |
mssql-jdbc-6.4.0.jre9.jar | 4.3 | 9 | Requiere Java Runtime Environment (JRE) 9.0. El uso de JRE 8.0 o anterior lanza una excepción. Las nuevas características en 6.4 incluyen: autenticación de Azure AD para Linux, método de entidad de seguridad y contraseña para Kerberos, detección automática de REALM en SPN para la autenticación entre dominios, delegación restringida de Kerberos, tiempo de expiración de consultas, tiempo de expiración de socket y reutilización del identificador de instrucción preparada. |
JDBC Driver 6.4 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML.
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>6.4.0.jre9</version>
</dependency>
Microsoft JDBC Driver 6.2 para SQL Server:
JDBC Driver 6.2 incluye dos bibliotecas de clases JAR en cada paquete de instalación: mssql-jdbc-6.2.2.jre7.jar y mssql-jdbc-6.2.2.jre8.jar.
JDBC Driver 6.2 está diseñado para funcionar con todas las máquinas virtuales de Java y ser compatible con ellas, aunque solo se ha probado en Sun JRE 5.0, 6.0, 7.0 y 8.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 6.0 y 4.2 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
mssql-jdbc-6.2.2.jre7.jar | 4,1 | 7 | Requiere la versión 7.0 de Java Runtime Environment (JRE). El uso de JRE 6.0 o anterior lanza una excepción. Las nuevas características en 6.2 incluyen: autenticación de Azure AD para Linux, método de entidad de seguridad y contraseña para Kerberos, detección automática de REALM en SPN para la autenticación entre dominios, delegación restringida de Kerberos, tiempo de expiración de consultas, tiempo de expiración de socket y reutilización del identificador de instrucción preparada. |
mssql-jdbc-6.2.3.jre8.jar | 4,2 | 8 | Requiere la versión 8.0 de Java Runtime Environment (JRE). El uso de JRE 7.0 o anterior lanza una excepción. Las nuevas características en 6.2 incluyen: autenticación de Azure AD para Linux, método de entidad de seguridad y contraseña para Kerberos, detección automática de REALM en SPN para la autenticación entre dominios, delegación restringida de Kerberos, tiempo de expiración de consultas, tiempo de expiración de socket y reutilización del identificador de instrucción preparada. |
JDBC Driver 6.2 también está disponible en el repositorio central de Maven y se puede agregar a un proyecto de Maven si se agrega el siguiente código en POM.XML.
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>6.2.2.jre8</version>
</dependency>
Microsoft JDBC Driver 6.0 y 4.2 para SQL Server:
Los controladores JDBC Driver 6.0 y 4.2 incluyen dos bibliotecas de clases JAR en cada paquete de instalación: sqljdbc41.jar y sqljdbc42.jar.
JDBC Driver 6.0 y 4.2 están diseñados para funcionar con todas las máquinas virtuales de Java y admitirlas, aunque solo se ha probado en Sun JRE 5.0, 6.0, 7.0 y 8.0.
En el siguiente gráfico se resume la compatibilidad que ofrecen los dos archivos JAR incluidos en Microsoft JDBC Driver 6.0 y 4.2 para SQL Server:
JAR | Cumplimiento con la versión JDBC | Versión de Java recomendada | Descripción |
---|---|---|---|
sqljdbc41.jar | 4,1 | 7 | Requiere la versión 7.0 de Java Runtime Environment (JRE). El uso de JRE 6.0 o anterior lanza una excepción. Las nuevas características de los paquetes 6.0 y 4.2 incluyen JBC 4.1 Compliance y Bulk Copy Además, las nuevas características exclusivas del paquete 6.0 incluyen Always Encrypted, parámetros con valores de tabla, autenticación de Microsoft Entra, conexiones transparentes a Grupos de disponibilidad Always On, mejora en la recuperación de metadatos de parámetros para consultas preparadas y nombre de dominio internacionalizado (IDN) |
sqljdbc42.jar | 4,2 | 8 | Requiere la versión 8.0 de Java Runtime Environment (JRE). El uso de JRE 7.0 o anterior lanza una excepción. Las nuevas características de los paquetes 6.0 y 4.2 incluyen JDBC 4.1 Compliance, JDBC 4.2 Compliance y Bulk Copy Además, las nuevas características exclusivas del paquete 6.0 incluyen Always Encrypted, parámetros con valores de tabla, autenticación de Microsoft Entra, conexiones transparentes a Grupos de disponibilidad Always On, mejora en la recuperación de metadatos de parámetros para consultas preparadas y nombre de dominio internacionalizado (IDN) |
Microsoft JDBC Driver 4.1 para SQL Server:
El controlador JDBC Driver 4.1 incluye una biblioteca de clases JAR en cada paquete de instalación: sqljdbc41.jar.
JAR | Descripción |
---|---|
sqljdbc41.jar | La biblioteca de clases sqljdbc41.jar proporciona compatibilidad con la API de JDBC 4.0. Incluye todas las características de JDBC 4.0 y los métodos de la API de JDBC 4.0. JDBC 4.1 no es compatible (se produce la excepción "SQLFeatureNotSupportedException"). La biblioteca de clases sqljdbc41.jar requiere Java Runtime Environment (JRE) 7.0. El uso de sqljdbc41.jar en JRE 6.0 y 5.0 lanza una excepción. |
JDBC Driver está diseñado para funcionar con todas las máquinas virtuales de Java y ser compatible con ellas, aunque se ha probado en Sun JRE 5.0, 6.0 y 7.0.
En el siguiente gráfico se resume la compatibilidad que ofrece el archivo JAR incluido en Microsoft JDBC Driver 4.1 para SQL Server.
JAR | Versión de JDBC | JRE (puede ejecutarse) | JDK (puede compilar) |
---|---|---|---|
sqljdbc41.jar | 4 | 7 | 7 6 5 |
Requisitos de SQL Server
El controlador JDBC admite conexiones a Azure SQL Database y SQL Server. Para Microsoft JDBC Driver 4.2 y 4.1 para SQL Server, la compatibilidad comienza a partir de SQL Server 2008.
Requisitos del sistema operativo
El controlador JDBC se ha diseñado para funcionar en cualquier sistema operativo que admita el uso de una máquina virtual Java (JVM). Pero solo se han probado oficialmente los sistemas operativos Sun Solaris, SUSE Linux, Ubuntu Linux, macOS y Windows.
Idiomas compatibles
El controlador JDBC es compatible con todas las intercalaciones de columnas de SQL Server. Para obtener más información sobre las intercalaciones compatibles con el controlador JDBC, vea Características internacionales del controlador JDBC.
Para obtener más información sobre las intercalaciones, vea "Trabajar con intercalaciones" en Libros en pantalla de SQL Server.