免安裝 Oracle Client 連線 Oracle 資料庫：Instant Client + 環境變數 + tnsnames.ora 完整設定指南

為什麼需要 Instant Client？

完整 Oracle Client 安裝檔 > 1 GB、佔用大量磁碟/登錄檔、易衝突。Instant Client 僅 ~70 MB，解壓即用，適合部署到應用伺服器、開發人員機器、容器映像。

下載與版本對應

• 官網：Oracle Instant Client Downloads（需 OTN 帳號）
• 鏡像站（免登入）：中科大鏡像
• 版本選擇：Basic Light（僅英文/UTF8）、Basic（完整字元集）、SDK（含 OCI 開發標頭）、ODBC、JDBC。
  應用需 OCI（如 PL/SQL Developer、Python cx_Oracle、PHP OCI8）請下載 Basic 或 Basic Light + SQL*Plus 套件。

三步驟完成設定（Windows）

1. 解壓至固定目錄

# 例：C:\oracle\instantclient_21_10
# 內含 oci.dll, oraociei21.dll, sqlplus.exe (若含 SQL*Plus 包) 等

2. 設定系統環境變數（需重啟命令提示字元/服務生效）

注意：64 位元 Instant Client 僅支援 64 位元應用；32 位元應用需安裝 32 位元 Instant Client。

3. 建立 tnsnames.ora

在 %TNS_ADMIN% 目錄下建立 tnsnames.ora：

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

# 亦可使用 EZCONNECT 免 tnsnames.ora
# sqlplus user/pwd@//192.168.1.100:1521/ORCL

驗證連線

# 含 SQL*Plus 套件時
sqlplus user/password@ORCL

# 或使用 EZCONNECT
sqlplus user/password@//192.168.1.100:1521/ORCL

PL/SQL Developer 設定

1. Tools → Preferences → Connection
2. Oracle Home：選擇 Instant Client 目錄（C:\oracle\instantclient_21_10）
3. OCI Library：自動偵測 oci.dll
4. 關閉重開 PL/SQL Developer，連線下拉即可看到 TNS 別名。

Linux / Docker 部署

# Dockerfile 片段
FROM oraclelinux:8-slim
RUN dnf -y install oracle-release-el8 && \
    dnf -y install oracle-instantclient-release-el8 && \
    dnf -y install oracle-instantclient-basic-21.10.0.0.0-1.el8.x86_64.rpm \
                   oracle-instantclient-sqlplus-21.10.0.0.0-1.el8.x86_64.rpm && \
    rm -rf /var/cache/dnf
ENV ORACLE_HOME=/usr/lib/oracle/21/client64
ENV TNS_ADMIN=/opt/oracle/network/admin
ENV NLS_LANG=AMERICAN_AMERICA.AL32UTF8
ENV PATH=$ORACLE_HOME/bin:$PATH
# 複製 tnsnames.ora 至 $TNS_ADMIN

常見問題排查