Saltar al contenido

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 a través de un controlador JDBC u 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, puede crear instancias de actividades de base de datos asociadas con esa conexión para usarlas 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 la organización Habilitar reautenticación en caso de cambio. Si está habilitado, un cambio en el Nombre del servidor o el Inicio de sesión en la conexión de un punto final requerirá que los usuarios vuelvan a ingresar la Contraseña para 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 a una 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 de iconos variables mediante variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el icono de la variable para mostrar una lista de las variables existentes entre las que elegir.

  • Nombre de la conexión: 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 correspondiente al tipo de controlador apropiado. Agentes de la nube solo admite un conjunto limitado de controladores JDBC, mientras que agentes privados admite controladores ODBC y JDBC y puede instalar controladores adicionales (consulte Controladores de base de datos en agentes privados de Jitterbit para obtener más información).

  • Controlador: Utilice la lista 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). 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, 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:

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

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

Próximos pasos

Se puede acceder a las acciones del menú de una conexión y sus tipos de actividad desde el panel de proyecto y la paleta de componentes de diseño. Para obtener más información, 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 que se utilicen como fuente para proporcionar datos a una operación o como destino para consumir datos en una operación, o puede utilizar la conexión de base de datos en un secuencia de comandos.

Configurar actividades

Estos tipos de actividades 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 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.

  • Upsert: 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 ser llamado 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 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

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.