使用 JDBC 驱动程序

下载 JDBC 驱动程序

本部分提供使用 Microsoft JDBC Driver for SQL Server 与 SQL Server 数据库建立简单连接的快速入门指导。 在连接到 SQL Server 数据库之前,必须首先在本地计算机或服务器上安装 SQL Server,并且必须在本地计算机上安装 JDBC 驱动程序。

选择正确的 JAR 文件

Microsoft JDBC Driver 提供不同的 Jar,可对应用于首选的 Java Runtime Environment (JRE) 设置,如下所示:

Microsoft JDBC Driver 12.8 for SQL Server 提供 mssql-jdbc-12.8.0.jre8.jarmssql-jdbc-12.8.0.jre11.jar 类库文件。

Microsoft JDBC Driver 12.6 for SQL Server 提供 mssql-jdbc-12.6.0.jre8.jarmssql-jdbc-12.6.0.jre11.jar 类库文件。

Microsoft JDBC Driver 12.4 for SQL Server 提供 mssql-jdbc-12.4.0.jre8.jarmssql-jdbc-12.4.0.jre11.jar 类库文件。

Microsoft JDBC Driver 12.2 for SQL Server 提供 mssql-jdbc-12.2.0.jre8.jarmssql-jdbc-12.2.0.jre11.jar 类库文件。

Microsoft JDBC Driver 11.2 for SQL Server 提供 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 类库文件。

Microsoft JDBC Driver 10.2 for SQL Server 提供 mssql-jdbc-10.2.0.jre8.jar、mssql-jdbc-10.2.0.jre11.jar 和 mssql-jdbc-10.2.0.jre17.jar 类库文件。

Microsoft JDBC Driver 9.4 for SQL Server 提供 mssql-jdbc-9.4.1.jre8.jar、mssql-jdbc-9.4.1.jre11.jar 和 mssql-jdbc-9.4.1.jre16.jar 类库文件 。

Microsoft JDBC Driver 9.2 for SQL Server 提供 mssql-jdbc-9.2.1.jre8.jar、mssql-jdbc-9.2.1.jre11.jar 和 mssql-jdbc-9.2.1.jre15.jar 类库文件。

Microsoft JDBC Driver 8.4 for SQL Server 提供 mssql-jdbc-8.4.1.jre8.jar、mssql-jdbc-8.4.1.jre11.jar 和 mssql-jdbc-8.4.1.jre14.jar 类库文件。

Microsoft JDBC Driver 8.2 for SQL Server 提供 mssql-jdbc-8.2.2.jre8.jar、mssql-jdbc-8.2.2.jre11.jar 和 mssql-jdbc-8.2.2.jre13.jar 类库文件 。

Microsoft JDBC Driver 7.4 for SQL Server 提供 mssql-jdbc-7.4.1.jre8.jar 、mssql-jdbc-7.4.1.jre11.jar 和 mssql-jdbc-7.4.1.jre12.jar 类库文件。

Microsoft JDBC Driver 7.2 for SQL Server 提供 mssql-jdbc-7.2.2.jre8.jar 和 mssql-jdbc-7.2.2.jre11.jar 类库文件。

Microsoft JDBC Driver 7.0 for SQL Server 提供 mssql-jdbc-7.0.0.jre8.jar 和 mssql-jdbc-7.0.0.jre10.jar 类库文件。

Microsoft JDBC Driver 6.4 for SQL Server 提供 mssql-jdbc-6.4.0.jre7.jar 、mssql-jdbc-6.4.0.jre8.jar 和 mssql-jdbc-6.4.0.jre9.jar 类库文件。

Microsoft JDBC Driver 6.2 for SQL Server 提供 mssql-jdbc-6.2.2.jre7.jar 和 mssql-jdbc-6.2.2.jre8.jar 类库文件。

Microsoft JDBC Driver 6.0 for SQL Server 和 Microsoft JDBC Driver 4.2 for SQL Server 提供 sqljdbc41.jar 和 sqljdbc42.jar 类库文件。

