萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> Oracle 教學

Oracle Net Services 三大配置文件深度解析:listener.ora、sqlnet.ora、tnsnames.ora 角色與連接解析鏈路

Oracle 客戶端連接流程由三大配置文件協同完成。理解它們的**職責分工、加載順序、關鍵參數**,是解決 TNS-12154、ORA-12514、ORA-12541 等連接錯誤的核心技能。

三大文件職責速覽

文件角色類比核心職責典型位置
sqlnet.ora 命名服務開關 (/etc/nsswitch.conf) 決定連接標識符解析順序:TNSNAMES、LDAP、HOSTNAME、EZCONNECT $ORACLE_HOME/network/admin
tnsnames.ora 主機映射表 (/etc/hosts) TNS 別名 → 連接描述符(協議、主機、端口、服務名/SID) $ORACLE_HOME/network/admin
listener.ora 服務端監聽配置 定義監聽器名稱、端口、協議、服務實例註冊信息 (SID/GLOBAL_DBNAME) $ORACLE_HOME/network/admin (服務端)

連接解析鏈路實戰演示

客戶端執行:

sqlplus sys/oracle@orcl

情況 A:sqlnet.ora 包含 TNSNAMES

NAMES.DIRECTORY_PATH = (TNSNAMES, HOSTNAME)
  1. 客戶端讀取 sqlnet.ora → 解析順序:TNSNAMES 優先
  2. 查找 tnsnames.ora 中 ORCL 條目
  3. 解析出 (HOST=127.0.0.1)(PORT=1521)(SERVICE_NAME=orcl)
  4. 4. TCP 連接 127.0.0.1:1521,發送 CONNECT_DATA
  5. 監聽器匹配 listener.ora 中 SID_NAME=orcl 或 GLOBAL_DBNAME=orcl
  6. 啟動專用/共享服務器進程,建立會話

情況 B:sqlnet.ora 僅含 HOSTNAME

NAMES.DIRECTORY_PATH = (HOSTNAME)

客戶端將 orcl 視為主機名,嘗試 DNS/hosts 解析 IP,連接該 IP 上 GLOBAL_DBNAME=orcl 的實例。**不讀取 tnsnames.ora**。

listener.ora 關鍵片段解析

LISTENER =
  (DESCRIPTION_LIST =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 127.0.0.1)(PORT = 1521))
    )
  )

SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (GLOBAL_DBNAME = orcl)        # 供 HOSTNAME 方式匹配
      (ORACLE_HOME = /u01/app/oracle/product/19c)
      (SID_NAME = orcl)             # 供 TNSNAMES 方式匹配
    )
  )

常見錯誤對應配置檢查表

錯誤碼核心原因檢查重點
TNS-12154 / ORA-12154無法解析連接標識符sqlnet.ora NAMES.DIRECTORY_PATH、tnsnames.ora 別名拼寫、文件位置
ORA-12514監聽器不識別服務listener.ora SID_LIST、GLOBAL_DBNAME、服務實例註冊狀態 (lsnrctl services)
ORA-12541無監聽器監聽器進程狀態、端口衝突、防火牆、listener.ora ADDRESS
ORA-12545目標主機/對象不存在tnsnames.ora HOST IP 可達性、DNS/hosts 解析

最佳實踐

  • 統一使用 SERVICE_NAME 而非 SID(支援 RAC/Data Guard 切換)
  • 客戶端 sqlnet.ora 固定:NAMES.DIRECTORY_PATH=(TNSNAMES,EZCONNECT)
  • 服務端啟用 SUBSCRIBE_FOR_NODE_DOWN_EVENT 加快故障檢測
  • 集中管理:將 tnsnames.ora 放置共享存儲/版本控制,客戶端通過 TNS_ADMIN 環境變量引用
copyright © 萬盛學電腦網 all rights reserved