Como usar o JDBC Driver
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 você 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.
Escolher o arquivo JAR certo
O Microsoft JDBC Driver fornece diferentes arquivos JAR para serem utilizados de acordo com suas configurações preferidas do Java Runtime Environment (JRE), conforme abaixo:
O Microsoft JDBC Driver 12.8 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-12.8.0.jre8.jar e mssql-jdbc-12.8.0.jre11.jar.
O Microsoft JDBC Driver 12.6 para SQL Server fornece os arquivos de biblioteca de classes 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 os arquivos de biblioteca de classes mssql-jdbc-12.4.0.jre8.jar e mssql-jdbc-12.4.0.jre11.jar.
O Microsoft JDBC Driver 12.2 para SQL Server fornece os arquivos 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 os 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.jar e mssql-jdbc-11.2.0.jre18.jar.
O Microsoft JDBC Driver 10.2 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar e mssql-jdbc-10.2.0.jre17.jar.
O Microsoft JDBC Driver 9.4 for SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar e mssql-jdbc-9.4.1.jre16.jar.
O Microsoft JDBC Driver 9.2 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar e mssql-jdbc-9.2.1.jre15.jar.
O Microsoft JDBC Driver 8.4 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar e mssql-jdbc-8.4.1.jre14.jar.
O Microsoft JDBC Driver 8.2 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar e mssql-jdbc-8.2.2.jre13.jar.
O Microsoft JDBC Driver 7.4 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar e mssql-jdbc-7.4.1.jre12.jar.
O Microsoft JDBC Driver 7.2 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-7.2.2.jre8.jar e mssql-jdbc-7.2.2.jre11.jar.
O Microsoft JDBC Driver 7.0 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-7.0.0.jre8.jar e mssql-jdbc-7.0.0.jre10.jar.
O Microsoft JDBC Driver 6.4 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar e mssql-jdbc-6.4.0.jre9.jar.
O Microsoft JDBC Driver 6.2 para SQL Server fornece os arquivos de biblioteca de classes mssql-jdbc-6.2.2.jre7.jar e mssql-jdbc-6.2.2.jre8.jar.
O Microsoft JDBC Driver 6.0 e o 4.2 para SQL Server fornecem os arquivos de biblioteca de classes sqljdbc41.jar e sqljdbc42.jar.
O Microsoft JDBC Driver 4.1 para SQL Server fornece o arquivo de biblioteca de classes sqljdbc41.jar.
Sua escolha determinará os recursos disponíveis. Para saber mais sobre qual arquivo JAR escolher, confira os Requisitos do sistema para o JDBC Driver.
Definindo o classpath
Os arquivos JAR do Microsoft JDBC Driver não fazem parte do Java SDK e devem ser incluídos no Classpath da aplicação do usuário.
Se você estiver utilizando o JDBC Driver 12.8, defina o classpath para incluir o mssql-jdbc-12.8.0.jre8.jar ou o mssql-jdbc-12.8.0.jre11.jar.
Se você estiver utilizando o JDBC Driver 12.6, defina o classpath para incluir o mssql-jdbc-12.6.0.jre8.jar ou o mssql-jdbc-12.6.0.jre11.jar.
Se você estiver usando o JDBC Driver 12.4, defina o classpath para incluir o mssql-jdbc-12.4.0.jre8.jar ou o mssql-jdbc-12.4.0.jre11.jar.
Se você estiver utilizando o JDBC Driver 12.2, defina o classpath para incluir o mssql-jdbc-12.2.0.jre8.jar ou o mssql-jdbc-12.2.0.jre11.jar.
Se você estiver usando o JDBC Driver 11.2, defina o classpath para incluir mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar ou mssql-jdbc-11.2.0.jre18.jar.
Se você estiver usando o JDBC Driver 10.2, defina o classpath para incluir mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou mssql-jdbc-10.2.0.jre17.jar.
Se você está usando o JDBC Driver 9.4, defina o classpath incluindo mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou mssql-jdbc-9.4.1.jre16.jar.
Se estiver usando o JDBC Driver 9.2, defina classpath de maneira a incluir mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar.
Se estiver usando o JDBC Driver 8.4, defina classpath de maneira a incluir mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar ou mssql-jdbc-8.4.1.jre14.jar.
Se estiver usando o JDBC Driver 8.2, defina classpath de maneira a incluir mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar ou mssql-jdbc-8.2.2.jre13.jar.
Se usar o JDBC Driver 7.4, defina o classpath para incluir o mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar ou mssql-jdbc-7.4.1.jre12.jar.
Se usar 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 usar 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 usar o JDBC Driver 6.4, defina o classpath para incluir o mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar ou mssql-jdbc-6.4.0.jre9.jar.
Se usar o JDBC Driver 6.2, defina o classpath para incluir o mssql-jdbc-6.2.2.jre7.jar ou o mssql-jdbc-6.2.2.jre8.jar.
Se você está usando o JDBC Driver 4.1 ou 4.2, defina o classpath incluindo o arquivo sqljdbc41.jar ou sqljdbc42.jar do download do respectivo driver.
Se o classpath não possuir uma entrada para o arquivo JAR correto, o aplicativo gerará uma exceção comum Class not found.
Para o 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 snippet a seguir é um exemplo da instrução CLASSPATH utilizada 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 snippet a seguir é um exemplo da instrução CLASSPATH utilizada para um aplicativo do Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.8/enu/mssql-jdbc-12.8.0.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como o mssql-jdbc-12.8.0.jre8.jar ou mssql-jdbc-12.8.0.jre11.jar.
Para o Microsoft JDBC Driver 12.6
Os arquivos mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar serã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 snippet a seguir é um exemplo da instrução CLASSPATH utilizada 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 snippet a seguir é um exemplo da instrução CLASSPATH utilizada para um aplicativo do 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 o mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar.
Para o Microsoft JDBC Driver 12.4
Os arquivos mssql-jdbc-12.4.0.jre8.jar ou mssql-jdbc-12.4.0.jre11.jar serã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 snippet a seguir é um exemplo da instrução CLASSPATH utilizada 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 snippet a seguir é um exemplo da instrução CLASSPATH utilizada para um aplicativo do 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 o mssql-jdbc-12.4.0.jre8.jar ou mssql-jdbc-12.4.0.jre11.jar.
Para o 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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.2/enu/mssql-jdbc-12.2.0.jre11.jar
Verifique se a instrução CLASSPATH contém apenas um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-12.2.0.jre8.jar ou mssql-jdbc-12.2.0.jre11.jar.
Para o 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.jar ou mssql-jdbc-11.2.0.jre18.jar estã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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do 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 o Microsoft JDBC Driver 10.2
Os arquivos mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou 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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do 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 somente um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou mssql-jdbc-10.2.0.jre17.jar.
Para o Microsoft JDBC Driver 9.4
Os arquivos mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou 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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do 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 somente um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou mssql-jdbc-9.4.1.jre16.jar.
Para o Microsoft JDBC Driver 9.2
Os arquivos mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar serã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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do 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 somente um Microsoft JDBC Driver para SQL Server, como mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar.
Para o Microsoft JDBC Driver 8.4
Os arquivos mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar ou mssql-jdbc-8.4.1.jre14.jar são instalados nas seguintes localizações:
\<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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do 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.jar ou mssql-jdbc-8.4.1.jre14.jar.
Para o Microsoft JDBC Driver 8.2
Os arquivos mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar ou mssql-jdbc-8.2.2.jre13.jar são instalados nas seguintes localizações:
\<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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do 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.jar ou mssql-jdbc-8.2.2.jre13.jar.
Para o Microsoft JDBC Driver 7.4
Os arquivos mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar ou 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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do 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.jar ou mssql-jdbc-7.4.1.jre12.jar.
Para o 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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.2/enu/mssql-jdbc-7.2.2.jre11.jar
Verifique se 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 o 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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.0/enu/mssql-jdbc-7.0.0.jre10.jar
Verifique se 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 o Microsoft JDBC Driver 6.4
Os arquivos mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar ou mssql-jdbc-6.4.0.jre9.jar são instalados nos seguintes locais:
\<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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do 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.jar ou mssql-jdbc-6.4.0.jre9.jar.
Para o 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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.2/enu/mssql-jdbc-6.2.2.jre8.jar
Verifique se 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 o Microsoft JDBC Driver 4.1, 4.2 e 6.0
Os arquivos sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar estão instalados 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 snippet a seguir é um exemplo da instrução CLASSPATH que é 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 snippet a seguir é um exemplo da instrução CLASSPATH que é usada para um aplicativo do Unix/Linux:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.2/enu/sqljdbc42.jar
Verifique se a instrução CLASSPATH contém somente um Microsoft JDBC Driver para SQL Server, como qljdbc.jar, sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar.
Observação
Em sistemas Windows, nomes de diretórios mais longos do que a convenção de arquivos de nome 8.3 ou nomes de pastas com espaços podem causar problemas com classpaths. Se você suspeitar desses tipos de problemas, deverá mover temporariamente os arquivos sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar para um nome de diretório simples, como C:\Temp, alterar o caminho de classe e determinar se isso resolve o problema.
Aplicativos que são executados diretamente no prompt de comando
O classpath é configurado no sistema operacional. Acrescente sqljdbc.jar, sqljdbc4.jar, ou sqljdbc41.jar ao classpath do sistema. Como alternativa, você pode especificar o classpath na linha de comando do Java que executa o aplicativo com a opção java -classpath.
Aplicativos que executam em um IDE
Cada fornecedor de IDE oferece um método diferente para definir o classpath no respectivo IDE. Apenas definir o classpath no sistema operacional não funcionará. Você deve acrescentar sqljdbc.jar, sqljdbc4.jar, ou sqljdbc41.jar ao classpath do IDE.
Servlets e JSPs
Servlets e JSPs são executados em um mecanismo de servlet/JSP como, por exemplo, Tomcat. O classpath deve ser definido de acordo com a documentação de mecanismo de servlet/JSP. Apenas definir o classpath no sistema operacional não funcionará. Alguns mecanismos de servlet/JSP fornecem telas de instalação que você pode usar para definir o classpath do mecanismo. Nessa situação, você deve acrescentar o arquivo JAR correto do JDBC Driver ao classpath de mecanismo existente e deve reiniciar o mecanismo. Em outras situações, você pode implantar o driver copiando sqljdbc.jar, sqljdbc4.jar, ou sqljdbc41.jar em um diretório específico, por exemplo, lib, durante a instalação do mecanismo. O classpath do driver de mecanismo também pode ser especificado em um arquivo de configuração específico do mecanismo.
Enterprise Java Beans
Enterprise Java Beans (EJB) são executados em um contêiner EJB. Contêineres EJB são originados de vários fornecedores. Miniaplicativos 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 do arquivo HTML do miniaplicativo, por exemplo, <applet ... archive=mssql-jdbc-***.jar>.
Fazer uma conexão simples a um banco de dados
Para usar a biblioteca de classes sqljdbc.jar, os aplicativos devem primeiro registrar o driver como segue:
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=*****;encrypt=false;";
Connection con = DriverManager.getConnection(connectionUrl);
Aviso
A cadeia de conexão acima usa encrypt=false, o 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 o JDBC, confira Conectar-se com criptografia.
Começando pela API do JDBC 4.0, o método DriverManager.getConnection() é aprimorado para carregar drivers de JDBC automaticamente. Portanto, os aplicativos não precisam chamar o método Class.forName para registrar ou carregar o driver ao usar as bibliotecas jar do driver.
Quando o método getConnection da classe DriverManager é chamado, um driver apropriado é localizado no conjunto de drivers JDBC registrados. O arquivo sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar 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
A biblioteca de classes sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar não pode ser usada com versões anteriores do Java Runtime Environment (JRE). Confira os Requisitos do sistema para o JDBC Driver para obter a lista de versões do JRE com suporte no Microsoft JDBC Driver para SQL Server.
Para saber mais sobre como se conectar a fontes de dados e usar uma URL de conexão, confira Construindo a URL de conexão e Definindo as propriedades de conexão.