Microsoft JDBC Driver 4.1 for SQL Server 提供 sqljdbc41.jar 类库文件。

你的选择将确定可用功能。 若要详细了解选择哪个 JAR 文件,请参阅 JDBC 驱动程序的系统要求

设置 Classpath

Microsoft JDBC Driver jar 不是 Java SDK 的一部分,必须包含在用户应用程序的 Classpath 中。

如果使用 JDBC Driver 12.8,请设置 classpath 以包含 mssql-jdbc-12.8.0.jre8.jarmssql-jdbc-12.8.0.jre11.jar

如果使用 JDBC Driver 12.6,请设置 classpath 以包含 mssql-jdbc-12.6.0.jre8.jarmssql-jdbc-12.6.0.jre11.jar

如果使用 JDBC Driver 12.4,请设置 classpath 以包含 mssql-jdbc-12.4.0.jre8.jarmssql-jdbc-12.4.0.jre11.jar

如果使用 JDBC Driver 12.2,请设置 classpath 以包含 mssql-jdbc-12.2.0.jre8.jarmssql-jdbc-12.2.0.jre11.jar

如果使用 JDBC Driver 11.2,请设置 classpath 以包括 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。

如果使用 JDBC Driver 10.2,请设置 classpath 以包括 mssql-jdbc-10.2.0.jre8.jar、mssql-jdbc-10.2.0.jre11.jar 或 mssql-jdbc-10.2.0.jre17.jar。

如果使用 JDBC Driver 9.4,请设置 classpath 以包括 mssql-jdbc-9.4.1.jre8.jar、mssql-jdbc-9.4.1.jre11.jar 或 mssql-jdbc-9.4.1.jre16.jar 。

如果使用 JDBC Driver 9.2,请设置 classpath 以包括 mssql-jdbc-9.2.1.jre8.jar、mssql-jdbc-9.2.1.jre11.jar 或 mssql-jdbc-9.2.1.jre15.jar。

如果使用 JDBC Driver 8.4,请设置 classpath 以包括 mssql-jdbc-8.4.1.jre8.jar、mssql-jdbc-8.4.1.jre11.jar 或 mssql-jdbc-8.4.1.jre14.jar。

如果使用 JDBC Driver 8.2,请设置 classpath 以包括 mssql-jdbc-8.2.2.jre8.jar、mssql-jdbc-8.2.2.jre11.jar 或 mssql-jdbc-8.2.2.jre13.jar 。

如果使用 JDBC Driver 7.4,请设置 classpath 以包括 mssql-jdbc-7.4.1.jre8.jar、 、mssql-jdbc-7.4.1.jre11.jar 或 mssql-jdbc-7.4.1.jre12.jar 。

如果使用 JDBC Driver 7.2,请设置 classpath 以包括 mssql-jdbc-7.2.2.jre8.jar 或 mssql-jdbc-7.2.2.jre11.jar 。

如果使用 JDBC Driver 7.0,请设置 classpath 以包括 mssql-jdbc-7.0.0.jre8.jar 或 mssql-jdbc-7.0.0.jre10.jar 。

如果使用 JDBC Driver 6.4,请设置 classpath 以包括 mssql-jdbc-6.4.0.jre7.jar、 、mssql-jdbc-6.4.0.jre8.jar 或 mssql-jdbc-6.4.0.jre9.jar 。

如果使用 JDBC Driver 6.2,请设置 classpath 以包括 mssql-jdbc-6.2.2.jre7.jar 或 mssql-jdbc-6.2.2.jre8.jar 。

如果使用 JDBC Driver 4.1 或 4.2,请设置 classpath 以包括来自相应驱动程序下载的 sqljdbc41.jar 或 sqljdbc42.jar 文件 。

如果 classpath 缺少正确 Jar 文件的条目,应用程序将引发常见的 Class not found 异常。

对于 Microsoft JDBC Driver 12.8

mssql-jdbc-12.8.0.jre8.jarmssql-jdbc-12.8.0.jre11.jar 文件安装在以下位置:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre11.jar

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.8 for SQL Server\sqljdbc_12.8\enu\mssql-jdbc-12.8.0.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.8/enu/mssql-jdbc-12.8.0.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-12.8.0.jre8.jarmssql-jdbc-12.8.0.jre11.jar

