Conexión a Base de Datos¶

Introducción¶

Una conexión de base de datos se configura mediante el conector de base de datos, lo que permite establecer el acceso a una base de datos. Una vez establecida la conexión, puede configurar una o más actividades de base de datos asociadas con esa conexión para que se utilicen como origen para proporcionar datos a una operación o secuencia de comandos, o como destino para consumir datos en una operación o secuencia de secuencia de comandos.

Los agentes de la nube admiten un conjunto proporcionado de controladores JDBC. Los agentes privados admiten controladores ODBC y JDBC. Además de los controladores proporcionados, puede instalar controladores ODBC y JDBC adicionales sobre agentes privados.

Para convertir una conexión de base de datos existente de usar un controlador ODBC a usar un controlador JDBC, consulte Conversión de ODBC a JDBC más adelante en esta página.

Crear o Editar una Conexión de Base de Datos¶

Se crea una nueva conexión de base de datos utilizando el conector de base de datos desde una de estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La página Conexiones globales (vea Crear un extremo global en Conexiones globales).

Se puede editar una conexión de base de datos existente desde estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).
• La página Conexiones globales (vea Editar un extremo global en Conexiones globales).

Configurar una Conexión de Base de Datos¶

La configuración de una conexión de base de datos incluye estos campos:

• Nombre del Extremo: Ingrese un nombre para identificar la conexión de la base de datos. El nombre debe ser único para cada conexión de base de datos y no debe contener barras diagonales (/) o dos puntos (:). Este nombre también se utiliza para identificar el extremo de la base de datos, que hace referencia tanto a una conexión específica como a sus actividades.

• Tipo de controlador: Para filtrar la lista de controladores, seleccione el botón para el tipo de controlador apropiado.

• Controlador: Utilice el menú desplegable para seleccionar el controlador de la base de datos. Los controladores disponibles dependen de si está utilizando agentes en la nube o agentes privados (consulte Controladores de base de datos a continuación). Cuando selecciona un controlador de base de datos, los campos restantes disponibles en esta pantalla de configuración pueden cambiar, ya que solo se muestran los campos aplicables al controlador de base de datos seleccionado.

• Nombre del servidor: Ingrese el nombre, la URL o la dirección IP del servidor de base de datos.

• Nombre de la base de datos: Si corresponde, ingrese el nombre de la base de datos. Es posible que este campo no esté presente para los controladores de base de datos para los que no es aplicable, como Oracle.

• Inicio de sesión y Contraseña: Si corresponde, ingrese un nombre de usuario y una contraseña que permitan acceder a la base de datos. Puede dejar estos campos en blanco si no se requiere ningún nombre de usuario o contraseña.

• Usar puerto predeterminado: Mantenga esta casilla de verificación seleccionada para utilizar el puerto predeterminado. El puerto predeterminado varía según el controlador seleccionado. Si no desea utilizar el puerto predeterminado, desmarque la casilla de verificación Usar puerto predeterminado e ingrese el puerto que desea utilizar en el campo Puerto que aparece a continuación.

• Puerto: (Este campo está habilitado solo si la casilla Usar puerto predeterminado no está marcada). Ingrese un puerto personalizado solo si el servidor de base de datos está escuchando en un puerto que no es el predeterminado.

• Configuración opcional: Haga clic para expandir y ver configuraciones opcionales adicionales:

  

  • Optimizar para datos masivos: Disponible solo cuando está seleccionado el controlador de base de datos jTDS de Oracle o SQL Server; seleccione esta casilla de verificación para mejorar el rendimiento cuando trabaje con grandes cantidades de datos.

  • Nivel de aislamiento de transacción: Si corresponde, utilice el menú desplegable para seleccionar el nivel de aislamiento de Transact-SQL (T-SQL). No se admiten niveles de aislamiento de transacción específicos del controlador. La opción PREDETERMINADO utiliza el nivel de aislamiento de transacción predeterminado del controlador o del servidor de base de datos.

  • Tiempo de espera (seg.): Para establecer un límite de tiempo de espera para una conexión exitosa a la base de datos, ingrese una cantidad de segundos aquí. El valor predeterminado es 300 segundos (5 minutos).

  • Tamaño de obtención: Si se utiliza un controlador JDBC, esto le indica al controlador cuántas filas se deben obtener cuando se requieren más filas. Esto se puede utilizar para mejorar el procesamiento de conjuntos de datos grandes.

  • Parámetros de cadena de conexión adicionales: Para agregar parámetros adicionales a la cadena de conexión de la base de datos, introdúzcalos aquí. Tenga en cuenta que este campo está deshabilitado si ha seleccionado la opción a continuación para usar una cadena de conexión.

  • Usar cadena de conexión: Seleccione esta casilla de verificación para ingresar una cadena de conexión en el campo a continuación. Si se selecciona, se deshabilitan y anulan los Parámetros de cadena de conexión adicionales anteriores. Si se selecciona y el campo Cadena de conexión se deja en blanco, se utilizan el Nombre del servidor, el Inicio de sesión y la Contraseña configurados anteriormente.

  • Cadena de conexión: Si corresponde, ingrese una cadena de conexión en el cuadro de texto. La casilla de verificación anterior debe estar seleccionada para que este campo esté habilitado.

    Sugerencia

    Consulta la documentación específica de la base de datos para crear cadenas de conexión manuales. También puedes encontrar ejemplos en https://www.connectionstrings.com.

    Nota

    La cadena de conexión será visible en texto sin formato durante la configuración, por lo que es posible que no desee incluir el nombre de usuario y la contraseña en la cadena. En lugar de incluir estos parámetros y valores en la cadena, utilice los campos Inicio de sesión y Contraseña que se proporcionan como parte de la interfaz de usuario. Luego se agregarán a la cadena de conexión cuando sea necesario, pero no serán visibles en la pantalla.

