// Oracle 錯誤參考

ORA-12154:TNS:無法解析連線識別碼

Oracle 用戶端無法把你用來連線的名稱解析成資料庫位址:別名不在 tnsnames.ora 裡,或用戶端讀取的是另一個檔案。

錯誤碼
ORA-12154
類別
連線與登入
錯誤訊息
TNS:could not resolve the connect identifier specified

它的意義

當你使用網路服務名稱(net service name)連線時,例如 SALES,Oracle 用戶端會用它的命名方法解析,通常是 tnsnames.ora。ORA-12154 表示找不到這個名稱。整個過程根本不會碰觸資料庫,所以問題不在伺服器。

較新的版本寫法為 Cannot connect to database. Cannot find alias alias_value in repository_loc.,也會說明用戶端找過哪些地方。

常見原因

  • 該別名未定義於 tnsnames.ora 用戶端實際讀取的名稱,不然就是拼錯了。
  • TNS_ADMIN 指向另一個目錄,或是有多個 Oracle Home 各自帶有自己的 tnsnames.ora.
  • 語法錯誤出現在 tnsnames.ora,例如括號沒有成對,會讓項目變得難以閱讀。
  • sqlnet.ora 限制命名方法(NAMES.DIRECTORY_PATH)所以 tnsnames.ora 不會被查閱。
  • 網域會附加到名稱後面,取自 NAMES.DEFAULT_DOMAIN 而項目裡沒有它。

如何修正

  1. 略過別名,改用 Easy Connect 連線,不需要 tnsnames.ora: sqlplus app_user@//db-host:1521/salespdb.

  2. 檢查用戶端使用的是哪個檔案:執行 tnsping SALES,它會印出讀到的參數檔,以及名稱是怎麼解析的。

  3. 在該檔案中新增或修正條目。

    SALES =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = db-host)(PORT = 1521))
        (CONNECT_DATA = (SERVICE_NAME = salespdb)))
  4. 設定 TNS_ADMIN 指到存放正確 tnsnames.ora 和 sqlnet.ora.

相關錯誤

更多連線與登入錯誤

程式碼和訊息文字來自 Oracle 資料庫錯誤說明。瀏覽完整的 Oracle 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 Oracle

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 Oracle 和你使用的其他資料庫。