Conectar SQL Developer a Oracle parece trivial: usuario, contraseña, host, puerto y listo. A mí me salió bien a la primera en casa, con Oracle AI Database 26ai Free. Pero en clase instalamos otra versión, la 21c Express Edition, y ahí la conexión me dio error: esa versión usa otros nombres para la base de datos. Los datos que funcionan en una versión no valen en la otra.

Para entender por qué, primero hay que saber a qué te estás conectando exactamente.

Una instalación, varias bases de datos

Desde hace varias versiones, Oracle usa una arquitectura multitenant (multiinquilino). Cuando instalas Oracle no se crea “una base de datos”, sino un contenedor con varias dentro:

Esquema de Oracle multitenant: el listener en el puerto 1521 recibe conexiones y las dirige a la base de datos contenedora FREE o a la base de datos conectable FREEPDB1

  • Base de datos contenedora (CDB). En Oracle Free se llama FREE. Contiene y gestiona las demás. Dentro está CDB$ROOT, con el diccionario de datos y la configuración común.
  • Base de datos conectable (PDB). En Oracle Free se llama FREEPDB1. Es la base de datos “de trabajo”: donde se crean los usuarios, las tablas y los datos de las aplicaciones.
  • Listener. Es el proceso que escucha en el puerto 1521 y dirige cada conexión a la base de datos que pide el cliente.

La consecuencia práctica es que casi siempre quieres conectarte a la PDB, no a la contenedora. Si creas tus tablas conectado a la contenedora, estás trabajando en el sitio equivocado.

Cada versión, sus propios nombres

Aquí está la trampa. Los nombres cambian según la edición:

VersiónContenedora (CDB)Conectable (PDB)
Oracle Database 21c XEXEXEPDB1
Oracle AI Database 26ai FreeFREEFREEPDB1

Casi todos los tutoriales y vídeos antiguos están hechos con XE, así que muestran XE y XEPDB1. Si tienes instalada la versión Free y copias esos datos, la conexión falla. Y al revés pasa lo mismo: en clase el equipo tenía la 21c, con otros nombres, y ahí fue donde me falló a mí.

Si no sabes qué versión tienes, el propio instalador te lo dice al terminar. En mi caso mostró localhost:1521 para la contenedora y localhost:1521/FREEPDB1 para la conectable. También puedes mirar el nombre del servicio de Windows en services.msc: OracleServiceFREE frente a OracleServiceXE.

SID o nombre del servicio

Al crear una conexión en SQL Developer, en “Tipo de conexión: Básico” hay dos botones: SID y Nombre del servicio. Por defecto viene marcado SID y con el valor xe ya escrito, un resto de cuando XE era la opción gratuita.

  • SID identifica a la instancia, es decir, a los procesos de Oracle en marcha. Con SID te conectas a la contenedora.
  • Nombre del servicio identifica a una base de datos concreta que el listener tiene registrada. Es lo que hay que usar para llegar a una PDB.

Para conectarte a FREEPDB1 (o XEPDB1) tienes que marcar Nombre del servicio. Con SID no llegas a la conectable.

La conexión que me funcionó

En SQL Developer: Nueva conexión, con estos datos:

CampoValorPor qué
UsuarioSYSTEMCuenta de administración habitual, con la contraseña de la instalación
Tipo de conexiónBásicoHost, puerto y servicio a mano
Nombre del hostlocalhostLa base de datos está en el mismo equipo
Puerto1521Puerto por defecto del listener
Nombre del servicioFREEPDB1La base de datos conectable (XEPDB1 si es 21c XE)

Antes de guardar, el botón Probar te dice si los datos son correctos sin tener que conectar. Si el estado pone “Correcto”, guardas y conectas. Se abre una hoja de trabajo SQL asociada a esa conexión.

Un detalle útil: nada más abrir SQL Developer, en la página de bienvenida, el apartado “Bases de datos detectadas” ya mostraba FREE y LISTENER_FREE. La herramienta encuentra sola el fichero de configuración de red de Oracle. Si ahí ves XE, ya sabes qué versión tienes instalada.

Comprueba dónde estás conectado

Que la conexión funcione no significa que estés en la base de datos correcta. Esta consulta te dice con qué usuario y en qué contenedor estás:

SELECT USER, SYS_CONTEXT('USERENV', 'CON_NAME') AS contenedor FROM dual;

A mí me devolvió SYSTEM y FREEPDB1: el usuario correcto en la base de datos de trabajo. Si te sale CDB$ROOT, estás en la contenedora y no deberías crear ahí tus tablas.

Desde la terminal, el equivalente con SQLPlus es SHOW CON_NAME;. Si al conectar por SQLPlus te sale un ORA-12154 con un nombre de servicio que no has escrito, mira este artículo sobre la @ en la contraseña, porque fue mi primer error con esta misma instalación.

Y ahora, a trabajar

Una vez conectado a la PDB, ya puedes crear tablas, relaciones y consultas. Si estás empezando con el modelo relacional, te servirán qué es una clave primaria y qué es una clave foránea. La instalación completa desde cero está en instalar Oracle 26ai Free en Windows paso a paso.

Pon a prueba lo que has entendido

Tienes Oracle AI Database 26ai Free y quieres crear tablas desde SQL Developer. ¿Qué configuración de conexión es la correcta?

Resumen rápido

Oracle instala una base de datos contenedora y, dentro, una conectable donde se trabaja de verdad. En Oracle Free se llaman FREE y FREEPDB1. En 21c XE, XE y XEPDB1. Para conectar SQL Developer a la conectable, marca Nombre del servicio (no SID) con el nombre de tu versión, puerto 1521 y host localhost. Después confirma con SYS_CONTEXT('USERENV', 'CON_NAME') que estás en la PDB y no en la contenedora.