Conexión con Oracle ODBC

En Scriptcase, tenemos los siguientes controladores disponibles para la conexión a Oracle: Oracle PDO, Oracle 8.0.5 o Superior, Oracle ODBC e Oracle 8.

Pre-requisitos

Antes de continuar con esta documentación, verifique su arquitectura PHP. Para que los controladores estén habilitados correctamente, los archivos deben descargarse de acuerdo con la arquitectura utilizada.

• En su Scriptcase, está el archivo info.php, acceda a él por la URL: http://127.0.0.1:8091/scriptcase/info.php, donde encontrará la información sobre la arquitectura en phpinfo().

ATENCIÓN: Descargue el cliente instantáneo de Oracle de acuerdo con su arquitectura PHP.

• Arquitectura x86 = 32 bits
• Arquitectura x64 = 64 bits

En instalaciones manuales, debe descargar e instalar ambas versiones de Microsoft Visual C ++ 2017.

Archivos necesarios:

x64

• Oracle Instant Client 19.6.0.0(x64): Clique Aqui
• Oracle ODBC Package 19.6.0.0(x64): Clique Aqui
• Microsoft Visual C++ 2017(x64): Clique Aqui

x86

• Oracle Instant Client 19.6.0.0(x86): Clique Aqui
• Oracle ODBC Package 19.6.0.0(x86): Clique Aqui
• Microsoft Visual C++ 2017(x86): Clique Aqui

IMPORTANTE: El PHP 7.3 es compatible con Oracle Instant Client 11.2 o superior.
Para descargar Oracle Instant Client anterior a la versión 19, debe tener un Conta Oracle.

Otros Archivos

• Oracle Instant Client 18.5.0. o Inferior: Clique Aqui

Tabla de Compatibilidades

Configurar Oracle ODBC en Windows

Es necesario habilitar la extensión en PHP y configurar instant_client para realizar la conexión. Siga los pasos descritos a continuación para habilitar los controladores de conexión.

1 - En el archivo php.ini, ubicado en C:\php, descomente las líneas que se refieren a las extensiones de Oracle oci8_12c y pdo_oci eliminando el ; desde el principio de la línea. Vea el siguiente ejemplo:

2 - Extrae el paquete Instant Client Basic descargado anteriormente a la raíz de tu computadora.

EX:

C:\instantclient_19_6

3 - Pegar en la carpeta PHP de Scriptcase C:\php las DLL que se enumeran a continuación:

• oci.dll
• oraociei19.dll
• oraons.dll

4 - Agregue el parámetro Path a las Variables de Entorno la ruta completa al cliente instantáneo. Siga los pasos a continuación para realizar este procedimiento:

• Acceda al Panel de Control > Sistema > Configuraciones avanzadas del sistema.

• Haga clic en la pestaña Avanzada > Variables de Entorno.

• En Varibles del Sistema, Seleccione el item Path y clic en Editar.

• Haga clic en el botón Nuevo y agregue la ruta al cliente instantáneo como se muestra a continuación:

5 - Reinicie el servicio Apache usando la opción de Administrador de tareas.

• Abra el Administrador de tareas y haga clic en la pestaña Servicios.

• Busque el servicio Apache2.4 y haga clic derecho en este servicio, luego Reiniciar.

Crear una fuente de datos ODBC del sistema

Consulte a continuación todo el paso a paso para crear una fuente de datos ODBC para conectarse a Scriptcase.

NOTA: ODBC debe crearse en el mismo servidor donde está instalado ScriptCase.

1 - Acceda a su ODBC Data Source Manager y seleccione de acuerdo con su arquitectura. Seleccionaremos la versión x64:

2 - Al ingresar al Administrador de fuentes de datos ODBC, seleccione la pestaña DSN System y haga clic en _Add para crear su conexión a su base de datos Oracle.

3 - Después de eso, es necesario seleccionar el controlador para conectarse a Oracle. Seleccionar controlador: Oracle en instantclient_19_6

4 - Ahora, ingrese los parámetros de conexión como en el ejemplo a continuación:

• Data Source Name: Defina aquí el nombre del objeto ODBC que se usará al conectarse a Scriptcase.
• Description: Escriba una definición para la fuente de datos, cuál es el propósito, por ejemplo.
• TNS Service Name: Ingrese la IP o el dominio del servidor aquí seguido del NOMBRE DEL SERVICIO Oracle.
• User ID: Informe al usuario que se utilizará en la conexión para la autenticación.

