Conexión de Base de Datos¶

Introducción¶

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

Los Agentes en 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 un controlador ODBC a 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 Conexiones de la paleta de componentes de diseño (vea Paleta de Componentes de Diseño).
• La página Conexiones globales (vea Crear una conexión global en Conexiones globales).

Una conexión de base de datos existente se puede editar desde estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (vea Paleta de Componentes de Diseño).
• La pestaña Componentes del panel del proyecto (vea Menú de acciones de componentes en Ficha Componentes del panel Proyecto).
• La página Conexiones globales (vea Editar una conexión 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 usar 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 usa para identificar el extremo de la base de datos, que se refiere 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 Nube o Agentes Privados (consulte Controladores de base de datos abajo). 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 la 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 este campo no es aplicable, como Oracle.

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

• Usar puerto predeterminado: Mantenga esta casilla de verificación seleccionada para usar el puerto predeterminado. El puerto predeterminado difiere según el controlador seleccionado. Si no desea usar el puerto predeterminado, desmarque la casilla de verificación Usar puerto predeterminado e ingrese el puerto a usar en el campo Puerto 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 la base de datos está escuchando en un puerto no predeterminado.

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

  

  • Optimizar para datos masivos: Disponible solo cuando se selecciona el controlador de base de datos Oracle o SQL Server jTDS, seleccione esta casilla de verificación para mejorar el rendimiento cuando se trabaja con grandes cantidades de datos.

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

  • 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 usa 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 grandes conjuntos de datos.

  • Parámetros adicionales de la cadena de conexión: Para agregar parámetros adicionales a la cadena de conexión de la base de datos, ingréselos 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, esto deshabilita y anula 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, Inicio de sesión y Contraseña como se configuró 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.

    Consejo

    Consulte la documentación específica de la base de datos para crear cadenas de conexión manual. También se pueden encontrar ejemplos en https://www.connectionstrings.com.

    Nota

    La cadena de conexión será visible en texto sin cifrar 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 de 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 cotización de apertura y cierre se recuperará cuando configure una actividad.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de 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 pide 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, eliminación y eliminación de componentes). Un mensaje le pide que confirme que desea eliminar la conexión.

Controladores de Base de Datos¶

Los controladores disponibles para seleccionar en el menú desplegable Controlador dependen de si está utilizando Agentes en Nube o Agentes Privados.

Agentes en Nube¶

Los Grupos de Agentes en 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

• Sybase jTDS

Agentes Privados¶

Los Agentes Privados admiten controladores JDBC y controladores ODBC. Para 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 SQLMicrosoft
• SQLite
• Sybase jTDS

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

• PostgreSQL ANSI (x64) PostgreSQL Unicode (x64)

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

• PostgreSQL-jitterbit

Los controladores adicionales se detectan desde el sistema operativo. Puede instalar controladores de base de datos adicionales según sea necesario.

Próximos Pasos¶

Después de crear una conexión de base de datos, se puede acceder a las acciones de menú para esa conexión desde la pestaña Componentes del panel del proyecto. Consulte Menú de acciones de conexión para detalles.

Una vez que configure 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 origen (para proporcionar datos dentro de una operación), como destino (para consumir datos dentro de una operación) o en un secuencia de comandos. o puede usar la conexión de la 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) u objetivos (recibiendo datos dentro de una operación).

Después de configurar una conexión de base de datos, use el menú desplegable Mostrar para filtrar en Extremos, y luego haga clic en el bloque de conexión de base de datos para mostrar las actividades que están disponibles para usar con una conexión de base de datos:

Para más información, consulta estas actividades:

• Consulta: consulta datos desde un extremo de la base de datos y está diseñado para usarse como fuente en una operación o llamarse en una secuencia de comandos.
• Insertar: Inserta nuevos datos en un extremo de la base de datos y está diseñado para usarse como destino en una operación o llamarse en un secuencia de comandos.
• Actualizar: Actualiza los datos existentes en un extremo de la base de datos y está diseñado para usarse como destino en una operación o llamarse en un secuencia de comandos.
• Insertar: Actualiza los datos existentes e inserta datos nuevos en un extremo de la base de datos y está diseñado para usarse como destino en una operación o llamarse en un secuencia de comandos. (Jitterbit Harmony admite actividades Upsert para bases de datos mediante una combinación de Query, Insert y Update).

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

Se puede hacer referencia a las conexiones de la base 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 de 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¶

Convertir una conexión de base de datos de un controlador ODBC a un controlador JDBC suele ser un proceso sencillo. Es posible que deba hacerlo si mueve un proyecto de un Agente Privado mediante un controlador ODBC a un Grupo de Agentes en Nube que, a partir de Jitterbit Harmony 9.8, ya no son compatibles con los controladores ODBC en los Grupos de Agentes en 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.

Soporte de jitterbit está disponible para ayudarlo a convertir su conexión a JDBC si necesita ayuda 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 usa un controlador ODBC a una que usa un controlador JDBC, siga estos pasos:

1. Abra la conexión de la base de datos que utiliza un controlador ODBC. En este ejemplo, se abrió una conexión usando 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. De lo contrario, 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 hay parámetros de conexión adicionales especificados además de los 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, luego use el menú desplegable Controlador para seleccionar el controlador JDBC apropiado. En este ejemplo, seleccionamos el controlador_PostgreSQL_ JDBC.

   

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 la base de datos revisada.

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

Si su conexión usa parámetros de conexión adicionales más allá de los valores predeterminados que se muestran arriba, ya sea como Parámetros de cadena de conexión adicionales o 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 SQL Server ODBC 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 usar la autenticación de Windows NTLM) sería:

useNTLMv2=true

Los parámetros de la cadena de conexión son específicos del controlador de la base de datos que utiliza (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.