对于 Microsoft JDBC Driver 12.6

mssql-jdbc-12.6.0.jre8.jarmssql-jdbc-12.6.0.jre11.jar 文件安装在以下位置:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre11.jar

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.6 for SQL Server\sqljdbc_12.6\enu\mssql-jdbc-12.6.0.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.6/enu/mssql-jdbc-12.6.0.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-12.6.0.jre8.jarmssql-jdbc-12.6.0.jre11.jar

对于 Microsoft JDBC Driver 12.4

mssql-jdbc-12.4.0.jre8.jarmssql-jdbc-12.4.0.jre11.jar 文件安装在以下位置:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre11.jar

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.4 for SQL Server\sqljdbc_12.4\enu\mssql-jdbc-12.4.0.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.4/enu/mssql-jdbc-12.4.0.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-12.4.0.jre8.jarmssql-jdbc-12.4.0.jre11.jar

对于 Microsoft JDBC Driver 12.2

mssql-jdbc-12.2.0.jre8.jar 或 mssql-jdbc-12.2.0.jre11.jar 文件安装在以下位置:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre11.jar

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.2 for SQL Server\sqljdbc_12.2\enu\mssql-jdbc-12.2.0.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.2/enu/mssql-jdbc-12.2.0.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-12.2.0.jre8.jar、mssql-jdbc-12.2.0.jre11.jar。

对于 Microsoft JDBC Driver 11.2

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 文件安装在以下位置:

\<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

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 11.2 for SQL Server\sqljdbc_11.2\enu\mssql-jdbc-11.2.0.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_11.2/enu/mssql-jdbc-11.2.0.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 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。

对于 icrosoft JDBC Driver 10.2

mssql-jdbc-10.2.0.jre8.jar、mssql-jdbc-10.2.0.jre11.jar 或 mssql-jdbc-10.2.0.jre17.jar 文件安装在以下位置:

\<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

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 10.2 for SQL Server\sqljdbc_10.2\enu\mssql-jdbc-10.2.0.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_10.2/enu/mssql-jdbc-10.2.0.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-10.2.0.jre8.jar、mssql-jdbc-10.2.0.jre11.jar 或 mssql-jdbc-10.2.0.jre17.jar。

对于 Microsoft JDBC Driver 9.4

mssql-jdbc-9.4.1.jre8.jar、mssql-jdbc-9.4.1.jre11.jar 或 mssql-jdbc-9.4.1.jre16.jar 文件安装在以下位置 :

\<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

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.4 for SQL Server\sqljdbc_9.4\enu\mssql-jdbc-9.4.1.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.4/enu/mssql-jdbc-9.4.1.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-9.4.1.jre8.jar、mssql-jdbc-9.4.1.jre11.jar 或 mssql-jdbc-9.4.1.jre16.jar 。

对于 Microsoft JDBC Driver 9.2

mssql-jdbc-9.2.1.jre8.jar、mssql-jdbc-9.2.1.jre11.jar 或 mssql-jdbc-9.2.1.jre15.jar 文件安装在以下位置:

\<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

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.2 for SQL Server\sqljdbc_9.2\enu\mssql-jdbc-9.2.1.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.2/enu/mssql-jdbc-9.2.1.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-9.2.1.jre8.jar、mssql-jdbc-9.2.1.jre11.jar 或 mssql-jdbc-9.2.1.jre15.jar。

对于 Microsoft JDBC Driver 8.4

mssql-jdbc-8.4.1.jre8.jar、mssql-jdbc-8.4.1.jre11.jar 或 mssql-jdbc-8.4.1.jre14.jar 文件安装在以下位置:

\<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

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.4 for SQL Server\sqljdbc_8.4\enu\mssql-jdbc-8.4.1.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.4/enu/mssql-jdbc-8.4.1.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-8.4.1.jre8.jar、mssql-jdbc-8.4.1.jre11.jar 或 mssql-jdbc-8.4.1.jre14.jar。

