使用 JDBC 驱动程序

SQL Server 2008 R2其他版本 SQL Server 2008SQL Server 2005


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

选择正确的 JAR 文件
--------------------------------------------------------------------------------

Microsoft SQL Server JDBC Driver 提供两个类库文件：sqljdbc.jar 和 sqljdbc4.jar，具体使用哪个文件取决于首选的 Java 运行时环境 (JRE) 设置。有关选择哪个 JAR 文件的详细信息，请参阅 JDBC 驱动程序的系统要求。

设置 Classpath
--------------------------------------------------------------------------------

JDBC Driver 并未包含在 Java SDK 中。如果要使用该驱动程序，必须将 classpath 设置为包含 sqljdbc.jar 文件或 sqljdbc4.jar 文件。如果 classpath 缺少 sqljdbc.jar 项或 sqljdbc4.jar 项，应用程序将引发“找不到类”的常见异常。

sqljdbc.jar 文件和 sqljdbc4.jar 文件的安装位置如下：

<安装目录>\sqljdbc_<版本>\<语言>\sqljdbc.jar

<安装目录>\sqljdbc_<版本>\<语言>\sqljdbc4.jar

下面是用于 Windows 应用程序的 CLASSPATH 语句示例：

CLASSPATH =.;C:\Program Files\Microsoft SQL Server JDBC Driver\sqljdbc_3.0\enu\sqljdbc.jar

下面是用于 Unix/Linux 应用程序的 CLASSPATH 语句示例：

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_3.0/enu/sqljdbc.jar

必须确保 CLASSPATH 语句仅包含一个 Microsoft SQL Server JDBC driver，例如 sqljdbc.jar 或 sqljdbc4.jar。

注意：
在 Windows 系统中，如果目录名长于 8.3 或文件夹名中包含空格，将会导致 classpath 出现问题。如果怀疑存在这类问题，应暂时将 sqljdbc.jar 文件或 sqljdbc4.jar 文件移动到名称简单的目录中，例如 C:\Temp，更改 classpath，然后测试这样是否解决了问题。



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

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

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

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

与数据库建立简单连接
--------------------------------------------------------------------------------

使用 sqljdbc.jar 类库时，应用程序必须首先按如下所示注册驱动程序：

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

加载驱动程序后，可通过使用连接 URL 和 DriverManager 类的 getConnection 方法来建立连接：

复制String connectionUrl = "jdbc:sqlserver://localhost:1433;" +
   "databaseName=AdventureWorks;user=MyUserName;password=*****;";
Connection con = DriverManager.getConnection(connectionUrl);
在 JDBC API 4.0 中，DriverManager.getConnection 方法得到了增强，可自动加载 JDBC Driver。因此，使用 sqljdbc4.jar 类库时，应用程序无需调用 Class.forName 方法来注册或加载驱动程序。

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

注意：
sqljdbc4.jar 类库要求使用 6.0 或更高版本的 Java 运行时环境 (JRE)。



有关如何连接数据源和使用连接 URL 的详细信息，请参阅创建连接 URL 和设置连接属性。