免安裝 Oracle Client 配置 PL/SQL Developer 完整指南（Instant Client 方案）

免安裝 Oracle Client 配置 PL/SQL Developer 完整指南（Instant Client 方案）

PL/SQL Developer 是功能強大的 Oracle IDE，但預設需要完整 Oracle Client（數百 MB、安裝繁瑣、版本鎖定）。使用 Oracle Instant Client（輕量、免安裝、解壓即用）即可實現「綠色部署」，極適合開發機、CI/CD Agent、容器環境。本文提供標準化配置流程。

一、下載 Instant Client 組件

前往 Oracle 官網 Instant Client Downloads，根據作業系統與位元數下載以下三個套件（以 Windows 64-bit 19.3 為例）：

1. Basic Package：instantclient-basic-windows.x64-19.3.0.0.0dbru.zip（核心 OCI、OCI8、JDBC、ODBC）
2. SQL*Plus Package：instantclient-sqlplus-windows.x64-19.3.0.0.0dbru.zip（可選，提供 sqlplus.exe）
3. Tools Package：instantclient-tools-windows.x64-19.3.0.0.0dbru.zip（可選，含 Data Pump、SQL*Loader）

關鍵：版本號需與目標資料庫相容（通常同主版本或更高均可向下相容）。

二、解壓並部署

1. 建立統一目錄，如 D:\oracle\instantclient_19_3。
2. 將三個 zip 解壓到同一目錄，合併覆蓋。最終目錄結構：

D:\oracle\instantclient_19_3\
  ├── oci.dll
  ├── oraociei19.dll
  ├── sqlplus.exe
  ├── tnsnames.ora  (手動建立)
  └── sqlnet.ora    (手動建立)

三、建立網路配置檔

在 Instant Client 目錄下新建兩個文字檔：

1. tnsnames.ora（服務別名定義）

ORCL =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = ORCL)
    )
  )

PDB1 =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = PDB1)
    )
  )

2. sqlnet.ora（客戶端參數）

SQLNET.AUTHENTICATION_SERVICES = (NTS)
NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT)
# 可選：關閉加密以相容舊版
# SQLNET.ENCRYPTION_CLIENT = OPTIONAL
# SQLNET.CRYPTO_CHECKSUM_CLIENT = OPTIONAL

四、設定環境變數（關鍵步驟）

以系統管理員身份開啟「編輯系統環境變數」：

注意：修改後需重啟 PL/SQL Developer 或重新登入 Windows 生效。

五、配置 PL/SQL Developer 連線參數

1. 啟動 PL/SQL Developer → Tools → Preferences → Connection。
2. 取消勾選 Use OCI.dll from Oracle Home。
3. Oracle Home：D:\oracle\instantclient_19_3
4. OCI Library：D:\oracle\instantclient_19_3\oci.dll
5. 點擊「OK」儲存。

六、驗證連線

1. 登入視窗：Database 下拉選單應自動列出 tnsnames.ora 定義的別名（ORCL、PDB1）。
2. 輸入 User/Password，點擊「OK」登入。
3. 執行 SELECT * FROM v$version 確認版本資訊。

七、進階：EZCONNECT 無需 tnsnames.ora

若不想維護 tnsnames.ora，登入視窗 Database 欄位直接填寫 EZCONNECT 字串：

192.168.1.100:1521/ORCL
# 或 12c+ PDB
192.168.1.100:1521/PDB1

前提：sqlnet.ora 含 NAMES.DIRECTORY_PATH = (EZCONNECT, TNSNAMES)。

八、常見問題排查

九、自動化部署腳本

@echo off
REM deploy_instantclient.cmd
SET IC_DIR=D:\oracle\instantclient_19_3
SETX /M TNS_ADMIN "%IC_DIR%"
SETX /M PATH "%IC_DIR%;%PATH%"
SETX /M NLS_LANG "AMERICAN_AMERICA.AL32UTF8"
ECHO 完成，請重新登入或重啟 IDE。

總結

Instant Client + PL/SQL Developer = 零安裝、可攜帶、版本解耦 的最佳開發組合。只要做對三件事：解壓到統一目錄、建立 tnsnames.ora/sqlnet.ora、設定 TNS_ADMIN 與 PATH，即可在任何 Windows 機器上秒級接入 Oracle。