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:
- 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ón | Contenedora (CDB) | Conectable (PDB) |
|---|---|---|
| Oracle Database 21c XE | XE | XEPDB1 |
| Oracle AI Database 26ai Free | FREE | FREEPDB1 |
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:
| Campo | Valor | Por qué |
|---|---|---|
| Usuario | SYSTEM | Cuenta de administración habitual, con la contraseña de la instalación |
| Tipo de conexión | Básico | Host, puerto y servicio a mano |
| Nombre del host | localhost | La base de datos está en el mismo equipo |
| Puerto | 1521 | Puerto por defecto del listener |
| Nombre del servicio | FREEPDB1 | La 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.