Feedback

# Conexión a DB2 NATIVO ODBC

En Scriptcase, tenemos los siguientes controladores disponibles para la conexión a DB2: DB2 y DB2 ODBC Native. Si está utilizando su propio entorno preconfigurado , Las extensiones de DB2 deben habilitarse manualmente en PHP.

## Instalación automática

Si instaló la herramienta usando el instalador automático, debe descargar el instalador de acuerdo con su arquitectura e instalarlo. La instalación instalará el cliente y habilitará las extensiones necesarias.

Vaya a http://127.0.0.1:8092/scriptcase/info.php para comprobar la arquitectura.

### x64

- scriptcase_database_drivers_v9.9-x64-php8.1: Descargar

### x86

- scriptcase_database_drivers_v9.9-x86-php8.1: Descargar

## Instalación manual

### Prerrequisitos

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 URL: `http://127.0.0.1:8092/scriptcase/info.php`, donde encontrará información sobre arquitectura en el phpinfo().

- Arquitectura x86 = 32 bits
- Arquitectura x64 = 64 bits

A continuación se enumeran los archivos necesarios para que los controladores de DB2 estén habilitados.

### Archivos requeridos:

#### x64

- IBM Data Server Runtime Client 11.5(x64): clic aquí

#### x86

- IBM Data Server Runtime Client 11.5(x86): clic aquí

#### Otros archivos

- Extensiones PHP (PDO_IBM e IBM_DB2): clic aquí

## Configuración de DB2 NATIVO ODBC en Windows

Antes de instalar IBM Data Server Runtime Client, debe habilitar las extensiones en PHP para que Scriptcase reconozca los controladores de conexión de DB2. Siguelos pasos a continuación para habilitar correctamente todos los controladores en Scriptcase.

> IMPORTANTE: Si está utilizando el instalador automático de Scriptcase, las extensiones ya están habilitadas en PHP y solo requieren la instalación del cliente. Continúe con el elemento 3.

1 - Extraiga el archivo .zip y copie los archivos de extensión php_pdo_ibm y php_ibm_db2 .dll descargados anteriormente a su carpeta PHP `ext`.

2 - En el archivo `php.ini`, ubicado en ` C:\php`, agregue las líneas que hacen referencia a las extensiones de DB2 php_pdo_ibm y php_ibm_db2. Vea el siguiente ejemplo:

`extension=ibm_db2`
`extension=pdo_ibm`

3 - Después de la descarga, siga el asistente de instalación haciendo clic en Siguiente, manteniendo los valores predeterminados del instalador.

4 - Acepte los términos y continúe con la instalación.

5 - Haga clic en Siguiente para mantener los valores predeterminados del instalador recomendado.

6 - Haga clic en Instalar, para comenzar el proceso de instalación.

7 - Haga clic en finalizar para completar la instalación.

8 - Reinicie el servicio Apache usando el Administrador de tareas.

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

- Busque el servicio `Apache` y logo reinicia

## 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ú Database > Nueva conexión.

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

3 - Seleccione la conexión DB2.

### Conexión

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

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

- Driver do SGDB: Seleccione el controlador para conectarse. En este ejemplo, usamos Driver ODBC Nativo.

- SGBD host o IP: Ingrese la IP o el dominio del servidor donde está instalada la base de datos.

- EJ: `dominiodoserver.com` o `192.168.254.170`

- Puerto: Ingrese el puerto para conectarse a DB2. Por defecto, el puerto definido es 50000.

- Nombre de la Base de datos: Ingrese el nombre de la base de datos a la que se conectará.

- EJ: `SAMPLE`

- 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.

- 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.

#### Seguridad

En esta pestaña, puedes configurar el cifrado SSL para tu conexión de base de datos. Consulta a continuación cómo hacerlo.

#### security

Define el nivel de seguridad de la conexión a la base de datos, configurando cómo la conexión maneja la autenticación y la protección de los datos en tránsito. Esto puede incluir configuraciones para cifrar la comunicación entre el cliente y el servidor.

#### sslservercertificate

