萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

Eclipse 連線 SQL Server 2012 完整設定指南:JDBC 驅動、通訊協定、CLASSPATH 與 Tomcat 整合

前置條件

  • SQL Server 2012 設定為 SQL Server 驗證模式 (混合模式)。
  • 已安裝 JDK 1.7+ (範例使用 1.7)。

一、SQL Server 端:啟用 TCP/IP 與固定連接埠

  1. 啟動 SQL Server 組態管理員:
    開始 → 所有程式 → Microsoft SQL Server 2012 → 組態工具 → SQL Server 組態管理員。
  2. 左側展開 SQL Server 網路組態 → 選取 MSSQLSERVER 的通訊協定 (或具名執行個體名稱)。
  3. 右側啟用下列協定:
    Named Pipes → 啟用
    TCP/IP → 啟用
  4. 雙擊 TCP/IP → 「IP 位址」頁籤:
    • IP1、IP10 (或所有 IPn):**IP 位址 = 127.0.0.1**,**已啟用 = 是**。
    • 捲動至底部 IPAll:**TCP 連接埠 = 1433** (清空 TCP 動態連接埠)。
  5. 重新啟動電腦 (或重啟 SQL Server 服務)。
SQL Server 組態管理員 通訊協定啟用 TCP/IP IP 位址設定 IPAll 連接埠設定

二、驗證連接埠開放

  1. 開啟 Telnet 用戶端 (Win7: 控制台 → 程式 → 開啟或關閉 Windows 功能 → 勾選 Telnet Client)。
  2. 命令提示字元執行:
    telnet 127.0.0.1 1433
  3. 成功:畫面清空/顯示連線中 (如圖)。
    失敗:顯示「無法開啟與主機的連線,連接埠 1433: 連線失敗」 → 回檢步驟一。
telnet 測試指令 telnet 成功畫面

三、JDBC 驅動安裝與 CLASSPATH 設定

  1. 下載 Microsoft JDBC Driver 4.0 for SQL Server (sqljdbc_4.0.2206.100_chs.tar.gz)。
  2. 解壓取得 sqljdbc4.jar (支援 JDBC 4.0 / JRE 1.7+)。
    捨棄 sqljdbc.jar (僅支援 JRE 1.6),混用會報錯「此驅動程式不支援 JRE 1.7」。
  3. 建立資料夾 D:\sqljdbc4,放入 sqljdbc4.jar。
sqljdbc4.jar 放置位置

環境變數 CLASSPATH 設定

  1. 右鍵「電腦」→ 內容 → 進階系統設定 → 環境變數。
  2. 系統變數 → 找 CLASSPATH → 編輯 → 末尾加入:
    ;D:\sqljdbc4\sqljdbc4.jar (前面必須有分號)。
  3. 若無 CLASSPATH → 新建,值設為 D:\sqljdbc4\sqljdbc4.jar。
環境變數 CLASSPATH 設定

四、關鍵:將 jar 複製至所有 JRE/JDK ext 目錄與 Tomcat lib (必做!)

單設 CLASSPATH 不足夠,Eclipse/Tomcat 執行時使用各自的類別載入器,必須實體放置 jar:

  1. D:\Program Files\Java\jdk1.7.0\jre\lib\ext\
  2. D:\Program Files\Java\jre7\lib\ext\ (所有 JRE 目錄皆需放入)
  3. Tomcat: C:\apache-tomcat-7.0.11\lib\
  4. Web 應用: D:\apache-tomcat-7.0.11\webapps\YourApp\WEB-INF\lib\

只放 sqljdbc4.jar,切勿同時放 sqljdbc.jar!

五、Eclipse 專案測試連線

  1. SSMS 建立測試資料庫 Test。
  2. Eclipse 新建 Java Project Test。
  3. 右鍵專案 → Build Path → Configure Build Path → Libraries → Add External JARs → 選取 sqljdbc4.jar。
Eclipse Build Path 設定

測試程式碼


package pkg;
import java.sql.*;

public class Main {
    public static void main(String[] args) {
        String driver = "com.microsoft.sqlserver.jdbc.SQLServerDriver";
        String url = "jdbc:sqlserver://localhost:1433;DatabaseName=Test";
        String user = "sa";
        String pwd = "your_password";

        try {
            Class.forName(driver);
            Connection conn = DriverManager.getConnection(url, user, pwd);
            System.out.println("連線資料庫成功!");
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println("連線失敗");
        }
    }
}

查詢資料表注意事項


String sql = "SELECT * FROM [Test].[dbo].[YourTable] WHERE ..."; 
// 必須加中括號 [Database].[Schema].[Table]

六、執行驗證

右鍵 Main.java → Run As → Java Application。主控台輸出「連線資料庫成功!」即代表整串設定完成。

Eclipse 控制台成功訊息

常見坑點總結

  • TCP/IP 未啟用或連接埠非 1433。
  • 防火牆阻擋 1433。
  • 混用 sqljdbc.jar + sqljdbc4.jar → ClassCastException / 不支援 JRE 1.7 錯誤。
  • 未將 jar 放入 JRE ext 目錄與 Tomcat lib → ClassNotFoundException。
  • 連線字串缺少 DatabaseName 或執行個體名稱錯誤 (如 IP\SQLEXPRESS)。

總結

Eclipse 連線 SQL Server 2012 關鍵在於:伺服器端啟用 TCP/IP 固定 1433 埠 → 防火牆開放 → 僅使用 sqljdbc4.jar → 複製至所有 JRE ext 目錄、Tomcat lib、專案 Build Path。完成後以簡單 JDBC 程式驗證,即可投入開發。

copyright © 萬盛學電腦網 all rights reserved