// Oracle 錯誤參考
ORA-12154:TNS:無法解析連線識別碼
Oracle 用戶端無法把你用來連線的名稱解析成資料庫位址:別名不在 tnsnames.ora 裡,或用戶端讀取的是另一個檔案。
- 錯誤碼
ORA-12154- 類別
- 連線與登入
它的意義
當你使用網路服務名稱(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而項目裡沒有它。
如何修正
-
略過別名,改用 Easy Connect 連線,不需要
tnsnames.ora:sqlplus app_user@//db-host:1521/salespdb. -
檢查用戶端使用的是哪個檔案:執行
tnsping SALES,它會印出讀到的參數檔,以及名稱是怎麼解析的。 -
在該檔案中新增或修正條目。
SALES = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = db-host)(PORT = 1521)) (CONNECT_DATA = (SERVICE_NAME = salespdb))) -
設定
TNS_ADMIN指到存放正確tnsnames.ora和sqlnet.ora.
相關錯誤
ORA-12514TNS: 監聽器不知道請求的服務ORA-12541TNS: 沒有監聽器ORA-12505TNS: 監聽器不知道 SIDORA-12170TNS: 發生連線逾時ORA-01017無效的使用者名稱/密碼;登入遭拒
更多連線與登入錯誤
ORA-03113通訊通道出現檔案結尾ORA-03135連線失去聯繫ORA-28000帳戶已鎖定ORA-28001密碼已過期ORA-01034ORACLE 無法使用ORA-27101共用記憶體區不存在ORA-12519TNS: 找不到適當的服務處理常式
程式碼和訊息文字來自 Oracle 資料庫錯誤說明。瀏覽完整的 Oracle 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 Oracle
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 Oracle 和你使用的其他資料庫。