Oracle Instant Client 免安裝客戶端完整設定教學 (Windows)

下載與部署

1. 至 OTN 下載 Instant Client Package - Basic (含 OCI, OCCI, JDBC-OCI) 與 SQL*Plus Package (可選)。版本需與目標資料庫相容 (如 11.2.0.4、12.2.0.1、19.3 等)。
2. 建立資料夾 (例: D:\Oracle_Client\instantclient_19_3) 解壓縮所有 zip 至同一目錄。

建立網路配置檔

在上述目錄新建 sqlnet.ora、tnsnames.ora：

sqlnet.ora

SQLNET.AUTHENTICATION_SERVICES = (NTS)
NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT)

tnsnames.ora

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

設定環境變數

關鍵：缺少 TNS_ADMIN 會報 ORA-12154；舊版 Oracle 殘留 NLS_LANG=NA 於 HKLM\SOFTWARE\Oracle 會導致 ORA-12705，請刪除該鍵值。

PL/SQL Developer 設定

1. Tools → Preferences → Connection
2. Oracle Home: D:\Oracle_Client\instantclient_19_3
3. OCI Library: D:\Oracle_Client\instantclient_19_3\oci.dll

測試連線

sqlplus user/pwd@ORCL
# 或
sqlplus user/pwd@//192.168.1.100:1521/ORCL  (EZCONNECT 不需 tnsnames.ora)

優缺點總結

• ✅ 體積小 (~70 MB)、免安裝、可攜帶、多版本共存
• ✅ 適用 CI/CD Agent、容器映像、開發機快速部署
• ❌ 缺少完整工具 (如 Database Configuration Assistant、Enterprise Manager)
• ❌ 部分舊版應用需完整 Client 才支援的功能 (如 Heterogeneous Services) 可能受限