Acababa de instalar Oracle en mi portátil para la práctica de Administración de Sistemas Gestores de Bases de Datos. El instalador había terminado bien, los servicios de Oracle estaban arrancados en services.msc y el asistente me había dado los datos de conexión. Solo faltaba entrar con SQL*Plus para comprobarlo. Y lo primero que me devolvió fue esto:
C:\Users\usuario> sqlplus sys@localhost:1521/FREEPDB1 as sysdba
Introduzca la contraseña:
ERROR:
ORA-12154: No se puede conectar a la base de datos. No se ha encontrado el
alias abc en C:\app\...\network\admin\tnsnames.ora.
La base de datos estaba bien. El problema era la contraseña.
Qué dice realmente el error
ORA-12154 significa que Oracle no encuentra el nombre de servicio al que le estás pidiendo conectarte. Normalmente aparece cuando escribes mal el nombre de la base de datos o cuando falta una entrada en el fichero tnsnames.ora, que es donde Oracle guarda los alias de conexión.
Lo raro de mi caso era el alias que decía no encontrar. Yo nunca había escrito ese nombre en el comando. Ese texto era el final de mi contraseña: justo lo que iba después de una @.
Por qué la @ rompe la conexión
SQL*Plus entiende las credenciales con este formato:
usuario/contraseña@servicio
La @ es el separador entre “quién soy” y “a dónde me conecto”. Cuando la contraseña contiene una @, SQL*Plus no tiene forma de saber que forma parte de la contraseña. Corta por ahí y trata todo lo que hay detrás como el nombre de un servicio de red. Con una contraseña tipo Clave2026@abc:
| Lo que yo quería decir | Lo que entendió SQL*Plus |
|---|---|
Contraseña: Clave2026@abc | Contraseña: Clave2026 |
Servicio: el del comando (FREEPDB1) | Servicio: abc |
Como no existe ningún alias abc en tnsnames.ora, salta ORA-12154. Lo que más despista es que pasa aunque escribas la contraseña en el aviso de “Introduzca la contraseña” y no en el propio comando. SQL*Plus la sigue procesando igual.
Lo que pasó en los siguientes intentos
Como no entendía el error, volví a intentarlo varias veces. Así salieron otros dos mensajes que conviene saber leer:
- ORA-01017: credenciales no válidas. En los reintentos, SQL*Plus me volvió a pedir el usuario y la contraseña, y al introducirlos mal apareció este error. Significa “he encontrado la base de datos, pero el usuario o la contraseña no cuadran”. Es un problema distinto al de ORA-12154.
- SP2-0157: no se puede conectar a Oracle después de 3 intentos. Tras tres intentos fallidos, SQLPlus se cierra y te devuelve a la terminal. El código empieza por
SP2-y no porORA-porque es un error del propio cliente SQLPlus, no de la base de datos.
Saber distinguirlos ahorra mucho tiempo. ORA-12154 te dice que no encuentra a dónde conectarte. ORA-01017 te dice que ha llegado pero no le vale tu login. Si ves el primero con un nombre de servicio que no has escrito, mira tu contraseña.
Cómo lo resolví
Siendo sincero, no lo deduje yo solo. Le pregunté a una IA y me señaló lo de la @. Pensándolo después, me habría venido bien buscar el error en Internet y pelearme un poco más con él, porque leer foros y documentación es una habilidad que se pierde si siempre te dan la respuesta hecha. Por eso aquí he querido explicar el porqué y no solo el arreglo.
La solución fue volver a lanzar el mismo comando y, cuando SQL*Plus pidió la contraseña, escribirla entre comillas dobles: "Clave2026@abc". Mientras la escribes no se ve nada en pantalla, así que no te asustes si el cursor no se mueve:
C:\Users\usuario> sqlplus sys@localhost:1521/FREEPDB1 as sysdba
Introduzca la contraseña:
Conectado a:
Oracle AI Database 26ai Free Release 23.26.3.0.0 - Develop, Learn, and Run for Free
Las comillas le dicen a SQL*Plus que todo lo de dentro es un único valor, aunque lleve caracteres especiales.
Otra forma más ordenada es arrancar SQL*Plus sin conectar y hacerlo después con CONNECT, poniendo la contraseña también entre comillas:
C:\> sqlplus /nolog
SQL> CONNECT sys/"Clave2026@abc"@localhost:1521/FREEPDB1 AS SYSDBA
Fíjate en que aquí hay dos @. La que va entre comillas es parte de la contraseña. La de fuera es el separador del servicio.
Cómo comprobar que ya estás dentro
Una vez conectado, lancé tres consultas para asegurarme de que todo estaba bien:
SELECT banner_full FROM v$version; -- versión de Oracle instalada
SHOW CON_NAME; -- a qué base de datos estoy conectado
SELECT name, open_mode FROM v$pdbs; -- estado de la base de datos conectable
La segunda me devolvió FREEPDB1 y la tercera READ WRITE. Es decir, estaba conectado a la base de datos conectable y estaba abierta en lectura y escritura. Si quieres saber qué es eso de “base de datos conectable” y por qué se llama distinto según la versión de Oracle, lo explico en cómo conectar SQL Developer a FREEPDB1.
La lección para la próxima vez
Al instalar Oracle, el asistente pide una sola contraseña para las tres cuentas administrativas (SYS, SYSTEM y PDBADMIN). Tiene que ser robusta, pero eso no significa meter cualquier símbolo. En las cadenas de conexión de Oracle hay caracteres con significado especial que conviene evitar:
@: separa la contraseña del servicio./: separa el usuario de la contraseña.": se usa precisamente para encerrar valores con caracteres especiales.
Puedes conseguir una contraseña igual de robusta con mayúsculas, minúsculas, números y símbolos como _, # o $, sin pelearte con el parser de SQL*Plus. Si ya la creaste con una @, no hace falta reinstalar: con las comillas dobles funciona.
El paso a paso completo de la instalación donde me encontré esto está en cómo instalar Oracle AI Database 26ai Free en Windows.
Pon a prueba lo que has entendido
Te conectas con SQL*Plus y sale ORA-12154 diciendo que no encuentra el alias "x9", un nombre que nunca has escrito en el comando. ¿Qué es lo más probable?
Resumen rápido
ORA-12154 indica que Oracle no encuentra el servicio al que intentas conectarte. Si el alias que aparece en el mensaje es un texto que no has escrito, casi seguro que tu contraseña lleva una @ y SQL*Plus la está partiendo en dos. Escríbela entre comillas dobles y la próxima vez evita @, / y " en las contraseñas de Oracle. Y no confundas ORA-12154 (no encuentra el destino) con ORA-01017 (encuentra el destino, pero rechaza el login).