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 por la URL:
http://127.0.0.1:8091/scriptcase/info.php
, donde encontrará información sobre arquitectura en el phpinfo().
ATENCIÓN: Descargue el cliente instantáneo de Oracle de acuerdo con su arquitectura PHP.
- Arquitectura i386/i686 = 32 bits
- Arquitectura x86_64 = 64 bits
A continuación se enumeran los archivos necesarios para que los controladores de Oracle estén habilitados.
Archivos requeridos:
- Extensión oci8.so: Clique Aqui
x86_64
- Oracle Instant Client - Basic Package 12.1.0.2(x86_64): Clique Aqui
- Oracle Instant Client - Devel Package 12.1.0.2(x86_64): Clique Aqui
i386/i686
- Oracle Instant Client - Basic Package 12.1.0.2(i386/i686): Clique Aqui
- Oracle Instant Client - Devel Package 12.1.0.2(i386/i686): Clique Aqui
IMPORTANTE: 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 12.2.0 or Higher: Clique Aqui
Tabla de Compatibilidad
Driver | Versión de la base de datos Oracle | ||||||
---|---|---|---|---|---|---|---|
Oracle ODBC | Instant Client | Versión de la base de datos Oracle | |||||
12.1.0.2 |
Configurar Oracle ODBC en Linux
La instalación automática de Scriptcase viene con controladores de Oracle preconfigurados, y solo falta instant_client para configurar la conexión. Siga los pasos descritos a continuación para habilitar los controladores de conexión.
1 - Instalar en los paquetes a continuación:
UBUNTU\DEBIAN | CENTOS\RHEL |
---|---|
sudo apt-get update |
sudo yum update |
sudo apt-get install libaio1 |
sudo yum install libaio-devel |
sudo apt-get install libncurses5 |
sudo yum install libaio |
sudo apt-get install alien |
sudo yum install glibc |
sudo apt-get install gcc-multilib g++-multilib |
sudo yum install compat-libstdc++-33 |
sudo apt-get install libpam0g |
sudo yum install glibc-devel |
sudo apt-get install unixodbc-dev unixodbc |
sudo yum install libstdc++ |
sudo yum install libstdc++ |
|
sudo yum install pam |
|
sudo yum install ncurses-devel |
|
sudo yum install unixODBC |
2 - Convierta e instale los paquetes descargados Instant Client Basic anteriormente en su sistema Linux:
UBUNTU\DEBIAN | CENTOS\RHEL |
---|---|
sudo alien oracle-instantclient12.1-devel-12.1.0.2.0-1.x86_64.rpm |
sudo yum install oracle-instantclient12.1-basic-12.1.0.2.0-1.x86_64.rpm |
sudo alien oracle-instantclient12.1-basic-12.1.0.2.0-1.x86_64.rpm |
sudo yum install oracle-instantclient12.1-devel-12.1.0.2.0-1.x86_64.rpm |
sudo dpkg -i oracle-instantclient12.1-basic_12.1.0.2.0-2_amd64.deb |
|
sudo dpkg -i oracle-instantclient12.1-devel_12.1.0.2.0-2_amd64.deb |
3 - Copia la extensión oci8.so descargada anteriormente al directorio de extensiones PHP:
EJ:
sudo cp oci8.so /usr/lib/php/20180731
Acceda al archivo info.php y busque la línea extension_dir. Le indicará la ruta exacta al directorio responsable de las extensiones PHP.
4 - Edite el archivo php.ini y declare la extensión de Oracle al final del archivo.
UBUNTU\DEBIAN | CENTOS\RHEL |
---|---|
/etc/php/7.3/apache2/php.ini |
/etc/php.ini |
EJ:
extension=oci8.so
5 - Edite el archivo de variable de entorno y declare la variable responsable de identificar la biblioteca de Oracle:
Ingrese la variable LD_LIBRARY_PATH y la ruta a la biblioteca en el archivo responsable de las variables de entorno de su sistema. Verifique la ruta a continuación según su sistema operativo:
ATENCIÓN: La ruta a la biblioteca puede depender de cómo la instaló, por defecto la ruta es la siguiente:
/usr/lib/oracle/12.1/client64/lib/
.
UBUNTU\DEBIAN | CENTOS\RHEL |
---|---|
sudo nano /etc/apache2/envvars |
sudo nano /etc/sysconfig/httpd |
- Agregue esta variable al final del archivo con la sintaxis:
export LD_LIBRARY_PATH=/usr/lib/oracle/12.1/client64/lib/
EX:
NOTA: Si está usando CentOS/RHEL, no es necesario usar ‘export’ antes de la variable.
6 - Reinicie el servicio Apache Scriptcase para que los cambios surtan efecto. Utilice los siguientes comandos según su sistema operativo.
UBUNTU\DEBIAN | CENTOS\RHEL |
---|---|
sudo service apache2 restart |
sudo systemctl restart httpd |
Crear una conexión en 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
- EX:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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
- 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 .
- Por defecto, el punto
- 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.
- 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? Póngase en contacto con nuestro suporte en caso de problemas de conexión o preguntas sobre esta base de datos.