Oracle SQL Developer 設定 TNS_ADMIN 連線 TNS 別名完整步驟

SQL Developer 連線類型選 TNS 卻讀不到 tnsnames.ora？設定 TNS_ADMIN 環境變數即可解決

問題現象

• SQL Developer 4.0.3.16 新增連線，連線類型選 TNS
• 網路別名下拉選單為空，無法選擇 TNS 別名

根因

SQL Developer 未偵測到 tnsnames.ora 所在目錄，需手動指定 TNS_ADMIN 環境變數。

解決方法

方法一：命令列暫時設定（當前視窗有效）

C:\Users\konglb> set TNS_ADMIN=C:\OracleClient\Oracle32\product\11.2.0\client_1\network\admin
C:\Users\konglb> echo %TNS_ADMIN%
C:\OracleClient\Oracle32\product\11.2.0\client_1\network\admin

之後在同一 CMD 視窗啟動 sqldeveloper.exe 即可讀取 TNS。

方法二：系統環境變數永久生效（推薦）

1. 右鍵「這台電腦」→ 內容 → 進階系統設定 → 環境變數
2. 系統變數 / 使用者變數 → 新增
   • 變數名：TNS_ADMIN
   • 變數值：C:\OracleClient\Oracle32\product\11.2.0\client_1\network\admin（tnsnames.ora 所在目錄）
3. 確定重啟 SQL Developer

驗證

重新開啟 SQL Developer 新增連線 → 連線類型 TNS → 網路別名下拉選單應顯示 tnsnames.ora 定義的所有別名。

補充說明

• TNS_ADMIN 指向目錄，而非檔案
• 目錄下應包含 tnsnames.ora、sqlnet.ora、listener.ora
• 多 Oracle Home 環境請指向正確 Client Home 的 network/admin
• Linux/Mac 同理：export TNS_ADMIN=/path/to/network/admin 寫入 .bashrc 或 .profile

一個環境變數解決 SQL Developer TNS 別名讀取問題，開發效率提升利器。