Export (0) Print
Expand All

System Requirements for the JDBC Driver

To access data from a SQL Server or SQL Azure Database by using the Microsoft JDBC Driver for SQL Server, you must have the following components installed on your computer:

  • Microsoft JDBC Driver for SQL Server

    You can download the Microsoft JDBC Drivers 4.1 (Preview) and 4.0 for SQL Server from the Microsoft Download Center. Microsoft JDBC Driver 4.0 is also available from the SQL Server 2012 Feature Pack web page.

  • Java Runtime Environment

Starting with the Microsoft JDBC Driver 4.1 (Preview) for SQL Server, Sun Java SE Development Kit (JDK) 7.0 and Java Runtime Environment (JRE) 7.0 is supported.

Starting with the Microsoft JDBC Driver 4.0 for SQL Server, the JDBC driver support for Java Database Connectivity (JDBC) Spec API has been extended to include the JDBC 4.0 API. The JDBC 4.0 API was introduced as part of the Sun Java SE Development Kit (JDK) 6.0 and Java Runtime Environment (JRE) 6.0. JDBC 4.0 is a superset of the JDBC 3.0 API.

When you deploy the Microsoft JDBC Driver for SQL Server on Windows and UNIX operating systems, you must use the installation packages, sqljdbc_<version>_enu.exe and sqljdbc_<version>_enu.tar.gz, respectively. For more information about how to deploy the JDBC Driver, see Deploying the JDBC Driver topic.


Microsoft JDBC Driver 4.1 (Preview) for SQL Server:

To support backward compatibility and possible upgrade scenarios, the JDBC Driver 4.1 (Preview) includes three JAR class libraries in each installation package: sqljdbc.jar, sqljdbc4.jar, and sqljdbc41.jar.

JAR

Description

sqljdbc.jar

sqljdbc.jar class library provides support for JDBC 3.0.

sqljdbc.jar class library requires a Java Runtime Environment (JRE) of version 5.0. Using sqljdbc.jar on JRE 6.0 or JRE 7.0 will throw an exception when connecting to a database.

Note Note
The JDBC Driver does not support JRE 1.4. You must upgrade JRE 1.4 to JRE 5.0, JRE 6.0, or JRE 7.0 when using the JDBC Driver. In some cases, you might need to recompile your application because it might not be compatible with JDK 5.0 API or JDK 6.0 API. For more information, see the documentation on the Sun Microsystems website.

sqljdbc4.jar

sqljdbc4.jar class library provides support for JDBC 4.0 API. It includes all of the features of the sqljdbc.jar as well as the new JDBC 4.0 API methods.

sqljdbc4.jar class library requires a Java Runtime Environment (JRE) of version 6.0 or 7.0. Using sqljdbc4.jar on JRE 5.0 will throw an exception.

Note Note
Use sqljdbc4.jar when your application must run on JRE 6.0 or 7.0, even if your application does not use JDBC 4.0 API features.

sqljdbc41.jar

sqljdbc41.jar class library provides support for JDBC 4.0 API. It includes all of the features of the sqljdbc4.jar as well as the JDBC 4.0 API methods. JDBC 4.1 is not supported (will throw an exception “SQLFeatureNotSupportedException”).

sqljdbc41.jar class library requires a Java Runtime Environment (JRE) 7.0. Using sqljdbc41.jar on JRE 6.0 and 5.0 will throw an exception.

Note Note
Use sqljdbc41.jar when your application must compile with JDK 7.0.

Note that the JDBC driver is designed to work with and be supported by all major Sun equivalent Java virtual machines, but is tested on Sun JRE 5.0, 6.0 and 7.0.

The following summarizes support provided by the three JAR files included with Microsoft JDBC Driver 4.1 (Preview) for SQL Server.

JAR

JDBC Version

JRE (can run)

JDK (can compile)

sqljdbc.jar

3

5

5

sqljdbc4.jar

4

7 6

6 5

sqljdbc41.jar

4

7

7 6 5



Microsoft JDBC Driver 4.0 for SQL Server:

To support backward compatibility and possible upgrade scenarios, the JDBC Driver includes two JAR class libraries in each installation package: sqljdbc.jar and sqljdbc4.jar.

JAR

Description

sqljdbc.jar

sqljdbc.jar class library provides support for JDBC 3.0.

sqljdbc.jar class library requires a Java Runtime Environment (JRE) of version 5.0. Using sqljdbc.jar on JRE 6.0 or JRE 7.0 will throw an exception when connecting to a database.

Note Note
The JDBC Driver does not support JRE 1.4. You must upgrade JRE 1.4 to JRE 5.0, JRE 6.0, or JRE 7.0 when using the JDBC Driver. In some cases, you might need to recompile your application because it might not be compatible with JDK 5.0 API or JDK 6.0 API. For more information, see the documentation on the Sun Microsystems website. Microsoft JDBC Driver 4.0 for SQL Server does not support JDK 7.

sqljdbc4.jar

sqljdbc4.jar class library provides support for JDBC 4.0 API. It includes all of the features of the sqljdbc.jar as well as the new JDBC 4.0 API methods.

sqljdbc4.jar class library requires a Java Runtime Environment (JRE) of version 6.0 or 7.0. Using sqljdbc4.jar on JRE 5.0 will throw an exception.

Note Note
Use sqljdbc4.jar when your application must run on JRE 6.0 or 7.0, even if your application does not use JDBC 4.0 API features.

Note that the JDBC driver is designed to work with and be supported by all major Sun equivalent Java virtual machines, but is tested on Sun JRE 5.0, 6.0 and 7.0.

The JDBC driver supports connections to a SQL Azure Database and SQL Server. For Microsoft JDBC Driver 4.1 (Preview) for SQL Server, support begins with SQL Server 2008. For Microsoft JDBC Driver 4.0 for SQL Server, support beings with SQL Server 2005.

The JDBC driver is designed to work on any operating system that supports the use of a Java Virtual Machine (JVM). However, only Sun Solaris, SUSE Linux, and Windows operating systems have officially been tested.

The JDBC driver supports all SQL Server column collations. For more information about the collations supported by the JDBC driver, see International Features of the JDBC Driver.

For more information about collations, see "Working with Collations" in SQL Server Books Online.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft