Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

✕

Conexión a base de datos

Introducción

Una conexión de base de datos, creada mediante el Conector de base de datos, establece el acceso a una base de datos mediante un controlador JDBC u ODBC proporcionado con los agentes en la nube de Jitterbit o instalado en agentes privados de Jitterbit. Una vez configurada una conexión, se pueden crear instancias de actividades de base de datos asociadas a ella para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Nota

Este conector admite la política de la organización Habilitar reautenticación al cambiar si está habilitado, al cambiar el Nombre del servidor o el Inicio de sesión en la conexión de un punto final, los usuarios deberán volver a ingresar la Contraseña de la conexión.

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:

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

Configurar una conexión de base de datos

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión a la base de datos.

Configuración de la conexión a la base de datos

Consejo

Campos con un Compatibilidad con iconos variables mediante variables globales, variables del proyecto y variables de Jitterbit. Comience escribiendo un corchete abierto [ En el campo o haciendo clic en el icono de variable para mostrar una lista de las variables existentes entre las que puede elegir.

  • Nombre de la conexión: Introduzca un nombre para identificar la conexión a la base de datos. El nombre debe ser único para cada conexión 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 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 del tipo de controlador apropiado. Agentes de la nube admiten solo un conjunto limitado de controladores JDBC, mientras que los agentes privados admite controladores ODBC y JDBC y puede instalar controladores adicionales (consulte Controladores de base de datos en agentes privados de Jitterbit para más información).

  • Controlador: Use la lista para seleccionar el controlador de la base de datos. Los controladores disponibles dependen de si utiliza agentes en la nube o agentes privados (consulte Controladores de base de datos). Al seleccionar 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, introduzca el nombre de la base de datos. Este campo puede no estar disponible para controladores de base de datos que no lo requieran, como Oracle.

  • Inicio de sesión y Contraseña: Si corresponde, introduzca 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 nombre de usuario ni contraseña.

  • Usar puerto predeterminado: Mantenga esta casilla seleccionada para usar el puerto predeterminado. El puerto predeterminado varía según el controlador seleccionado. Si no desea puerto, desmarque la casilla Usar puerto predeterminado e introduzca el puerto que desea 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 base de datos está escuchando en un puerto que no es el predeterminado.

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

    configuración opcional de conexión a la base de datos

    • Habilitar lote: Disponible solo cuando se usa un controlador JDBC, seleccione esta casilla de verificación para mejorar el rendimiento cuando se trabaja con grandes cantidades de datos con Insertar o Actualizar actividades. Si las opciones Habilitar lote y Optimizar para datos masivos están visibles, al seleccionar cualquiera de ellas se habilita la misma funcionalidad.

    • 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 con Insertar o Actualizar actividades. Si las opciones Habilitar lote y Optimizar para datos masivos están visibles, al seleccionar cualquiera de ellas se habilita la misma función.

    • Nivel de aislamiento de la transacción: Si corresponde, utilice el menú desplegable para seleccionar el nivel de aislamiento de la transacción. 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 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, introduzca aquí un número de segundos. El valor predeterminado es 300 segundos (5 minutos).

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

    • Parámetros adicionales de la cadena de conexión: Para añadir 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: Marque esta casilla para introducir una cadena de conexión en el campo inferior. Si se selecciona, se deshabilitan y anulan los Parámetros adicionales de la cadena de conexión anteriores. Si se selecciona y el campo Cadena de conexión se deja en blanco, se utilizan los valores de Nombre del servidor, Inicio de sesión y Contraseña configurados anteriormente.

    • Cadena de conexión: Si corresponde, introduzca una cadena de conexión en el cuadro de texto. La casilla de verificación superior debe estar marcada para que este campo se active.

      Consejo

      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 plano durante la configuración, por lo que no conviene incluir el nombre de usuario ni la contraseña. En lugar de incluir estos parámetros y valores, utilice los campos Inicio de sesión y Contraseña que se proporcionan en la interfaz de usuario. Se añadirán a la cadena de conexión cuando sea necesario, pero no serán visibles en pantalla.

  • Prueba: Haga clic para verificar la conexión a la base de datos. Al probar una conexión a la base de datos, se identifica el carácter de comillas utilizado por la base de datos, ya sean simples o dobles. Si no prueba la conexión en este momento, se obtendrá la información de las comillas de apertura y cierre al configurar 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 cerrarla sin guardar. Un mensaje le solicitará que confirme que desea descartar los cambios.

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

Próximos pasos

Las acciones de menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Después de configurar una conexión de base de datos, puede configurar una o más actividades de base de datos asociadas con esa conexión para usarlas como fuente para proporcionar datos a una operación o como destino para consumir datos en una operación, o puede usar la conexión de base de datos en un secuencia de comandos.

Configurar actividades

Estos tipos de actividad están disponibles:

  • 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 datos nuevos 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.

  • Upsert: Actualiza datos existentes e inserta datos nuevos en un extremo de base de datos y está diseñado para usarse como destino en una operación o 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).

Utilizar conexiones de base de datos en secuencias de comandos

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

Funciones Jitterbit de JavaScript

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.