Como baixar e usar o driver JDBC para SQL Server 2019
Se você for um desenvolvedor Java que deseja conectar-se a um banco de dados SQL Server, precisará de um driver JDBC que forneça conectividade de banco de dados por meio das interfaces de programa de aplicativos (APIs) JDBC padrão. Neste artigo, você aprenderá como baixar, instalar e usar o Microsoft JDBC Driver para SQL Server 2019, que é um driver JDBC Tipo 4 compatível com Java 8, 11, 17 e 19. Você também aprenderá como lidar com erros que podem ocorrer ao usar o driver.
download jdbc driver for sql server 2019
O que é o driver JDBC para SQL Server 2019?
O Microsoft JDBC Driver para SQL Server 2019 é um driver JDBC (Java Database Connectivity) que permite que aplicativos Java, servidores de aplicativos ou applets habilitados para Java acessem dados do SQL Server, Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure. O driver está disponível sem custo adicional e foi testado nos principais servidores de aplicativos, como IBM WebSphere e SAP NetWeaver.
Benefícios de usar o driver JDBC para SQL Server 2019
Alguns dos benefícios de usar o driver JDBC para SQL Server 2019 são:
Ele oferece suporte aos recursos mais recentes do SQL Server 2019, como Always Encrypted com enclaves seguros, suporte a UTF-8, classificação de dados e muito mais.
Ele oferece alto desempenho e confiabilidade por meio de recursos como pool de conexões, failover de rede transparente, cópia em massa, autenticação integrada e suporte a Kerberos.
Ele oferece segurança e conformidade por meio de recursos como criptografia, validação de certificado, mascaramento de dados e auditoria.
Ele permite interoperabilidade e compatibilidade com outras tecnologias e estruturas Java, como Spring Boot, Hibernate, Apache Spark, Apache Tomcat e muito mais.
Versões e plataformas Java suportadas
O driver JDBC para SQL Server 2019 oferece suporte a Java 8, 11, 17 e 19. Ele também oferece suporte a várias plataformas, como Windows, Linux, macOS, Docker, Kubernetes e Azure.Para obter mais informações sobre os requisitos do sistema e a matriz de compatibilidade do driver, consulte .
Como baixar o driver JDBC para SQL Server 2019
Há duas maneiras de baixar o driver JDBC para SQL Server 2019:
Baixando do Microsoft Learn
Você pode baixar a versão mais recente do driver (12.2.0) em . Você pode escolher entre um arquivo zip ou um arquivo tar.gz, dependendo de sua preferência. O arquivo de download contém vários arquivos JAR que indicam a versão do Java que eles suportam. Por exemplo, mssql-jdbc-12.2.0.jre11.jar suporta Java 11.
Você também pode baixar idiomas diferentes do site da versão em inglês dos Estados Unidos selecionando os idiomas disponíveis. As notas de versão e os requisitos do sistema também estão disponíveis na mesma página.
Baixando do Maven Central
Se estiver usando o Maven para gerenciar as dependências do seu projeto Java, você pode adicionar o driver JDBC como uma dependência em seu arquivo pom.xml com o seguinte código:
<dependency> & <groupId>com.microsoft.sqlserver</groupId> <artifactId>mssql-jdbc</artifactId> <version>12.2.0.jre11</version> </dependency>
Você também pode especificar o escopo da dependência como compilação, tempo de execução, teste ou fornecido. Para obter mais informações sobre como usar o Maven com o driver JDBC, consulte .
Como instalar o driver JDBC para SQL Server 2019
Depois de baixar o driver JDBC, você precisa instalá-lo em seu sistema. O processo de instalação depende da plataforma que você está usando:
Instalando no Windows
Se você estiver usando o Windows, siga estas etapas para instalar o driver JDBC:
Extraia o arquivo zip que você baixou do Microsoft Learn ou Maven Central para uma pasta de sua escolha.
Adicione o arquivo JAR que corresponde à sua versão Java em seu caminho de classe. Por exemplo, se você estiver usando o Java 11, inclua mssql-jdbc-12.2.0.jre11.jar em seu caminho de classe.
Opcionalmente, você também pode adicionar o arquivo sqljdbc_auth.dll ao caminho do sistema se desejar usar a autenticação integrada com o driver.O arquivo dll está localizado na pasta x64 ou x86, dependendo da arquitetura do sistema.
Instalando no Linux ou macOS
Se você estiver usando Linux ou macOS, siga estas etapas para instalar o driver JDBC:
Extraia o arquivo tar.gz que você baixou do Microsoft Learn ou Maven Central para uma pasta de sua escolha.
Adicione o arquivo JAR que corresponde à sua versão Java em seu caminho de classe. Por exemplo, se você estiver usando o Java 11, inclua mssql-jdbc-12.2.0.jre11.jar em seu caminho de classe.
Opcionalmente, você também pode instalar o pacote msodbcsql17 se quiser usar a autenticação integrada com o driver. O pacote está disponível em . Você também precisará definir a variável de ambiente LD_LIBRARY_PATH para apontar para o local do arquivo libmsodbcsql-17.so.
Como usar o driver JDBC para SQL Server 2019
Depois de instalar o driver JDBC, você pode usá-lo para conectar-se a um banco de dados SQL Server a partir de seu aplicativo Java. Aqui estão algumas dicas sobre como usar o driver:
Escolhendo o arquivo JAR certo
O driver JDBC vem com vários arquivos JAR que indicam a versão do Java que eles suportam. Você deve escolher o arquivo JAR que corresponda à sua versão e plataforma Java. Por exemplo, se você estiver usando o Java 11 no Windows, deverá usar mssql-jdbc-12.2.0.jre11.jar. Se estiver usando Java 8 no Linux, você deve usar mssql-jdbc-12.2.0.jre8.jar.
Configurando o caminho de classe
Você precisa incluir o arquivo JAR escolhido em seu caminho de classe para que seu aplicativo Java possa localizar e carregar o driver. Você pode definir o caminho de classe de maneiras diferentes, dependendo de como executa seu aplicativo. Por exemplo, você pode usar a opção -cp ou -classpath ao usar o comando java ou pode usar a variável de ambiente CLASSPATH.
Fazendo uma conexão simples com um banco de dados
Para fazer uma conexão simples com um banco de dados do SQL Server, você precisa fornecer uma string de conexão que especifique o nome do servidor, o nome do banco de dados, o nome do usuário e a senha.Você também precisa carregar e registrar a classe do driver antes de criar um objeto de conexão. Aqui está um exemplo de como fazer uma conexão simples em Java:
// Carrega e registra a classe do driver Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver"); // Criar uma string de conexão String url = "jdbc:sqlserver://localhost;databaseName=AdventureWorks;user=sa;password=your_password"; // Cria um objeto de conexão Connection conn = DriverManager.getConnection(url); // Faça algo com a conexão // ... // Feche a conexão conn.close();
Você também pode usar outras propriedades de conexão, como IntegratedSecurity, encrypt, trustServerCertificate e muito mais. Para obter mais informações sobre como construir uma string de conexão, consulte .
Como lidar com erros com o driver JDBC para SQL Server 2019
Às vezes, podem ocorrer erros ao usar o driver JDBC, como problemas de rede, falhas de autenticação, erros de sintaxe ou erros de conversão de dados. Você precisa lidar com esses erros adequadamente em seu aplicativo Java para evitar resultados inesperados ou travamentos. Aqui estão algumas dicas sobre como lidar com erros com o driver JDBC:
Usando a classe SQLServerException
O driver JDBC lança uma exceção do tipo SQLServerException quando ocorre um erro. Essa classe de exceção estende a classe SQLException e fornece informações adicionais sobre o erro, como número, estado, gravidade e mensagem do erro. Você pode usar os métodos da classe SQLServerException para obter essas informações e lidar com o erro de acordo. Por exemplo, você pode usar um bloco try-catch para capturar e tratar a exceção:
try // Faça algo com a conexão // ... catch (SQLServerException e) // Obtenha as informações do erro int errorNumber = e.getErrorCode(); String errorState = e.getSQLState(); int errorSeverity = e.getErrorSeverity(); String errorMessage = e.getMessage(); // Trata o erro com base nas informações // ...
Para obter mais informações sobre a classe SQLServerException, consulte .
Usando a classe SQLServerError
Às vezes, a classe SQLServerException pode conter um objeto SQLServerError que fornece mais detalhes sobre o erro ocorrido no lado do servidor. A classe SQLServerError contém informações como nome do servidor, nome do procedimento, número da linha e rastreamento de pilha do erro. Você pode usar os métodos da classe SQLServerError para obter essas informações e lidar com o erro de acordo. Por exemplo, você pode usar um bloco try-catch para capturar e tratar a exceção:
try // Faça algo com a conexão // ... catch (SQLServerException e) // Obtenha o objeto SQLServerError SQLServerError serverError = e.getServerError(); // Verifica se o objeto não é nulo if (serverError != null) // Obtém as informações de erro do servidor String serverName = serverError.getServerName(); String procedureName = serverError.getProcedureName(); int lineNumber = serverError.getLineNumber(); String stackTrace = serverError.getStackTrace(); // Trata o erro com base nas informações // ...
Para obter mais informações sobre a classe SQLServerError, consulte .
Conclusão
Neste artigo, você aprendeu como baixar, instalar e usar o driver JDBC para SQL Server 2019. Você também aprendeu como lidar com erros que podem ocorrer ao usar o driver. O driver JDBC para SQL Server 2019 é uma ferramenta poderosa e confiável que permite que aplicativos Java acessem dados do SQL Server, Banco de Dados SQL do Azure e Instância Gerenciada do SQL do Azure. Você pode usá-lo para criar aplicativos Java robustos e escalonáveis que aproveitam os recursos mais recentes do SQL Server 2019.
perguntas frequentes
Aqui estão algumas perguntas frequentes sobre o driver JDBC para SQL Server 2019:
P: Como faço para atualizar o driver JDBC para SQL Server 2019?
R: Você pode atualizar o driver JDBC baixando e instalando a versão mais recente do driver do Microsoft Learn ou Maven Central. Você também deve atualizar seu caminho de classe para apontar para o novo arquivo JAR.
P: Como habilito o log com o driver JDBC para SQL Server 2019?
R: Você pode habilitar o log com o driver JDBC definindo algumas propriedades do sistema ou variáveis de ambiente que controlam o nível de log, o nome do arquivo e o modo de anexação. Para obter mais informações sobre como habilitar o log, consulte .
P: Como uso o Always Encrypted com enclaves seguros com o driver JDBC para SQL Server 2019?
R: Você pode usar o Always Encrypted com enclaves seguros com o driver JDBC definindo algumas propriedades de conexão, como columnEncryptionSetting, enclaveAttestationUrl, enclaveAttestationProtocol e keyStoreAuthentication. Para obter mais informações sobre como usar o Always Encrypted com enclaves seguros, consulte .
P: Como faço para usar o suporte UTF-8 com o driver JDBC para SQL Server 2019?
R: Você pode usar o suporte UTF-8 com o driver JDBC definindo algumas propriedades de conexão, como sendStringParametersAsUnicode e characterEncoding. Para obter mais informações sobre como usar o suporte UTF-8, consulte .
P: Como uso a classificação de dados com o driver JDBC para SQL Server 2019?
R: Você pode usar a classificação de dados com o driver JDBC definindo a propriedade de conexão enableDataClassification como true. Isso permitirá que o driver recupere os metadados de sensibilidade das colunas e os exponha por meio da interface ResultSetMetaData. Para obter mais informações sobre como usar a classificação de dados, consulte . 0517a86e26
Comments