Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Esta seção fornece instruções de início rápido para fazer uma conexão simples com um banco de dados do SQL Server usando o Microsoft JDBC Driver para SQL Server. Antes de se conectar a um banco de dados do SQL Server, o SQL Server deve primeiro ser instalado no computador local ou em um servidor, e o driver JDBC deve ser instalado no computador local.
Escolha o arquivo JAR certo
O Microsoft JDBC Driver fornece diferentes Jars para serem usados em correspondência com suas configurações preferidas do Java Runtime Environment (JRE), conforme abaixo:
O Microsoft JDBC Driver 12.10 para SQL Server fornece os arquivos de biblioteca de classe mssql-jdbc-12.10.0.jre8.jar e mssql-jdbc-12.10.0.jre11.jar.
O Microsoft JDBC Driver 12.8 para SQL Server fornece mssql-jdbc-12.8.0.jre8.jar e mssql-jdbc-12.8.0.jre11.jar arquivos de biblioteca de classe.
O Microsoft JDBC Driver 12.6 para SQL Server fornece os arquivos de classes de biblioteca mssql-jdbc-12.6.0.jre8.jar e mssql-jdbc-12.6.0.jre11.jar.
O Microsoft JDBC Driver 12.4 para SQL Server fornece mssql-jdbc-12.4.0.jre8.jar e mssql-jdbc-12.4.0.jre11.jar ficheiros de bibliotecas de classes.
O Microsoft JDBC Driver 12.2 para SQL Server fornece os ficheiros de biblioteca de classes mssql-jdbc-12.2.0.jre8.jar e mssql-jdbc-12.2.0.jre11.jar.
O Microsoft JDBC Driver 11.2 para SQL Server fornece arquivos de biblioteca de classes mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jare mssql-jdbc-11.2.0.jre18.jar.
O Microsoft JDBC Driver 10.2 para SQL Server fornece arquivos de biblioteca de classes mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jare mssql-jdbc-10.2.0.jre17.jar.
O Microsoft JDBC Driver 9.4 para SQL Server fornece arquivos de biblioteca de classes mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jare mssql-jdbc-9.4.1.jre16.jar.
O Microsoft JDBC Driver 9.2 para SQL Server fornece mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jare mssql-jdbc-9.2.1.jre15.jar arquivos de biblioteca de classe.
O Microsoft JDBC Driver 8.4 para SQL Server fornece arquivos de biblioteca de classes mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jare mssql-jdbc-8.4.1.jre14.jar.
O Microsoft JDBC Driver 8.2 para SQL Server fornece arquivos de biblioteca de classes mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jare mssql-jdbc-8.2.2.jre13.jar.
O Microsoft JDBC Driver 7.4 para SQL Server fornece mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jare mssql-jdbc-7.4.1.jre12.jar arquivos de biblioteca de classe.
O Microsoft JDBC Driver 7.2 para SQL Server fornece mssql-jdbc-7.2.2.jre8.jare mssql-jdbc-7.2.2.jre11.jar arquivos de biblioteca de classe.
O Microsoft JDBC Driver 7.0 para SQL Server fornece mssql-jdbc-7.0.0.jre8.jare mssql-jdbc-7.0.0.jre10.jar ficheiros de biblioteca de classes.
O Microsoft JDBC Driver 6.4 para SQL Server fornece arquivos de biblioteca de classes mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jare mssql-jdbc-6.4.0.jre9.jar.
O Microsoft JDBC Driver 6.2 para SQL Server fornece mssql-jdbc-6.2.2.jre7.jare mssql-jdbc-6.2.2.jre8.jar arquivos de biblioteca de classe.
Os Microsoft JDBC Drivers 6.0 e 4.2 para SQL Server fornecem os ficheiros de biblioteca de classes sqljdbc41.jare sqljdbc42.jar .
O Microsoft JDBC Driver 4.1 para SQL Server disponibiliza o ficheiro de biblioteca de classes sqljdbc41.jar.
A sua escolha determinará as funcionalidades disponíveis. Para obter mais informações sobre qual arquivo JAR escolher, consulte Requisitos do sistema para o driver JDBC.
Configuração do classpath
Os jars do driver JDBC da Microsoft não fazem parte do Java SDK e devem ser incluídos no Classpath do aplicativo do usuário.
Se estiver usando o JDBC Driver 12.10, defina o classpath para incluir o mssql-jdbc-12.10.0.jre8.jar ou mssql-jdbc-12.10.0.jre11.jar.
Se estiver usando o JDBC Driver 12.8, defina o classpath para incluir o mssql-jdbc-12.8.0.jre8.jar ou mssql-jdbc-12.8.0.jre11.jar.
Se estiver usando o JDBC Driver 12.6, defina o classpath para incluir o mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar.
Se estiver usando o JDBC Driver 12.4, defina o classpath para incluir o mssql-jdbc-12.4.0.jre8.jar ou mssql-jdbc-12.4.0.jre11.jar.
Se estiver usando o JDBC Driver 12.2, defina o classpath para incluir o mssql-jdbc-12.2.0.jre8.jar ou mssql-jdbc-12.2.0.jre11.jar.
Se estiver usando o JDBC Driver 11.2, defina o classpath para incluir os mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jarou mssql-jdbc-11.2.0.jre18.jar.
Se estiver usando o JDBC Driver 10.2, defina o classpath para incluir o mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jarou mssql-jdbc-10.2.0.jre17.jar.
Se estiver usando o JDBC Driver 9.4, defina o classpath para incluir o mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jarou mssql-jdbc-9.4.1.jre16.jar.
Se estiver usando o JDBC Driver 9.2, defina o classpath para incluir o mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jarou mssql-jdbc-9.2.1.jre15.jar.
Se estiver usando o JDBC Driver 8.4, defina o classpath para incluir o mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jarou mssql-jdbc-8.4.1.jre14.jar.
Se estiver usando o JDBC Driver 8.2, defina o classpath para incluir o mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jarou mssql-jdbc-8.2.2.jre13.jar.
Se estiver usando o JDBC Driver 7.4, defina o classpath para incluir o mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jarou mssql-jdbc-7.4.1.jre12.jar.
Se estiver usando o JDBC Driver 7.2, defina o classpath para incluir o mssql-jdbc-7.2.2.jre8.jar ou mssql-jdbc-7.2.2.jre11.jar.
Se estiver usando o JDBC Driver 7.0, defina o classpath para incluir o mssql-jdbc-7.0.0.jre8.jar ou mssql-jdbc-7.0.0.jre10.jar.
Se estiver usando o JDBC Driver 6.4, defina o classpath para incluir o mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jarou mssql-jdbc-6.4.0.jre9.jar.
Se estiver usando o JDBC Driver 6.2, defina o classpath para incluir o mssql-jdbc-6.2.2.jre7.jar ou mssql-jdbc-6.2.2.jre8.jar.
Se estiver usando o JDBC Driver 4.1 ou 4.2, defina o classpath para incluir sqljdbc41.jar ou sqljdbc42.jar arquivo do respetivo download do driver.
Se o classpath estiver faltando uma entrada para o arquivo Jar correto, um aplicativo lançará a exceção de Class not found
comum.
Para Microsoft JDBC Driver 12.10
Os arquivos mssql-jdbc-12.10.0.jre8.jar ou mssql-jdbc-12.10.0.jre11.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.10.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.10.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.10 for SQL Server\sqljdbc_12.10\enu\mssql-jdbc-12.10.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.10/enu/mssql-jdbc-12.10.0.jre11.jar
Certifique-se de que a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.10.0.jre8.jar, mssql-jdbc-12.10.0.jre11.jar.
Para Microsoft JDBC Driver 12.8
Os arquivos mssql-jdbc-12.8.0.jre8.jar ou mssql-jdbc-12.8.0.jre11.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.8 for SQL Server\sqljdbc_12.8\enu\mssql-jdbc-12.8.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.8/enu/mssql-jdbc-12.8.0.jre11.jar
Certifique-se de que a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.8.0.jre8.jar, mssql-jdbc-12.8.0.jre11.jar.
Para Microsoft JDBC Driver 12.6
Os arquivos mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.6 for SQL Server\sqljdbc_12.6\enu\mssql-jdbc-12.6.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.6/enu/mssql-jdbc-12.6.0.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.6.0.jre8.jar, mssql-jdbc-12.6.0.jre11.jar.
Para Microsoft JDBC Driver 12.4
Os arquivos mssql-jdbc-12.4.0.jre8.jar ou mssql-jdbc-12.4.0.jre11.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.4 for SQL Server\sqljdbc_12.4\enu\mssql-jdbc-12.4.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.4/enu/mssql-jdbc-12.4.0.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.4.0.jre8.jar, mssql-jdbc-12.4.0.jre11.jar.
Para Microsoft JDBC Driver 12.2
Os arquivos mssql-jdbc-12.2.0.jre8.jar ou mssql-jdbc-12.2.0.jre11.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.2 for SQL Server\sqljdbc_12.2\enu\mssql-jdbc-12.2.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.2/enu/mssql-jdbc-12.2.0.jre11.jar
Certifique-se de que a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.2.0.jre8.jar, mssql-jdbc-12.2.0.jre11.jar.
Para Microsoft JDBC Driver 11.2
Os arquivos mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jarou mssql-jdbc-11.2.0.jre18.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre17.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre18.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 11.2 for SQL Server\sqljdbc_11.2\enu\mssql-jdbc-11.2.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_11.2/enu/mssql-jdbc-11.2.0.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar, mssql-jdbc-11.2.0.jre18.jar.
Para Microsoft JDBC Driver 10.2
Os arquivos mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jarou mssql-jdbc-10.2.0.jre17.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre17.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 10.2 for SQL Server\sqljdbc_10.2\enu\mssql-jdbc-10.2.0.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_10.2/enu/mssql-jdbc-10.2.0.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jarou mssql-jdbc-10.2.0.jre17.jar.
Para Microsoft JDBC Driver 9.4
Os arquivos mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jarou mssql-jdbc-9.4.1.jre16.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre16.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.4 for SQL Server\sqljdbc_9.4\enu\mssql-jdbc-9.4.1.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.4/enu/mssql-jdbc-9.4.1.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jarou mssql-jdbc-9.4.1.jre16.jar.
Para Microsoft JDBC Driver 9.2
Os arquivos mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jarou mssql-jdbc-9.2.1.jre15.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre15.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.2 for SQL Server\sqljdbc_9.2\enu\mssql-jdbc-9.2.1.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.2/enu/mssql-jdbc-9.2.1.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jarou mssql-jdbc-9.2.1.jre15.jar.
Para Microsoft JDBC Driver 8.4
Os arquivos mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jarou mssql-jdbc-8.4.1.jre14.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre14.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.4 for SQL Server\sqljdbc_8.4\enu\mssql-jdbc-8.4.1.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.4/enu/mssql-jdbc-8.4.1.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jarou mssql-jdbc-8.4.1.jre14.jar.
Para Microsoft JDBC Driver 8.2
Os arquivos mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jarou mssql-jdbc-8.2.2.jre13.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre13.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.2 for SQL Server\sqljdbc_8.2\enu\mssql-jdbc-8.2.2.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.2/enu/mssql-jdbc-8.2.2.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jarou mssql-jdbc-8.2.2.jre13.jar.
Para Microsoft JDBC Driver 7.4
Os arquivos mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jarou mssql-jdbc-7.4.1.jre12.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre12.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.4 for SQL Server\sqljdbc_7.4\enu\mssql-jdbc-7.4.1.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jarou mssql-jdbc-7.4.1.jre12.jar.
Para Microsoft JDBC Driver 7.2
Os arquivos mssql-jdbc-7.2.2.jre8.jar ou mssql-jdbc-7.2.2.jre11.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.2 for SQL Server\sqljdbc_7.2\enu\mssql-jdbc-7.2.2.jre11.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.2/enu/mssql-jdbc-7.2.2.jre11.jar
Certifique-se de que a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-7.2.2.jre8.jar ou mssql-jdbc-7.2.2.jre11.jar.
Para Microsoft JDBC Driver 7.0
Os arquivos mssql-jdbc-7.0.0.jre8.jar ou mssql-jdbc-7.0.0.jre10.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre10.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.0 for SQL Server\sqljdbc_7.0\enu\mssql-jdbc-7.0.0.jre10.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.0/enu/mssql-jdbc-7.0.0.jre10.jar
Certifique-se de que a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-7.0.0.jre8.jar ou mssql-jdbc-7.0.0.jre10.jar.
Para Microsoft JDBC Driver 6.4
Os arquivos mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jarou mssql-jdbc-6.4.0.jre9.jar são instalados no seguinte local:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre7.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre9.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.4 for SQL Server\sqljdbc_6.4\enu\mssql-jdbc-6.4.0.jre9.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.4/enu/mssql-jdbc-6.4.0.jre9.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jarou mssql-jdbc-6.4.0.jre9.jar.
Para Microsoft JDBC Driver 6.2
Os arquivos mssql-jdbc-6.2.2.jre7.jar ou mssql-jdbc-6.2.2.jre8.jar são instalados nos seguintes locais:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre7.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre8.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.2 for SQL Server\sqljdbc_6.2\enu\mssql-jdbc-6.2.2.jre8.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.2/enu/mssql-jdbc-6.2.2.jre8.jar
Certifique-se de que a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-6.2.2.jre7.jar ou mssql-jdbc-6.2.2.jre8.jar.
Para Microsoft JDBC Driver 4.1, 4.2 e 6.0
O arquivo sqljdbc.jar, arquivo sqljdbc4.jar, arquivo sqljdbc41.jar ou arquivo sqljdbc42.jar é instalado no seguinte local:
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc4.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc41.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc42.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo do Windows:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.0 for SQL Server\sqljdbc_4.2\enu\sqljdbc42.jar
O trecho a seguir é um exemplo da instrução CLASSPATH usada para um aplicativo Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.2/enu/sqljdbc42.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar.
Observação
Em sistemas Windows, nomes de diretório maiores que a convenção de nome de arquivo 8.3 ou nomes de pasta com espaços podem causar problemas com classpaths. Se você suspeitar desses tipos de problemas, mova temporariamente o arquivo sqljdbc.jar, o arquivo sqljdbc4.jar ou o arquivo sqljdbc41.jar para um nome de diretório simples, como C:\Temp
, altere o classpath e determine se isso resolve o problema.
Aplicativos que são executados diretamente no prompt de comando
O classpath é configurado no sistema operacional. Anexe sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar ao classpath do sistema. Como alternativa, você pode especificar o classpath na linha de comando Java que executa o aplicativo com a opção java -classpath
.
Aplicativos executados em um IDE
Cada fornecedor de IDE fornece um método diferente para definir o classpath em seu IDE. Apenas definir o classpath no sistema operacional não funcionará. Você deve adicionar sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar ao classpath do IDE.
Servlets e JSPs
Servlets e JSPs são executados em um mecanismo servlet/JSP como o Tomcat. O classpath deve ser definido de acordo com a documentação do servlet/JSP engine. Apenas definir o classpath no sistema operacional não funcionará. Alguns mecanismos servlet/JSP fornecem telas de configuração que você pode usar para definir o classpath do mecanismo. Nessa situação, você deve anexar o arquivo JAR do driver JDBC correto ao classpath do mecanismo existente e reiniciar o mecanismo. Em outras situações, você pode implantar o driver copiando sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar para um diretório específico, como lib, durante a instalação do mecanismo. O classpath do driver do mecanismo também pode ser especificado num arquivo de configuração específico do mecanismo.
Enterprise JavaBeans
Enterprise Java Beans (EJB) são executados em um contêiner EJB. Os contêineres EJB são provenientes de vários fornecedores. Os applets Java são executados em um navegador, mas são baixados de um servidor web. Copie sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar para a raiz do servidor Web e especifique o nome do arquivo JAR na guia Arquivo HTML do miniaplicativo, por exemplo, <applet ... archive=mssql-jdbc-***.jar>
.
Fazer uma conexão simples com um banco de dados
Para usar a biblioteca de classes sqljdbc.jar, os aplicativos devem primeiro registrar o driver da seguinte maneira:
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
Quando o driver é carregado, você pode estabelecer uma conexão com uma URL de conexão e o método getConnection da classe DriverManager:
String connectionUrl = "jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=<password>;encrypt=false;";
Connection con = DriverManager.getConnection(connectionUrl);
Advertência
A cadeia de conexão acima usa encrypt=false
, que não é recomendado para uso em produção. Para obter mais informações sobre como criptografar sua conexão de banco de dados com JDBC, consulte Conectando-se com criptografia.
A partir da API JDBC 4.0, o método DriverManager.getConnection()
é aprimorado para carregar drivers JDBC automaticamente. Portanto, os aplicativos não precisam chamar o método Class.forName
para registrar ou carregar o driver ao usar bibliotecas jar de driver.
Quando o método getConnection da classe DriverManager é chamado, um driver apropriado está localizado a partir do conjunto de drivers JDBC registrados. sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar arquivo inclui o arquivo "META-INF/services/java.sql.Driver", que contém o com.microsoft.sqlserver.jdbc.SQLServerDriver como um driver registrado. Os aplicativos existentes, que atualmente carregam os drivers usando o método Class.forName, continuarão a funcionar sem modificação.
Observação
sqljdbc4.jar, sqljdbc41.jar ou biblioteca de classes sqljdbc42.jar não podem ser usadas com versões mais antigas do Java Runtime Environment (JRE). Consulte Requisitos do sistema para o driver JDBC para obter a lista de versões do JRE suportadas pelo Microsoft JDBC Driver for SQL Server.
Para obter mais informações sobre como se conectar a fontes de dados e usar uma URL de conexão, consulte Criando a URL de conexão e Definindo as propriedades de conexão.