Solucionar el error de conexión de Oracle: ORA-12154

Á

Álvaro Moura

Última actualización el Jul 6, 2026

Solución al error de conexión Oracle: ORA-12154: TNS:could not resolve the connect identifier specified

Para solucionar este error al conectar con una base de datos Oracle, siga los pasos a continuación:

1. Crear el archivo tnsnames.ora

Crear un archivo llamado tnsnames.ora con el siguiente contenido:

REALDB =

(DESCRIPTION =

(ADDRESS = (PROTOCOL = TCP)(HOST = YOUR_IP_OR_HOST)(PORT = YOUR_PORT))

(CONNECT_DATA =

(SERVER = DEDICATED)

(SERVICE_NAME = YOUR_SERVICE_NAME)

)

)

Advertencia

Reemplace YOUR_IP_OR_HOST, YOUR_PORT y YOUR_SERVICE_NAME con los datos reales de conexión.

2. Guardar en el directorio correcto

Guarde el archivo en la siguiente ruta:

C:\instantclient_19_6\network\admin

Advertencia Si las carpetas network y admin no existen, créelas manualmente.

3. Definir variables de entorno en Windows

Vaya a:
Panel de control → Sistema → Configuración avanzada del sistema → Variables de entorno

Agregue o edite las siguientes Variables del sistema:

  • TNS_ADMIN
    Nombre: TNS_ADMIN
    Valor: C:\instantclient_19_6\network\admin
  • ORACLE_HOME
    Nombre: ORACLE_HOME
    Valor: C:\instantclient_19_6

4. Editar la configuración de Apache

Abra el archivo:

C:\Program Files\NetMake\v9-php81\components\apache\conf\httpd.conf

Agregue las siguientes líneas:

FcgidInitialEnv TNS_ADMIN "C:/instantclient_19_6/network/admin"
FcgidInitialEnv ORACLE_HOME "C:/instantclient_19_6"

Estas líneas deben ser insertadas entre las directivas FcgidMaxRequestLen y Timeout.

5. Aplicar la configuración del entorno

  • Guarde el archivo httpd.conf después de añadir las variables FcgidInitialEnv.
  • Reinicie su computadora para que las variables de entorno (TNS_ADMIN y ORACLE_HOME) se apliquen correctamente.

6. Crear la conexión en Scriptcase

  • Abra Scriptcase y acceda a la pantalla de creación de conexión con la base de datos.
  • Seleccione el driver Oracle deseado.
  • En el campo "Base de datos", introduzca el nombre definido en el archivo tnsnames.ora (por ejemplo, REALDB).

Si todo está configurado correctamente, la conexión con la base de datos Oracle se establecerá con éxito.