Saltar al contenido

Conexión a la base de datos

Introducción

Una conexión a la base de datos, creada utilizando el conector de base de datos, establece acceso a una base de datos a través de un controlador JDBC o ODBC proporcionado con los agentes en la nube de Jitterbit o instalado en los agentes privados de Jitterbit. Una vez que se configura una conexión, se pueden crear instancias de actividades de base de datos asociadas con esa conexión para ser utilizadas como fuentes (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 organización de Habilitar reautenticación en cambio organization policy. Si está habilitada, un cambio en el Nombre del servidor o Inicio de sesión en la conexión de un endpoint requerirá que los usuarios vuelvan a ingresar la Contraseña para la conexión.

Crear o editar una conexión a la base de datos

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

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

Configurar una conexión a la base de datos

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

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que elegir.

  • Nombre de la conexión: Ingrese un nombre para identificar la conexión a la base de datos. El nombre debe ser único para cada conexión a la base de datos y no debe contener barras diagonales (/) ni dos puntos (:). Este nombre también se utiliza para identificar el punto final 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. Los agentes en la nube admiten un conjunto limitado de controladores JDBC, mientras que los agentes privados admiten tanto controladores ODBC como JDBC y puede instalar controladores adicionales (consulte Controladores de base de datos en agentes privados de Jitterbit para más información).

  • Controlador: Utilice la lista para seleccionar el controlador de base de datos. Los controladores disponibles dependen de si está utilizando agentes en la nube o agentes privados (consulte Controladores de base de datos). 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, URL o 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. Este campo puede no estar presente para los controladores de base de datos para los cuales este campo no es aplicable, como Oracle.

  • Inicio de sesión y Contraseña: Si es aplicable, ingrese un nombre de usuario y una contraseña que permitan el acceso a la base de datos. Puede dejar estos campos en blanco si no se requiere un nombre de usuario o 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 usar el puerto predeterminado, desmarque la casilla Usar puerto predeterminado e ingrese el puerto a utilizar en el campo Puerto a continuación.

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

  • Configuraciones opcionales: Haga clic para expandir y ver configuraciones opcionales adicionales.

    • Habilitar lote: Disponible solo cuando se utiliza un controlador JDBC, seleccione esta casilla para mejorar el rendimiento al trabajar con grandes cantidades de datos en actividades de Insertar o Actualizar. Si las configuraciones Habilitar lote y Optimizar para datos masivos son visibles, seleccionar cualquiera habilita la misma funcionalidad.

    • Optimizar para datos masivos: Disponible solo cuando se selecciona el controlador de base de datos jTDS de Oracle o SQL Server, seleccione esta casilla para mejorar el rendimiento al trabajar con grandes cantidades de datos en actividades de Insertar o Actualizar. Si las configuraciones Habilitar lote y Optimizar para datos masivos son visibles, seleccionar cualquiera habilita la misma funcionalidad.

    • Nivel de aislamiento de transacciones: Si es aplicable, use el menú desplegable para seleccionar el nivel de aislamiento de transacciones. No se admiten 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 cuánto esperar por una conexión exitosa a la base de datos, ingrese un número de segundos aquí. El valor predeterminado es de 300 segundos (5 minutos).

    • Tamaño de recuperación: Si se utiliza un controlador JDBC, esto le indica al controlador cuántas filas deben recuperarse 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: Ingrese cualquier parámetro adicional para la cadena de conexión de la base de datos aquí. Este campo está deshabilitado al usar la opción de cadena de conexión a continuación.

      Consejo

      Para la autenticación de Microsoft Entra al usar SQL Server Microsoft, ingrese authentication=ActiveDirectoryPassword en este campo.

    • Usar cadena de conexión: Seleccione esta casilla para ingresar una cadena de conexión en el campo a continuación. Si se selecciona, esto deshabilita y anula 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 utilizarán el Nombre del servidor, Inicio de sesión y Contraseña configurados anteriormente.

    • Cadena de conexión: Si es aplicable, 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 manuales. También se pueden encontrar ejemplos en https://www.connectionstrings.com.

      Nota

      La cadena de conexión será visible en texto claro durante la configuración, por lo que puede 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 proporcionados 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.

  • Probar: 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 una comilla doble. Si no prueba la conexión en este momento, la información de las comillas de apertura y cierre se recuperará 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 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 de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Siguientes pasos

Las acciones del 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 de conectores.

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 ser utilizadas 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 script.

Configurar actividades

Estos tipos de actividad están disponibles:

  • Consulta: Consulta datos de un punto final de base de datos y está destinada a ser utilizada como fuente en una operación o llamada en un script.

  • Insertar: Inserta nuevos datos en un punto final de base de datos y está destinada a ser utilizada como destino en una operación o llamada en un script.

  • Actualizar: Actualiza datos existentes en un punto final de base de datos y está destinada a ser utilizada como destino en una operación o llamada en un script.

  • Upsert: Tanto actualiza datos existentes como inserta nuevos datos en un punto final de base de datos y está destinada a ser utilizada como destino en una operación o llamada en un script. (Harmony admite actividades de Upsert para bases de datos utilizando una combinación de Consulta, Insertar y Actualizar.)

Usar conexiones de base de datos en scripts

Las conexiones de base de datos se pueden referenciar en un script utilizando funciones de script que usan un databaseId como parámetro:

Funciones de script de Jitterbit

Funciones de Jitterbit en JavaScript

Para más detalles sobre cómo referenciar endpoints en scripts, consulta Endpoints en Jitterbit Script o Endpoints en JavaScript.