Especifica la ruta del certificado SSL del servidor, que se utiliza para autenticar el servidor ante el cliente y asegurar que la conexión se establezca con el servidor correcto. Este certificado ayuda a validar la identidad del servidor para proteger la comunicación.

#### sslclientkeystoredb

Define el archivo de almacén de claves (keystore) del cliente, donde se almacenan las claves públicas y privadas y los certificados necesarios para la autenticación SSL entre el cliente y el servidor.

#### sslclientkeystash

Especifica el archivo que almacena las contraseñas de acceso al almacén de claves del cliente de forma cifrada, lo que permite al cliente acceder a sus claves y certificados sin necesidad de proporcionar la contraseña directamente.

#### authentication

Controla el método de autenticación que se debe utilizar en la conexión, especificando cómo el cliente debe autenticarse al acceder a la base de datos (por ejemplo, mediante usuario y contraseña, certificados u otros métodos de autenticación compatibles).

#### sslclientlabel

Define la etiqueta específica para el certificado del cliente en el almacén de claves, que se utilizará para identificar el certificado correcto al autenticar al cliente ante el servidor.

### 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 la conexión para ver tablas, vistas, tablas del sistema y procedimientos según los elementos seleccionados por el usuario. Por defecto, los elementos Table y Views ya están seleccionados por Scriptcase.

- 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.

#### Filtros

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 `PREFIX %%` 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 ingresadas para mostrar.
  - El usuario debe estar en mayúsculas como en el ejemplo anterior.
- Mostrar: Elija si cambia 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 la conexión de su base de datos.

### 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.
  - De manera predeterminada, Scriptcase deja esta opción en blanco.
- Separador decimal: Seleccione el tipo de separador para registros decimales, entre coma y punto.
  - Por defecto, el punto `.` se selecciona como separador.
- Conexión persistente: Defina si las conexiones finalizarán después de la ejecución de sus scripts en las aplicaciones Scriptcase.
  - Por defecto, Scriptcase deshabilita esta opción.
- Use el esquema antes del nombre de la tabla: Defina si el esquema de la base de datos se muestra antes de los nombres de la tabla.
  - Por defecto, Scriptcase habilita esta opción.

### SSH

Aquí están las opciones de SSH disponibles en la imagen y sus descripciones relacionadas con la conexión a la base de datos:

#### Utilice SSH

Habilita o deshabilita el túnel SSH para la conexión con la base de datos. Cuando está activado, la conexión a la base de datos se enruta a través del servidor SSH.

#### Servidor SSH

La dirección IP o el nombre del host del servidor SSH que se utilizará para el túnel. Esta es la máquina que actuará como un puente para acceder a la base de datos de forma segura.

#### Puerto SSH

El puerto utilizado para conectarse al servidor SSH. El puerto predeterminado de SSH es 22, a menos que se haya configurado de otra manera en el servidor.

#### Usuario SSH

El nombre de usuario utilizado para la autenticación en el servidor SSH. Este usuario debe tener permisos para establecer una conexión SSH.

#### Método de autenticación

Puede elegir dos opciones: contraseña o Arquivo de certificado privado. Al elegir una, aparecerá un nuevo campo a continuación para la configuración.

#### Archivo de certificado privado

El archivo de clave privada utilizado para la autenticación, en caso de que el servidor SSH requiera autenticación basada en clave en lugar de contraseña.

#### Puerto local para reenvío

El puerto local en la máquina cliente que se utilizará para reenviar el tráfico de la base de datos a través del túnel SSH. Este puerto actúa como un puente entre el cliente de la base de datos y la base de datos remota.

#### Servidor de base de datos desde SSH

El nombre del host o la dirección IP del servidor de base de datos visto desde el servidor SSH. Esto es necesario cuando la base de datos solo es accesible dentro de la red del servidor SSH.

#### Puerto de base de datos desdede SSH

El puerto del servidor de base de datos que será accesible a través del túnel SSH. Este puerto debe coincidir con el puerto de escucha del servicio de base de datos.

> Preguntas o problemas de conexión?

> Póngase en contacto con nuestro soporte {:target=’_blank’} en caso de problemas de conexión o preguntas sobre esta base de datos.