5 - Pruebe la conexión para verificar que todos los parámetros se hayan completado correctamente..

Se le pedirá que ingrese la contraseña para la conexión.

6 - Haga clic en OK para completar este proceso.

Creating a Connection in Scriptcase

Vea a continuación cómo crear una conexión en su proyecto Scriptcase, utilizando el controlador habilitado anteriormente y la base de datos Oracle.

1 - Acceda a un proyecto desde su Scriptcase.

2 - Haga clic en el icono Nueva conexión para crear una conexión.

o acceda al menú Base de datos > Nueva conexión.

Después de eso, aparecerá una pantalla con todas las conexiones de la base de datos.

3 - Seleccione la conexión Oracle.

Conexión

Ingrese los parámetros para conectarse a su base de datos Oracle de la siguiente manera:

• Nombre de la conexión: defina el nombre de su nueva conexión. De manera predeterminada, Scriptcase agrega el prefijo conn junto con el nombre de la base de datos.

• Driver de SGDB: Seleccione el controlador Oracle para conectarse. En este ejemplo, usamos el controlador Oracle ODBC.

• Nombre de la Base de datos: Ingrese el nombre de la fuente de datos creado en su administrador ODBC.
  • EX: oracle
    
    
• Esquema: Informar al Esquema de tablas específicas creadas para el uso del usuario informado.
  • Este elemento es opcional si no tiene un esquema configurado en su base de datos.
    
    
• Usuario: Informe al usuario para autenticar la conexión a su base de datos Oracle.
  • Para las conexiones Oracle, el usuario debe estar en mayúscula, como en el ejemplo.
    
    

• Contraseña: Ingrese la contraseña para completar el proceso de autenticación.

• Probar conexión: Haga clic en este botón para obtener una respuesta a la solicitud de Scriptcase para averiguar si los parámetros ingresados son correctos.

Filtro

Al acceder a esta pestaña, puede configurar qué elementos de la base de datos se mostrarán en la conexión, dependiendo del propietario o no.

Mostrar

Permite que la conexión de Oracle vea tablas, vistas, tablas del sistema y procedimientos según los elementos seleccionados por el usuario.

• Tablas: Al seleccionar esta opción, se mostrarán las tablas en su base de datos.
  • Por defecto, Scriptcase habilita esta opción.
    
    
• Views: Al seleccionar esta opción, se mostrarán las vistas de su base de datos.
  • Por defecto, Scriptcase habilita esta opción.
    
    

• Tablas del sistema: Al seleccionar esta opción, se mostrarán las tablas del sistema de su base de datos.

• Procedures: Al seleccionar esta opción, se mostrarán los procedimientos de su base de datos.

Búsquedas

Le permite definir qué tablas y propietarios se muestran.

• Tablas: Puede definir en esta opción qué tablas se mostrarán. La configuración puede contener un PREFIXO% o el nombre de las tablas para mostrar.
  • Por defecto, Scriptcase deja esta opción vacía.
  • EX:
    
    

  

• Propietario: Informar al usuario que ve las tablas informadas para su visualización.
  • El usuario debe estar en mayúscula como en el ejemplo anterior.
    
    
• Mostrar: Elija si se mostrarán las tablas para el propietario informado.

NOTA: Al usar el filtrado de tablas, elimina las tablas innecesarias para su proyecto y mejora el rendimiento de su conexión de base de datos Oracle.

Avanzado

En esta pestaña, tiene acceso a configuraciones específicas para la conexión. La configuración realizada en esta sesión afecta la visualización de datos y el rendimiento de la aplicación.

• client_encoding: Seleccione la codificación utilizada en su base de datos. En el ejemplo anterior, utilizamos la codificación de cliente UTF-8.
  • Por defecto, esta opción se deja en blanco por Scriptcase
    
    
• Separador decimal: Seleccione el tipo de separador de los registros decimales, entre coma y punto.
  • Por defecto, el punto . se selecciona como separador .
    
    
• Conexión persistente: Defina si las conexiones terminarán después de la ejecución de sus scripts en las aplicaciones de Scriptcase.
  • Por defecto, Scriptcase deshabilita esta opción.
    
    
• Usar esquema antes del nombre de la tabla: Defina si el esquema de la base de datos se mostrará antes de los nombres de la tabla.

  • Por defecto, Scriptcase habilita esta opción.

  • E.g.

  

¿Preguntas o problemas de conexión?

Contacta con nuestro suporte en caso de problemas de conexión o preguntas sobre esta base de datos.