// Oracle-Fehlerreferenz

ORA-12154: TNS: konnte den Verbindungsbezeichner nicht auflösen

Der Oracle-Client konnte den Namen, mit dem du dich verbunden hast, nicht in eine Datenbankadresse auflösen: Der Alias steht nicht in tnsnames.ora, oder der Client liest eine andere Datei.

Fehlercode
ORA-12154
Kategorie
Verbindung und Anmeldung
Fehlermeldung
TNS:could not resolve the connect identifier specified

Was es bedeutet

Wenn du dich mit einem Netzdienstnamen wie SALES, sucht der Oracle-Client ihn mit seinen Namensmethoden, normalerweise tnsnames.ora. ORA-12154 bedeutet, dass der Name nicht aufgelöst werden konnte. Die Datenbank wird nie kontaktiert, der Server ist also nicht das Problem.

Neuere Versionen formulieren es als Cannot connect to database. Cannot find alias alias_value in repository_loc., was auch angibt, wo der Client gesucht hat.

Häufige Ursachen

  • Der Alias ist nicht definiert in der tnsnames.ora der Client liest tatsächlich, oder es ist falsch geschrieben.
  • TNS_ADMIN weist auf ein anderes Verzeichnis hin, oder mehrere Oracle Homes haben jeweils ihr eigenes tnsnames.ora.
  • Ein Syntaxfehler in tnsnames.ora, wie unausgeglichene Klammern, die den Eintrag unlesbar machen.
  • sqlnet.ora beschränkt die Naming-Methoden (NAMES.DIRECTORY_PATH) sodass tnsnames.ora wird nicht berücksichtigt.
  • Eine Domäne wird dem Namen aus NAMES.DEFAULT_DOMAIN angehängt und der Eintrag hat sie nicht.

Wie du es behebst

  1. Überspringe den Alias und verbinde dich mit Easy Connect, das kein tnsnames.ora: sqlplus app_user@//db-host:1521/salespdb.

  2. Prüfe, welche Datei der Client verwendet: starte tnsping SALES, die ausgibt, welche Parameterdatei sie gelesen hat und wie der Name aufgelöst wurde.

  3. Füge den Eintrag in dieser Datei hinzu oder korrigiere ihn.

    SALES =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = db-host)(PORT = 1521))
        (CONNECT_DATA = (SERVICE_NAME = salespdb)))
  4. Setzen TNS_ADMIN auf das Verzeichnis, das die richtige tnsnames.ora und sqlnet.ora.

Zugehörige Fehler

Weitere Verbindungs- und Anmeldefehler

Der Code und der Meldungstext stammen aus der Oracle Database Error Help. Durchstöbere die vollständige Oracle-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit Oracle in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für Oracle und die anderen Datenbanken, mit denen du arbeitest.