// Referencia de errores de Oracle

ORA-12154: TNS: no se pudo resolver el identificador de conexión

El cliente de Oracle no pudo convertir en una dirección de base de datos el nombre con el que te conectaste: el alias no está en tnsnames.ora o el cliente está leyendo otro archivo.

Código de error
ORA-12154
Categoría
Conexión e inicio de sesión
Mensaje de error
TNS:could not resolve the connect identifier specified

Qué significa

Cuando te conectas con un nombre de servicio de red como SALES, el cliente de Oracle lo busca con sus métodos de nomenclatura, normalmente tnsnames.ora. ORA-12154 significa que no pudo resolver ese nombre. Nunca se llega a contactar con la base de datos, así que el servidor no es el problema.

Las versiones más recientes lo expresan como Cannot connect to database. Cannot find alias alias_value in repository_loc., lo que también indica dónde buscó el cliente.

Causas comunes

  • El alias no está definido en el tnsnames.ora el cliente realmente lo lee, o está mal escrito.
  • TNS_ADMIN apunta a otro directorio, o hay varios Oracle homes, cada uno con el suyo tnsnames.ora.
  • Un error de sintaxis en tnsnames.ora, como paréntesis sin cerrar, que vuelven ilegible la entrada.
  • sqlnet.ora restringe los métodos de nomenclatura (NAMES.DIRECTORY_PATH) por lo que tnsnames.ora no se consulta.
  • Se añade un dominio al nombre desde NAMES.DEFAULT_DOMAIN y la entrada no lo tiene.

Cómo solucionarlo

  1. Omitir el alias y conectarse con Easy Connect, que no necesita tnsnames.ora: sqlplus app_user@//db-host:1521/salespdb.

  2. Comprueba qué archivo usa el cliente: ejecuta tnsping SALES, que imprime el archivo de parámetros que leyó y cómo resolvió el nombre.

  3. Añade o corrige la entrada en ese archivo.

    SALES =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = db-host)(PORT = 1521))
        (CONNECT_DATA = (SERVICE_NAME = salespdb)))
  4. Establecer TNS_ADMIN en el directorio que contiene el adecuado tnsnames.ora y sqlnet.ora.

Errores relacionados

Más errores de conexión e inicio de sesión

El código y el texto del mensaje son de Ayuda para errores de Oracle Database. Explora la lista completa de Lista de errores de Oracle o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con Oracle en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para Oracle y las demás bases de datos que uses.