对于 Microsoft JDBC Driver 8.2

mssql-jdbc-8.2.2.jre8.jar、mssql-jdbc-8.2.2.jre11.jar 或 mssql-jdbc-8.2.2.jre13.jar 文件安装在以下位置 :

\<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

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.2 for SQL Server\sqljdbc_8.2\enu\mssql-jdbc-8.2.2.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.2/enu/mssql-jdbc-8.2.2.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-8.2.2.jre8.jar、mssql-jdbc-8.2.2.jre11.jar 或 mssql-jdbc-8.2.2.jre13.jar 。

对于 Microsoft JDBC Driver 7.4

mssql-jdbc-7.4.1.jre8.jar 、mssql-jdbc-7.4.1.jre11.jar 或 mssql-jdbc-7.4.1.jre12.jar 文件安装在以下位置:

\<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

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.4 for SQL Server\sqljdbc_7.4\enu\mssql-jdbc-7.4.1.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-7.4.1.jre8.jar 、mssql-jdbc-7.4.1.jre11.jar 或 mssql-jdbc-7.4.1.jre12.jar 。

对于 Microsoft JDBC Driver 7.2

mssql-jdbc-7.2.2.jre8.jar 或 mssql-jdbc-7.2.2.jre11.jar 文件安装在以下位置:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre11.jar

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.2 for SQL Server\sqljdbc_7.2\enu\mssql-jdbc-7.2.2.jre11.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.2/enu/mssql-jdbc-7.2.2.jre11.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-7.2.2.jre8.jar 或 mssql-jdbc-7.2.2.jre11.jar 。

对于 Microsoft JDBC Driver 7.0

mssql-jdbc-7.0.0.jre8.jar 或 mssql-jdbc-7.0.0.jre10.jar 文件安装在以下位置:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre8.jar

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre10.jar

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.0 for SQL Server\sqljdbc_7.0\enu\mssql-jdbc-7.0.0.jre10.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.0/enu/mssql-jdbc-7.0.0.jre10.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-7.0.0.jre8.jar 或 mssql-jdbc-7.0.0.jre10.jar 。

对于 Microsoft JDBC Driver 6.4

mssql-jdbc-6.4.0.jre7.jar、mssql-jdbc-6.4.0.jre8.jar 或 mssql-jdbc-6.4.0.jre9.jar 文件安装在以下位置:

\<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

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.4 for SQL Server\sqljdbc_6.4\enu\mssql-jdbc-6.4.0.jre9.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.4/enu/mssql-jdbc-6.4.0.jre9.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-6.4.0.jre7.jar、mssql-jdbc-6.4.0.jre8.jar 或 mssql-jdbc-6.4.0.jre9.jar。

对于 Microsoft JDBC Driver 6.2

mssql-jdbc-6.2.2.jre7.jar 或 mssql-jdbc-6.2.2.jre8.jar 文件安装在以下位置:

\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre7.jar
  
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre8.jar

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.2 for SQL Server\sqljdbc_6.2\enu\mssql-jdbc-6.2.2.jre8.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.2/enu/mssql-jdbc-6.2.2.jre8.jar

确保 CLASSPATH 语句仅包含一个 Microsoft JDBC Driver for SQL Server,例如 mssql-jdbc-6.2.2.jre7.jar 或 mssql-jdbc-6.2.2.jre8.jar。

对于 Microsoft JDBC Driver 4.1、4.2 和 6.0

Sqljdbc.jar 文件、sqljdbc4.jar 文件、sqljdbc41.jar 或 sqljdbc42.jar 文件安装在以下位置:

\<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  

以下代码片段是用于 Windows 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.0 for SQL Server\sqljdbc_4.2\enu\sqljdbc42.jar

以下代码片段是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例:

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.2/enu/sqljdbc42.jar

必须确保 CLASSPATH 语句只包含一个 Microsoft JDBC Driver for SQL Server,例如 sqljdbc.jar、sqljdbc4.jar、sqljdbc41.jar 或 sqljdbc42.jar。

