Requisitos de sistema para o JDBC Driver
Para usar o Driver JDBC da Microsoft para SQL Server a fim de acessar dados de um SQL Server ou Banco de Dados SQL do Azure, você deve ter os seguintes componentes instalados em seu computador:
- Driver JDBC da Microsoft para SQL Server (baixar)
- Java Runtime Environment
Requisitos do Java Runtime Environment
A partir do Microsoft JDBC Driver 12.8 para SQL Server, há suporte para o Java Development Kit (JDK) 22.0 e o Java Runtime Environment (JRE) 22.0.
A partir do Microsoft JDBC Driver 12.6 para SQL Server, há suporte para o Java Development Kit (JDK) 21.0 e o Java Runtime Environment (JRE) 21.0.
A partir do Microsoft JDBC Driver 12.4 para SQL Server, há suporte para o Java Development Kit (JDK) 20.0 e o Java Runtime Environment (JRE) 20.0.
A partir do Microsoft JDBC Driver 12.2 para SQL Server, há suporte para o JDK (Java Development Kit) 19.0 e o JRE (Java Runtime Environment) 19.0.
A partir do Microsoft JDBC Driver 11.2 para SQL Server, há suporte para o JDK (Java Development Kit) 18.0 e o JRE (Java Runtime Environment) 18.0.
Do Microsoft JDBC Driver 10.2 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 17.0 e o JRE (Java Runtime Environment) 17.0.
Do Microsoft JDBC Driver 9.4 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 16.0 e o JRE (Java Runtime Environment) 16.0.
Do Microsoft JDBC Driver 9.2 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 15.0 e o JRE (Java Runtime Environment) 15.0.
Do Microsoft JDBC Driver 8.4 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 14.0 e o JRE (Java Runtime Environment) 14.0.
Do Microsoft JDBC Driver 8.2 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 13.0 e o JRE (Java Runtime Environment) 13.0.
Do Microsoft JDBC Driver 7.4 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 12.0 e o JRE (Java Runtime Environment) 12.0.
Do Microsoft JDBC Driver 7.2 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 11.0 e o JRE (Java Runtime Environment) 11.0.
Do Microsoft JDBC Driver 7.0 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 10.0 e o JRE (Java Runtime Environment) 10.0.
Do Microsoft JDBC Driver 6.4 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 9.0 e o JRE (Java Runtime Environment) 9.0.
Do Microsoft JDBC Driver 4.2 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 8.0 e o JRE (Java Runtime Environment) 8.0. O suporte para a API de Especificação do JDBC foi estendido com o objetivo de incluir a API do JDBC 4.1 e 4.2.
Do Microsoft JDBC Driver 4.1 para SQL Server em diante, há suporte para o JDK (Java Development Kit) 7.0 e o JRE (Java Runtime Environment) 7.0.
A partir do Driver 4.0 JDBC da Microsoft para SQL Server, o suporte do driver JDBC para a API JDBC Spec foi estendido para incluir a API JDBC 4.0. A API do JDBC 4.0 foi introduzida como parte do JDK (Java Development Kit) 6.0 e do JRE (Java Runtime Environment) 6.0. O JDBC 4.0 é um superconjunto da API do JDBC 3.0.
Ao implementar o Driver JDBC da Microsoft para SQL Server em sistemas operacionais Windows e UNIX, você deve usar os pacotes de instalação, sqljdbc_<version>_enu.exe e sqljdbc_<version>_enu.tar.gz, respectivamente. Para saber mais sobre como implantar o driver JDBC, consulte o artigo Implantar o JDBC Driver.
Microsoft JDBC Driver 12.8 para SQL Server:
O JDBC Driver 12.8 inclui duas bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-12.8.0.jre8.jar e mssql-jdbc-12.8.0.jre11.jar.
O JDBC Driver 12.8 foi projetado para ser compatível com todas as principais máquinas virtuais Java, mas foi testado apenas no 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 e Azul Zulu JRE 17.0.
O gráfico a seguir ilustra o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 12.8 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-12.8.0.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou versões anteriores causará uma exceção. |
| mssql-jdbc-12.8.0.jre11.jar | 4.3 | 22 | Exige o JRE (Java Runtime Environment) 11.0 ou posterior. O uso do JRE 10.0 ou versões anteriores causará uma exceção. |
O JDBC Driver 12.8 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto do Maven com o seguinte código no 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:
O JDBC Driver 12.6 inclui duas bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-12.6.0.jre8.jar e mssql-jdbc-12.6.0.jre11.jar.
O JDBC Driver 12.6 foi projetado para ser compatível com todas as principais máquinas virtuais Java, mas foi testado apenas no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, OpenJDK 21.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 17.0.
O gráfico a seguir ilustra o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 12.6 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-12.6.0.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou versões anteriores causará uma exceção. |
| mssql-jdbc-12.6.0.jre11.jar | 4.3 | 21 | Exige o JRE (Java Runtime Environment) 11.0 ou posterior. O uso do JRE 10.0 ou versões anteriores causará uma exceção. |
O JDBC Driver 12.6 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto do Maven com o seguinte código no 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:
O JDBC Driver 12.4 inclui duas bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-12.4.0.jre8.jar e mssql-jdbc-12.4.0.jre11.jar.
O JDBC Driver 12.4 foi projetado para ser compatível com todas as principais máquinas virtuais Java, mas foi testado apenas no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, OpenJDK 20.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 17.0.
O gráfico a seguir ilustra o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 12.4 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-12.4.0.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou versões anteriores causará uma exceção. |
| mssql-jdbc-12.4.0.jre11.jar | 4.3 | 20 | Exige o JRE (Java Runtime Environment) 11.0 ou posterior. O uso do JRE 10.0 ou versões anteriores causará uma exceção. |
O JDBC Driver 12.4 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto do Maven com o seguinte código no 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:
O JDBC Driver 12.2 inclui duas bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-12.2.0.jre8.jar e mssql-jdbc-12.2.0.jre11.jar.
O JDBC Driver 12.2 foi projetado para compatibilidade com todas as principais máquinas virtuais Java, mas foi testado apenas no OpenJDK 1.8, no OpenJDK 11.0, no OpenJDK 17.0, no OpenJDK 19.0, no Azul Zulu JRE 1.8, no Azul Zulu JRE 11.0 e no Azul Zulu JRE 17.0.
O seguinte gráfico resume o suporte fornecido pelos dois arquivos JAR incluídos nos Microsoft JDBC Drivers 12.2 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-12.2.0.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou anterior lança uma exceção. |
| mssql-jdbc-12.2.0.jre11.jar | 4.3 | 19 | Exige um JRE (Java Runtime Environment) 11.0 ou superior. O uso do JRE 10.0 ou inferior lança uma exceção. |
O JDBC Driver 12.2 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto do Maven com o seguinte código no 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:
O JDBC Driver 11.2 inclui quatro bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar e mssql-jdbc-11.2.0.jre18.jar.
O JDBC Driver 11.2 foi projetado para compatibilidade com todas as principais máquinas virtuais Java, mas foi testado apenas no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, OpenJDK 18.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 17.0.
O seguinte gráfico resume o suporte fornecido pelos quatro arquivos JAR incluídos nos Microsoft JDBC Drivers 11.2 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-11.2.0.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou anterior lança uma exceção. |
| mssql-jdbc-11.2.0.jre11.jar | 4.3 | 11 | Requer um JRE (Java Runtime Environment) 11.0. O uso do JRE 10.0 ou inferior lança uma exceção. |
| mssql-jdbc-11.2.0.jre17.jar | 4.3 | 17 | Exige um JRE (Java Runtime Environment) 17.0. O uso do JRE 16.0 ou inferior gera uma exceção. |
| mssql-jdbc-11.2.0.jre18.jar | 4.3 | 18 | Exige um JRE (Java Runtime Environment) 18.0. O uso do JRE 17.0 ou inferior gera uma exceção. |
O JDBC Driver 11.2 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no 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:
O JDBC Driver 10.2 inclui três bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar e mssql-jdbc-10.2.0.jre17.jar.
O JDBC Driver 10.2 foi projetado para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 17.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 17.0.
O gráfico abaixo resume o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Driver 10.2 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-10.2.0.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou anterior lança uma exceção. |
| mssql-jdbc-10.2.0.jre11.jar | 4.3 | 11 | Requer um JRE (Java Runtime Environment) 11.0. O uso do JRE 10.0 ou inferior lança uma exceção. |
| mssql-jdbc-10.2.0.jre17.jar | 4.3 | 17 | Exige um JRE (Java Runtime Environment) 17.0. O uso do JRE 16.0 ou inferior gera uma exceção. |
O JDBC Driver 10.2 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no 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:
O JDBC Driver 9.4 inclui três bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar e mssql-jdbc-9.4.1.jre16.jar.
O JDBC Driver 9.4 foi projetado para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 16.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 16.0.
O gráfico abaixo resume o suporte fornecido pelos dois arquivos JAR incluídos nos Microsoft JDBC Drivers 9.4 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-9.4.1.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou anterior lança uma exceção. |
| mssql-jdbc-9.4.1.jre11.jar | 4.3 | 11 | Requer um JRE (Java Runtime Environment) 11.0. O uso do JRE 10.0 ou inferior lança uma exceção. |
| mssql-jdbc-9.4.1.jre16.jar | 4.3 | 16 | Exige um JRE (Java Runtime Environment) 16.0. O uso do JRE 15.0 ou inferior gera uma exceção. |
O JDBC Driver 9.4 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no 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:
O JDBC Driver 9.2 inclui três bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar e mssql-jdbc-9.2.1.jre15.jar.
O JDBC Driver 9.2 foi projetado para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 15.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 15.0.
O gráfico abaixo resumirá o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 9.2 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-9.2.1.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou anterior lança uma exceção. Os novos recursos da versão 9.2 incluem: Suporte ao JDK 15, suporte para obter uma Autenticação Interativa do Azure Active Directory, suporte para obter uma Autenticação da Entidade de Serviço do Azure Active Directory e suporte para executar useBulkCopyForBatchInsert para servidores não Azure Synapse Analytics. |
| mssql-jdbc-9.2.1.jre11.jar | 4.3 | 11 | Requer um JRE (Java Runtime Environment) 11.0. O uso do JRE 10.0 ou inferior lança uma exceção. Os novos recursos da versão 9.2 incluem: Suporte ao JDK 15, suporte para obter uma Autenticação Interativa do Azure Active Directory, suporte para obter uma Autenticação da Entidade de Serviço do Azure Active Directory e suporte para executar useBulkCopyForBatchInsert para servidores não Azure Synapse Analytics. |
| mssql-jdbc-9.2.1.jre15.jar | 4.3 | 15 | Requer obter um JRE (Java Runtime Environment) 15.0. Usar o JRE 14.0 ou anterior gera uma exceção. Os novos recursos da versão 9.2 incluem: Suporte ao JDK 15, suporte para obter uma Autenticação Interativa do Azure Active Directory, suporte para obter uma Autenticação da Entidade de Serviço do Azure Active Directory e suporte para executar useBulkCopyForBatchInsert para servidores não Azure Synapse Analytics. |
O JDBC Driver 9.2 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no 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:
o JDBC Driver 8.4 inclui três bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar e mssql-jdbc-8.4.1.jre14.jar.
O JDBC Driver 8.4 foi projetado para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 14.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 14.0.
O gráfico seguinte resume o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 8.4 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-8.4.1.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou anterior lança uma exceção. Os novos recursos na versão 8.4 incluem: Suporte a JDK 14, suporte para autenticação para Azure Key Vault usando Identidade Gerenciada, suporte estendido para cópia em massa para o Azure Data Warehouse, cache DNS do Azure SQL, suporte para compatibilidade com versões anteriores para streaming de objetos LOB e autenticação de certificado de cliente para cenários de loopback. |
| mssql-jdbc-8.4.1.jre11.jar | 4.3 | 11 | Requer um JRE (Java Runtime Environment) 11.0. O uso do JRE 10.0 ou inferior lança uma exceção. Os novos recursos na versão 8.4 incluem: Suporte a JDK 14, suporte para autenticação para Azure Key Vault usando Identidade Gerenciada, suporte estendido para cópia em massa para o Azure Data Warehouse, cache DNS do Azure SQL, suporte para compatibilidade com versões anteriores para streaming de objetos LOB e autenticação de certificado de cliente para cenários de loopback. |
| mssql-jdbc-8.4.1.jre13.jar | 4.3 | 14 | Requer um JRE (Java Runtime Environment) 14.0. O uso do JRE 13.0 ou anterior lança uma exceção. Os novos recursos na versão 8.4 incluem: Suporte a JDK 14, suporte para autenticação para Azure Key Vault usando Identidade Gerenciada, suporte estendido para cópia em massa para o Azure Data Warehouse, cache DNS do Azure SQL, suporte para compatibilidade com versões anteriores para streaming de objetos LOB e autenticação de certificado de cliente para cenários de loopback. |
O JDBC Driver 8.4 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no 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:
o JDBC Driver 8.2 inclui três bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar e mssql-jdbc-8.2.2.jre13.jar.
O JDBC Driver 8.2 foi projetado para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 13.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 13.0.
O gráfico seguinte resume o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 8.2 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-8.2.2.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou anterior lança uma exceção. Os novos recursos na versão 8.2 incluem: suporte ao JDK 13, Always Encrypted com enclaves seguros e aprimoramentos de desempenho do tipo de dados temporais. |
| mssql-jdbc-8.2.2.jre11.jar | 4.3 | 11 | Requer um JRE (Java Runtime Environment) 11.0. O uso do JRE 10.0 ou inferior lança uma exceção. Os novos recursos na versão 8.2 incluem: suporte ao JDK 13, Always Encrypted com enclaves seguros e aprimoramentos de desempenho do tipo de dados temporais. |
| mssql-jdbc-8.2.2.jre13.jar | 4.3 | 13 | Requer um JRE (Java Runtime Environment) 13.0. O uso do JRE 11.0 ou anterior lança uma exceção. Os novos recursos na versão 8.2 incluem: suporte ao JDK 13, Always Encrypted com enclaves seguros e aprimoramentos de desempenho do tipo de dados temporais. |
O JDBC Driver 8.2 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no 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:
O JDBC Driver 7.4 inclui três bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar e mssql-jdbc-7.4.1.jre12.jar.
O JDBC Driver 7.4 foi projetado para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 1.8, OpenJDK 11.0, OpenJDK 12.0, Azul Zulu JRE 1.8, Azul Zulu JRE 11.0 e Azul Zulu JRE 12.0.
O gráfico seguinte resume o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 7.4 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-7.4.1.jre8.jar | 4.2 | 8 | Requer um JRE (Java Runtime Environment) 1.8. O uso do JRE 1.7 ou anterior lança uma exceção. Os novos recursos na versão 7.4 incluem: Suporte a JDK 12, autenticação NTLM e useFmtOnly. |
| mssql-jdbc-7.4.1.jre11.jar | 4.3 | 11 | Requer um JRE (Java Runtime Environment) 11.0. O uso do JRE 10.0 ou inferior lança uma exceção. Os novos recursos na versão 7.4 incluem: Suporte a JDK 12, autenticação NTLM e useFmtOnly. |
| mssql-jdbc-7.4.1.jre12.jar | 4.3 | 12 | Requer um JRE (Java Runtime Environment) 12.0. O uso do JRE 11.0 ou anterior lança uma exceção. Os novos recursos na versão 7.4 incluem: Suporte a JDK 12, autenticação NTLM e useFmtOnly. |
O JDBC Driver 7.4 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no 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:
O JDBC Driver 7.2 inclui duas bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-7.2.2.jre8.jar e mssql-jdbc-7.2.2.jre11.jar.
O JDBC Driver 7.2 foi projetado para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 8.0, no OpenJDK 11.0, no Azul Zulu JRE 8.0 e no Azul Zulu JRE 11.0.
O gráfico seguinte resume o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 7.2 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-7.2.2.jre8.jar | 4.2 | 8 | Requer um Java Runtime Environment (JRE) 8.0. O uso do JRE 7.0 ou inferior lança uma exceção. Os novos recursos na versão 7.2 incluem: suporte ao JDK 11, autenticação da MSI (Identidade Gerenciada) do Active Directory, suporte a OSGi, APIs de SQLServerError. |
| mssql-jdbc-7.2.2.jre11.jar | 4.3 | 10 | Requer um JRE (Java Runtime Environment) 11.0. O uso do JRE 10.0 ou inferior lança uma exceção. Os novos recursos na versão 7.2 incluem: suporte ao JDK 11, autenticação da MSI (Identidade Gerenciada) do Active Directory, suporte a OSGi, APIs de SQLServerError. |
O JDBC Driver 7.2 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no 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:
O JDBC Driver 7.0 inclui duas bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-7.0.0.jre8.jar e mssql-jdbc-7.0.0.jre10.jar.
O JDBC Driver 7.0 foi desenvolvido para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 8.0 e 10.0.
O gráfico seguinte resume o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 7.0 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-7.0.0.jre8.jar | 4.2 | 8 | Requer um Java Runtime Environment (JRE) 8.0. O uso do JRE 7.0 ou inferior lança uma exceção. Os novos recursos no 7.0 incluem: suporte ao JDK 10, atualização do nível de compatibilidade padrão para especificações JDBC 4.2, suporte a Tipos de Dados Espaciais, propriedade de conexão cancelQueryTimeout, métodos de Limite de Solicitação, propriedade de conexão useBulkCopyForBatchInsert, Dados de Descoberta e informação de classificação, extensão do recurso de UTF-8 e suporte a CityHash. |
| mssql-jdbc-7.0.0.jre10.jar | 4.3 | 10 | Requer um JRE (Java Runtime Environment) 10.0. O uso do JRE 9.0 ou inferior lança uma exceção. Os novos recursos no 7.0 incluem: suporte ao JDK 10, atualização do nível de compatibilidade padrão para especificações JDBC 4.2, suporte a Tipos de Dados Espaciais, propriedade de conexão cancelQueryTimeout, métodos de Limite de Solicitação, propriedade de conexão useBulkCopyForBatchInsert, Dados de Descoberta e informação de classificação, extensão do recurso de UTF-8 e suporte a CityHash. |
O JDBC Driver 7.0 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no POM.XML:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>7.0.0.jre10</version>
</dependency>
Microsoft JDBC Driver 6.4 for SQL Server:
O JDBC Driver 6.4 inclui três bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar e mssql-jdbc-6.4.0.jre9.jar.
O JDBC Driver 6.4 foi desenvolvido para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no OpenJDK 7.0, 8.0 e 9.0.
O gráfico seguinte resume o suporte fornecido pelos três arquivos JAR incluídos no Microsoft JDBC Drivers 6.4 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-6.4.0.jre7.jar | 4.1 | 7 | Requer um Java Runtime Environment (JRE) 7.0. O uso do JRE 6.0 ou inferior lança uma exceção. Os novos recursos na versão 6.4 incluem: Autenticação do Azure AD para Linux, método de Entidade de Segurança/Senha para Kerberos, detecção automática de REALM no SPN para autenticação Entre Domínios, Delegação Restrita do Kerberos, Tempo Limite de Consulta, Tempo Limite de Soquete e reutilização preparada do identificador de instrução. |
| mssql-jdbc-6.4.0.jre8.jar | 4.2 | 8 | Requer um Java Runtime Environment (JRE) 8.0. O uso do JRE 7.0 ou inferior lança uma exceção. Os novos recursos na versão 6.4 incluem: Autenticação do Azure AD para Linux, método de Entidade de Segurança/Senha para Kerberos, detecção automática de REALM no SPN para autenticação Entre Domínios, Delegação Restrita do Kerberos, Tempo Limite de Consulta, Tempo Limite de Soquete e reutilização preparada do identificador de instrução. |
| mssql-jdbc-6.4.0.jre9.jar | 4.3 | 9 | Requer um JRE (Java Runtime Environment) 9.0. O uso do JRE 8.0 ou inferior lança uma exceção. Os novos recursos na versão 6.4 incluem: Autenticação do Azure AD para Linux, método de Entidade de Segurança/Senha para Kerberos, detecção automática de REALM no SPN para autenticação Entre Domínios, Delegação Restrita do Kerberos, Tempo Limite de Consulta, Tempo Limite de Soquete e reutilização preparada do identificador de instrução. |
O JDBC Driver 6.4 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no POM.XML
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>6.4.0.jre9</version>
</dependency>
Microsoft JDBC Driver 6.2 for SQL Server:
O JDBC Driver 6.2 inclui duas bibliotecas de classes JAR em cada pacote de instalação: mssql-jdbc-6.2.2.jre7.jar e mssql-jdbc-6.2.2.jre8.jar.
O JDBC Driver 6.2 foi desenvolvido para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no Sun JRE 5.0, 6.0, 7.0 e 8.0.
O gráfico seguinte resume o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 6.0 e 4.2 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| mssql-jdbc-6.2.2.jre7.jar | 4.1 | 7 | Requer um Java Runtime Environment (JRE) 7.0. O uso do JRE 6.0 ou inferior lança uma exceção. Os novos recursos na versão 6.2 incluem: Autenticação do Azure AD para Linux, método de Entidade de Segurança/Senha para Kerberos, detecção automática de REALM no SPN para autenticação Entre Domínios, Delegação Restrita do Kerberos, Tempo Limite de Consulta, Tempo Limite de Soquete e reutilização preparada do identificador de instrução. |
| mssql-jdbc-6.2.3.jre8.jar | 4.2 | 8 | Requer um Java Runtime Environment (JRE) 8.0. O uso do JRE 7.0 ou inferior lança uma exceção. Os novos recursos na versão 6.2 incluem: Autenticação do Azure AD para Linux, método de Entidade de Segurança/Senha para Kerberos, detecção automática do REALM no SPN para autenticação Entre Domínios, Delegação Restrita do Kerberos, Tempo Limite de Consulta, Tempo Limite de Soquete e reutilização preparada de identificador de instrução |
O JDBC Driver 6.2 está disponível no Repositório Central do Maven e pode ser adicionado a um projeto Maven com o seguinte código no POM.XML
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>6.2.2.jre8</version>
</dependency>
Microsoft JDBC Driver 6.0 e 4.2 for SQL Server:
O JDBC Driver 6.0 e o 4.2 incluem duas bibliotecas de classes JAR em cada pacote de instalação: sqljdbc41.jar e sqljdbc42.jar.
Os JDBC Drivers 6.0 e 4.2 foram projetados para funcionar e são compatíveis com todas as principais máquinas virtuais Java, mas foram testados somente no Sun JRE 5.0, 6.0, 7.0 e 8.0.
O gráfico seguinte resume o suporte fornecido pelos dois arquivos JAR incluídos no Microsoft JDBC Drivers 6.0 e 4.2 para SQL Server:
| JAR | Conformidade de versão do JDBC | Versão do Java recomendada | Descrição |
|---|---|---|---|
| sqljdbc41.jar | 4.1 | 7 | Requer um Java Runtime Environment (JRE) 7.0. O uso do JRE 6.0 ou inferior lança uma exceção. Os novos recursos nos pacotes 6.0 e 4.2 incluem: conformidade com o JDBC 4.1 e cópia em massa Além disso, os novos recursos somente no pacote 6.0 incluem: Always Encrypted, parâmetros com valor de tabela, autenticação do Microsoft Entra, conexões transparentes para grupos de disponibilidade Always On, melhoria na recuperação de metadados de parâmetro para consultas preparadas e nome de domínio internacionalizado (IDN) |
| sqljdbc42.jar | 4.2 | 8 | Requer um Java Runtime Environment (JRE) 8.0. O uso do JRE 7.0 ou inferior lança uma exceção. Os novos recursos dos pacotes 6.0 e 4.2 incluem: conformidade com o JDBC 4.1, conformidade com o JDBC 4.2 e cópia em massa Além disso, os novos recursos somente no pacote 6.0 incluem: Always Encrypted, parâmetros com valor de tabela, autenticação do Microsoft Entra, conexões transparentes para grupos de disponibilidade Always On, melhoria na recuperação de metadados de parâmetro para consultas preparadas e nome de domínio internacionalizado (IDN) |
Microsoft JDBC Driver 4.1 for SQL Server:
O JDBC Driver 4.1 inclui uma biblioteca de classes JAR em cada pacote de instalação: sqljdbc41.jar.
| JAR | Descrição |
|---|---|
| sqljdbc41.jar | A biblioteca de classes sqljdbc41.jar dá suporte à API do JDBC 4.0. Ela inclui todos os recursos do driver JDBC 4.0 e métodos de API do JDBC 4.0. Não há suporte para o JDBC 4.1 (gera uma exceção "SQLFeatureNotSupportedException"). A biblioteca de classes sqljdbc41.jar requer um JRE (Java Runtime Environment) 7.0. O uso do sqljdbc41.jar no JRE 6.0 e 5.0 lança uma exceção. |
O driver JDBC foi projetado para funcionar e é compatível com todas as principais máquinas virtuais Java, mas foi testado somente no Sun JRE 5.0, 6.0 e 7.0.
O gráfico a seguir resume o suporte fornecido pelo arquivo JAR incluído com o Microsoft JDBC Driver 4.1 para SQL Server.
| JAR | Versão JDBC | JRE (pode ser executado) | JDK (pode ser compilado) |
|---|---|---|---|
| sqljdbc41.jar | 4 | 7 | 7 6 5 |
Requisitos do SQL Server
O driver JDBC dá suporte a conexões ao Banco de Dados SQL do Azure e ao SQL Server. Para o Microsoft JDBC Driver 4.2 e 4.1 para SQL Server, o suporte começa com o SQL Server 2008.
Requisitos do sistema operacional
O driver JDBC foi desenvolvido para funcionar em qualquer sistema operacional que ofereça suporte ao uso de uma JVM (Máquina Virtual Java). Porém, só os sistemas operacionais Sun Solaris, SUSE Linux, Ubuntu Linux, macOS e Windows foram testados oficialmente.
Idiomas com suporte
O driver JDBC dá suporte a todas as ordenações de coluna do SQL Server. Para saber mais sobre as ordenações com suporte no JDBC Driver, confira os Recursos internacionais do JDBC Driver.
Para obter mais informações sobre ordenações, consulte "Trabalhando com ordenações" nos Manuais Online do SQL Server.