前言
PL/SQL Developer 是廣受歡迎的 Oracle 開發工具，但初次使用時常因缺少 Oracle Client 或設定不當而無法連線。本文以圖文並茂方式，詳細說明從安裝 Client、配置工具偏好設定、到成功登入資料庫的完整流程。
一、認識登入介面的差異
啟動 PL/SQL Developer 時，登入視窗可能出現兩種樣貌：
- 基本版：僅有「用戶名、密碼、資料庫」三欄。
- 完整版：多出「連接為」下拉選單（可選 NORMAL、SYSDBA、SYSOPER）。
差異在於電腦是否已安裝 Oracle Client 並正確寫入登錄表。若無 Client，工具無法讀取連接角色資訊，導致缺少「連接為」欄位，進而無法連線。
二、安裝 Oracle Instant Client（輕量版）
- 從 Oracle 官網下載對應作業系統的 Instant Client Basic Package（含 OCI、SQL*Net 等核心庫）。
- 解壓縮至固定路徑，例如
D:\oracle\instantclient_19_3。
- 將該路徑加入系統環境變數
PATH 最前端。
- （可選）建立
tnsnames.ora 檔案並設定 TNS_ADMIN 環境變數指向其目錄。
三、配置 PL/SQL Developer 偏好設定
- 開啟工具 → Preferences（或 Tools → Preferences）。
- 左側選單展開 Connection，找到 Oracle Home 與 OCI Library 兩欄。
- Oracle Home：填入 Instant Client 根目錄（如
D:\oracle\instantclient_19_3）。
- OCI Library：填入
oci.dll 完整路徑（如 D:\oracle\instantclient_19_3\oci.dll）。
- 點擊 OK，工具提示「變更將在重啟後生效」，確定並關閉 PL/SQL Developer。
四、重新啟動並測試連線
- 再次啟動 PL/SQL Developer，登入視窗應已出現「連接為」下拉選單。
- 輸入正確的 用戶名、密碼，資料庫欄位可填 TNS 別名（若已配置 tnsnames.ora）或使用 EZConnect 格式：
主機IP:port/服務名（例：192.168.1.100:1521/ORCL）。
- 選擇適當的「連接為」角色（一般用戶選 NORMAL，DBA 選 SYSDBA）。
- 點擊 OK，若資訊無誤即可成功進入物件瀏覽器。
五、常見問題排查
- ORA-12154 / ORA-12541：檢查 TNS 設定、防火牆、Listener 狀態、IP/port 是否正確。
- 「連接為」仍不出現：確認 OCI Library 路徑無誤、DLL 檔案存在、PATH 環境變數生效（需重開命令提示字元或重啟電腦）。
- 多版本 Client 衝突：優先使用 Instant Client，避免完整安裝的 Oracle Home 汙染路徑。
結語
掌握「安裝 Client → 設定偏好 → 重啟工具 → 登入」四步驟，即可順利建立 PL/SQL Developer 與 Oracle 資料庫的連線。後續開發、調試、優化 SQL 皆在此基礎上展開。