• Prueba: Haga clic para verificar la conexión a la base de datos. Cuando prueba una conexión a la base de datos, se identifica el carácter de comillas utilizado por la base de datos, ya sea una comilla simple o doble. Si no prueba la conexión en este momento, la información de comillas de apertura y cierre se obtendrá cuando configure una actividad.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le solicita que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje te pedirá que confirmes que deseas eliminar la conexión.

Controladores de Bases de Datos¶

Los controladores disponibles para seleccionar en el menú desplegable Controlador dependen de si está utilizando agentes en la nube o agentes privados.

Agentes de la Nube¶

Los grupos de agentes de la nube solo admiten controladores JDBC. Se proporcionan estos controladores JDBC:

• IBM DB2 (AS400)

• MySQL

• Oracle

• Oracle NetSuite

• PostgreSQL

• Desplazamiento al rojo

• SQL Server jTDS

• SQL Server MS JDBC

• JTDS de Sybase

Agentes Privados¶

Los agentes privados admiten controladores JDBC y controladores ODBC. En el caso de los controladores ODBC, la arquitectura del controlador debe coincidir con el sistema del agente. Es decir, los agentes de 32 bits admiten controladores ODBC de 32 bits y los agentes de 64 bits admiten controladores ODBC de 64 bits.

Estos controladores JDBC son proporcionados por agentes privados de Windows y Linux de 64 bits:

• Amazon Redshift
• IBM DB2 (AS400)
• IBM DB2 (JCC)
• MySQL
• Oracle
• Oracle NetSuite
• PostgreSQL
• SQL Server jTDS
• SQL Server de Microsoft
• SQLite
• JTDS de Sybase

Estos controladores ODBC se incluyen con la instalación del agente privado de Windows de 64 bits:

• ANSI de PostgreSQL (x64)
• Código Unicode PostgreSQL (x64)

Este controlador ODBC se incluye con la instalación del agente privado de Linux de 64 bits:

• PostgreSQL-jitterbit

Se detectan controladores adicionales del sistema operativo. Puede instalar controladores de base de datos adicionales según sea necesario.

Próximos Pasos¶

Una vez creada una conexión de base de datos, se puede acceder a las acciones del menú para esa conexión desde la pestaña Componentes del panel del proyecto. Consulte menú de acciones de conexión para más detalles.

Una vez configurada una conexión de base de datos, puede configurar una o más actividades de base de datos asociadas con esa conexión para que se utilicen como fuente (para proporcionar datos dentro de una operación), como destino (para consumir datos dentro de una operación), en un secuencia de comandos, o puede utilizar la conexión de base de datos en un secuencia de comandos.

Configurar Actividades¶

Las actividades de la base de datos interactúan con la conexión de la base de datos para actuar como fuentes (proporcionando datos dentro de una operación) o destinos (recibiendo datos dentro de una operación).

Después de configurar una conexión de base de datos, utilice el menú desplegable Mostrar para filtrar por Extremos y, a continuación, haga clic en el bloque Conexión de base de datos para mostrar las actividades que están disponibles para usarse con una conexión de base de datos:

Para obtener más información, consulte estas actividades:

• Consulta: Consulta datos de un extremo de base de datos y está destinado a ser utilizado como fuente en una operación o llamado en un secuencia de comandos.
• Insertar: Inserta nuevos datos en un extremo de base de datos y está destinado a ser utilizado como destino en una operación o llamado en un secuencia de comandos.
• Actualizar: Actualiza datos existentes en un extremo de base de datos y está destinado a ser utilizado como destino en una operación o llamado en un secuencia de comandos.
• Actualizar: Actualiza datos existentes e inserta datos nuevos en un extremo de base de datos y está pensado para usarse como destino en una operación o para llamarse en un secuencia de comandos. (Harmony admite actividades Upsert para bases de datos mediante una combinación de consulta, inserción y actualización).