注意

在 Windows 系统上,长度超过 8.3 文件名约定的目录名称或带有空格的文件夹名称可能会导致类路径问题。 如果你怀疑存在这些类型的问题,应将 sqljdbc.jar 文件、sqljdbc4.jar 文件或 sqljdbc41.jar 文件暂时移到简单的目录名称(例如 C:\Temp)中,更改类路径,然后确定是否已解决该问题。

直接在命令提示符运行的应用程序

classpath 是在操作系统中配置的。 将 sqljdbc.jar、sqljdbc4.jar 或 sqljdbc41.jar 追加到系统的 classpath 中。 或者,可使用 java -classpath 选项,在运行此应用程序的 Java 命令行上指定 classpath。

在 IDE 中运行的应用程序

每个 IDE 供应商都提供了在 IDE 中设置 classpath 的不同方法。 仅在操作系统中设置 classpath 将无法正常工作。 必须将 sqljdbc.jar、sqljdbc4.jar 或 sqljdbc41.jar 添加到 IDE 类路径。

Servlet 和 JSP

Servlet 和 JSP 在 servlet/JSP 引擎(如 Tomcat)中运行。 必须根据 servlet/JSP 引擎文档来设置 classpath。 仅在操作系统中设置 classpath 将无法正常工作。 一些 servlet/JSP 引擎提供了设置屏幕,用于设置引擎的 classpath。 在这种情况下,必须将正确的 JDBC 驱动程序 JAR 文件追加到现有的引擎 classpath,然后重新启动引擎。 在其他情况下,通过在引擎安装期间将 sqljdbc.jar、sqljdbc4.jar 或 sqljdbc41.jar 复制到 lib 之类的特定目录,可以部署此驱动程序。 也可以在引擎专用的配置文件中指定引擎驱动程序的 classpath。

Enterprise Java Beans

Enterprise Java Bean (EJB) 在 EJB 容器中运行。 EJB 容器来自多家供应商。 Java 小程序在浏览器中运行,但是从 Web 服务器上下载的。 将 sqljdbc.jar、sqljdbc4.jar 或 sqljdbc41.jar 复制到 Web 服务器根并在小程序的 HTML 存档选项卡中指定 JAR 文件的名称,例如 <applet ... archive=mssql-jdbc-***.jar>

与数据库建立简单连接

若要使用 sqljdbc.jar 类库,应用程序必须首先按如下所示注册驱动程序:

Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");

加载驱动程序后,可通过’连接 URL 和 DriverManager 类的 getConnection 方法来建立连接:

String connectionUrl = "jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=<password>;encrypt=false;";  
Connection con = DriverManager.getConnection(connectionUrl);  

警告

上述连接字符串使用 encrypt=false,不建议将其用于生产。 有关使用 JDBC 加密数据库连接的详细信息,请参阅使用加密进行连接

从 JDBC API 4.0 开始,DriverManager.getConnection() 方法得到了增强,可自动加载 JDBC 驱动程序。 因此,使用驱动程序 jar 库时,应用程序无需调用 Class.forName 方法来注册或加载驱动程序。

调用 DriverManager 类的 getConnection 方法时,会从已注册的 JDBC 驱动程序集中找到相应的驱动程序。 sqljdbc4.jar、sqljdbc41.jar 或 sqljdbc42.jar 文件包括“META-INF/services/java.sql.Driver”文件,其中包含 com.microsoft.sqlserver.jdbc.SQLServerDriver 作为注册驱动程序。 当前通过使用 Class.forName 方法加载驱动程序的现有应用程序将继续工作,无需进行修改。

注意

sqljdbc4.jar、sqljdbc41.jar 或 sqljdbc42.jar 类库无法用于较早版本的 Java Runtime Environment (JRE)。 有关 Microsoft JDBC Driver for SQL Server 支持的 JRE 版本列表,请参阅 JDBC 驱动程序的系统要求

若要详细了解如何与数据源连接,以及如何使用连接 URL,请参阅生成连接 URL设置连接属性

另请参阅

JDBC 驱动程序概述