En los posts anteriores preparamos todas las herramientas del entorno: VS Code, Git, Node.js, Java y SQLcl. Ahora viene el momento esperado conectarnos a nuestra base de datos Oracle en la nube directamente desde la terminal.
Para lograrlo necesitamos tres cosas: una base de datos ATP en OCI, el Wallet de esa base de datos, y el comando correcto de SQLcl.
Una aclaración importante antes de empezar: el tipo de base de datos
- No cualquier Autonomous Database sirve para esto. El workload type debe ser Transaction Processing (ATP), no APEX.
- El tipo APEX tiene limitaciones que impiden descargar el Wallet y conectarse externamente desde SQLcl. Si tenemos una base de datos de tipo APEX, vamos a tener que crear una nueva de tipo ATP. Es gratuita con el Free Tier de Oracle Cloud.
Crear la base de datos ATP en OCI
Ingresamos a nuestra cuenta OCI y navegamos a Oracle AI Database → Autonomous AI Database.
Hacemos clic en Create Autonomous AI Database.
Completamos los datos:
- Display Name: demovuelos
- Database name: demovuelos
- Workload type: Transaction Processing
- Compartment: <tu_compartimiento> Yo lo colocaré en la raiz
Elegimos la opción Always Free.
Ingresamos la password del usuario ADMIN y la anotamos para tenerla a mano ya que la usaremos más adelante.
Hacemos clic en Create y esperamos a que el estado cambie a Available.
Descargar el Wallet
El Wallet es el paquete de credenciales que necesita SQLcl para conectarse de forma segura a una base de datos Autonomous en la nube. Sin él no hay conexión posible.
Desde la pantalla de nuestra base de datos ATP hacemos clic en Database Connection.
Hacemos clic en Download wallet. Seleccionamos Instance Wallet como tipo.
Asignamos una contraseña al Wallet y descargamos el ZIP.
Guardamos ese archivo en:
C:\tools\wallet\
El archivo quedará con un nombre similar a Wallet_demovuelos.zip. No es necesario descomprimirlo, SQLcl lo usa directamente en formato ZIP.
Primera conexión desde SQLcl
Abrimos una terminal en VS Code (usando Command Prompt, no PowerShell) y ejecutamos:
C:\tools\sqlcl\bin\sql.exe -cloudconfig C:\tools\wallet\Wallet_demovuelos.zip admin@demovuelos_high
SQLcl nos pedirá la contraseña del usuario ADMIN que configuramos al crear la base de datos.
Si la conexión es exitosa veremos el prompt SQL>:
Para salir del prompt ingresamos:
exit
Lo que viene: activar Claude Code y configurar el MCP Server
Con SQLcl conectado a Oracle ADB, el entorno está casi completo. En el próximo post vamos a autenticar Claude Code con nuestra cuenta de claude.ai y configurar el SQLcl MCP Server para que Claude pueda conectarse directamente a la base de datos y responder preguntas en lenguaje natural sobre nuestro esquema.
Te espero en el próximo post.
Ir al post 6 de la serie: Instalando el CLI de Claude Code y autenticando con tu cuenta de claude.ai
Crédito: Imagen de portada creada con ChatGPT