Uso de Conexiones de Bases de Datos en Secuencias de Comandos¶

Se pueden hacer referencias a las conexiones de bases de datos en un secuencia de comandos usando funciones de secuencia de comandos que utilizan un databaseId como parámetro:

Funciones de Jitterbit Script

• CacheLookup- CallStoredProcedure- DBCloseConnection- DBExecute- DBLookup- DBLookupAll- DBRollbackTransaction- DBWrite

Funciones Jitterbit de JavaScript

• Jitterbit.DbExecute- Jitterbit.DbLookup

Para obtener más detalles sobre cómo hacer referencia a extremos en secuencias de comandos, consulte Extremos en Jitterbit Script o Extremos en JavaScript.

Conversión de ODBC a JDBC¶

La conversión de una conexión de base de datos que utiliza un controlador ODBC a un controlador JDBC suele ser un proceso sencillo. Es posible que deba hacerlo si traslada un proyecto que se ejecuta en un agente privado que utiliza un controlador ODBC a un grupo de agentes en la nube Jitterbit que, a partir de Harmony 9.8, ya no admiten controladores ODBC en los grupos de agentes de la nube.

Si su conexión utiliza las opciones predeterminadas, puede convertirla rápidamente siguiendo los pasos que se describen a continuación. Sin embargo, si ha utilizado la opción para especificar parámetros de cadena de conexión adicionales o para construir la cadena de conexión manualmente, deberá ajustar esas opciones para adaptarse a las diferencias entre ODBC y JDBC.

Compatibilidad con Jitterbit está disponible para ayudarlo a convertir su conexión a JDBC si necesita asistencia para convertir sus conexiones de base de datos o la revisión de opciones avanzadas.

Conversión de Conexiones de Bases de Datos Simples¶

Para convertir una conexión de base de datos que actualmente utiliza un controlador ODBC a una que utiliza un controlador JDBC, siga estos pasos:

1. Abra la conexión de base de datos que utiliza un controlador ODBC. En este ejemplo, se abrió una conexión que utiliza el controlador PostgreSQL:

   

2. Pruebe la conexión haciendo clic en el botón Probar para asegurarse de que funciona:

   

3. Si la conexión fue exitosa, puede continuar con esta conversión. Si no fue así, corrija los errores antes de continuar.

4. Verifique si se especificaron parámetros de conexión adicionales haciendo clic en Configuración opcional en la parte inferior de la pantalla de configuración:

   

   • Si no se especificaron parámetros de conexión adicionales más allá de los valores predeterminados que se muestran arriba, puede continuar con la conversión de la conexión de la base de datos siguiendo el resto de estas instrucciones.
   • Si se especificaron parámetros de conexión adicionales además de los valores predeterminados que se muestran arriba, consulte la siguiente sección sobre Conversión de conexiones con parámetros de conexión adicionales.

5. Cambie el Tipo de controlador a JDBC y, a continuación, utilice el menú desplegable Controlador para seleccionar el controlador JDBC adecuado. En este ejemplo, seleccionamos el controlador JDBC PostgreSQL.

   

6. Pruebe la conexión revisada haciendo clic en el botón Probar para asegurarse de que funciona:

   

7. Haga clic en el botón Guardar cambios para guardar la conexión de base de datos revisada.

Conversión de Conexiones con Parámetros de Conexión Adicionales¶

Si su conexión utiliza parámetros de conexión adicionales además de los valores predeterminados que se muestran arriba, ya sea como Parámetros de cadena de conexión adicionales o si se marcó la casilla Usar cadena de conexión y la cadena de conexión se ingresó manualmente, es posible que se requiera trabajo adicional para convertir la conexión de ODBC a JDBC. Por ejemplo, los Parámetros de cadena de conexión adicionales de ODBC de SQL Server podrían ser (para usar la autenticación de Windows NTLM):

integratedSecurity=true

Un controlador JDBC jTDS de SQL Server equivalente Parámetros de cadena de conexión adicionales (para utilizar la autenticación NTLM de Windows ) sería:

useNTLMv2=true

Los parámetros de la cadena de conexión son específicos del controlador de base de datos que utilice (por ejemplo, Microsoft SQL, MySQL, PostgreSQL u Oracle). Revise las especificaciones del controlador para determinar los parámetros necesarios. Si necesita ayuda para convertir cadenas de conexión o parámetros para un controlador JDBC, comuníquese con soporte de Jitterbit.