您现在的位置：程式碼之家 >> 數據庫知識 > >> Oracle 資料庫 >> Oracle 資料庫基礎

Oracle TNSNAMES.ORA 手動配置與 Net8 精靈設定完整教學

編輯：Oracle 資料庫基礎

檔案位置與基本結構

預設路徑：$ORACLE_HOME/network/admin/tnsnames.ora (Windows 如 E:\Oracle\Ora81\network\ADMIN)

標準服務項目範例

TEST.SOFTONE.COM =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = zcb_8115)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = test)
    )
  )

方法一：使用 Net8 Configuration Assistant 圖形化配置 (推薦新手)

開始 → 程式集 → Oracle - OraHome81 → Network Administration → Net8 Configuration Assistant
選擇 「Local Net Service Name Configuration」 → 下一步
選擇 「Add」 → 下一步
資料庫版本選 「Oracle 8i database or service」 → 下一步
輸入 服務名 (Service Name)，即安裝時的 SID → 下一步
協議選 TCP → 下一步
輸入 主機名 (Hostname) (本機或遠端電腦名)，埠號保持 1521 → 下一步
選擇 「Yes, perform a test」 → 下一步 (測試連線)
測試成功後輸入 網路服務名 (Net Service Name)，即連線字串別名 (如 test) → 下一步
不需新增其他服務名 → 完成

方法二：手動編輯 tnsnames.ora (適用自動化部署)

以記事本開啟 tnsnames.ora
依上述結構新增條目，注意縮排與括號配對
關鍵參數對照：
- HOST：資料庫伺服器 IP 或主機名
- PORT：Listener 埠 (預設 1521)
- SERVICE_NAME：資料庫服務名 (9i+) 或 SID (8i)
- PROTOCOL：通常為 TCP
儲存檔案，無需重啟服務即時生效

連線測試

# 命令列測試
tnsping TEST.SOFTONE.COM

# SQL*Plus 連線
sqlplus user/password@TEST.SOFTONE.COM

成功顯示 OK (XX msec) 表示 TNS 解析與網路通訊正常。

常見問題排查

現象	可能原因	解決方向
TNS-03505: Failed to resolve name	tnsnames.ora 拼錯、路徑錯誤、TNS_ADMIN 未設定	檢查檔案位置、設定 TNS_ADMIN 環境變數
ORA-12154: TNS could not resolve	服務名拼寫錯誤、檔案未讀取	確認 Net Service Name 拼寫、重啟應用程式
ORA-12541: No listener	遠端 Listener 未啟動、防火牆阻擋	遠端啟動 lsnrctl start、開放 1521 埠
ORA-12514: Service not known	SERVICE_NAME/SID 與 Listener 註冊不符	檢查 listener.ora SID_LIST、資料庫 service_names 參數

進階：多重描述與負載平衡

MY_RAC_DB =
  (DESCRIPTION =
    (LOAD_BALANCE = ON)
    (FAILOVER = ON)
    (ADDRESS = (PROTOCOL = TCP)(HOST = rac1-vip)(PORT = 1521))
    (ADDRESS = (PROTOCOL = TCP)(HOST = rac2-vip)(PORT = 1521))
    (CONNECT_DATA =
      (SERVICE_NAME = myrac.example.com)
    )
  )

結語：TNSNAMES.ORA 是 Oracle 客戶端連線的核心配置檔。掌握手動編輯與圖形化精靈雙重技能，並熟悉 tnsping 測試工具，能快速解決 80% 的連線問題。