Instalación/Configuración de Oracle SQLcl y Oracle Instant Client

En este blog describiré como instalar/configurar SQLcl y Oracle Instant Client para luego poderlo usar en una conexión a Oracle Autónomos Database.

Para esto no necesitamos tener instalado alguna base de datos, y el camino a seguir es similar si tuviéramos acceso a través de SQL Developer.

Requisitos

1. Java JDK, necesario para ejecutar SQLcl

2. Oracle Instant Client

3. SQLcl

4. Archivo zip con la wallet de nuestro Autónomos Transaction Procesing.

Preparando el ambiente

• JDK La instalación del java es sencilla como cualquier ejecutable, solo deberemos tener en cuenta que versión es necesaria para correr SQLcl, al momento de escribir el blog SQLcl versión 21.4 requiere java JRE 1.8, esta información lo pueden encontrar en la web de SQLcl.

• Oracle Instant Client Para esto solo requerimos descargar y descomprimir el contenido. Para el ejemplo crearemos un folder en `

 C:\OracleConfig\software

y allí dentro descomprimiremos el zip descargado.

Adicionalmente necesitamos poner el path en nuestras variables de sistema.

Para ello nos dirigimos a variables del sistema, buscamos path y agregamos un nuevo registro, similar a

C:\OracleConfig\software\instantclient_21_6

• SQLcl Similar a Oracle Instant Client, una vez descargado los descomprimimos en nuestra carpeta de preferencia

De igual forma lo agregamos al path, pero en este caso agregamos la ruta hacia el folder bin ejemplo:

C:\OracleConfig\software\sqlcl\bin

> SQLcl Adicionalmente podemos cambiar el nombre del archivo C:\OracleConfig\software\sqlcl\bin\sql.exe a sqlcl.exe, esto no afecta en nada el funcionamiento solo nos ayuda a que sea más legible al momento de ejecutar los comandos.

Para probar SQLcl abriremos una ventana de CMD y escribimos sqlcl o sql si no renombramos él .exe y deberíamos tener esta interfaz.

Errores comunes

Incompatible versión of libocijdbc[Jdbc:215000, Jdbc-OCI:216000]

Si al ejecutar SQLcl tenemos el siguiente error, es porque los drivers de SQLcl y Oracle Instant Client no son los mismos:

Para corregir ello es necesario descargar las versiones compatibles entre SLQcl y Oracle Instant Client, si el problema persiste recomiendo esta solución.

Ir al directorio donde esta descomprimido SQLcl, carpeta lib y copiar el archivo ojdbc8.jar.

Ir al directorio donde esta descomprimido Oracle Instan Client y en la raíz pegar el archivo copiado, sobrescribir el existente y así solucionamos este error.

‘SQLcl’ is not recognized as an internal or external command

Este error indica que no agregamos el path de nuestra carpeta donde tenemos SQLcl en las variables de entorno.

O posiblemente si no renombraste el comando debería ser solo "sql"

Referencia:

Compatibilidad de versiones