Saltar al contenido

Conexión de base de datos

Introducción

Una conexión de base de datos, creada mediante el conector de base de datos, establece acceso a una base de datos a través de un controlador JDBC u ODBC proporcionado con 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 esa conexión 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 organización Habilitar reautenticación al cambiar. Si está habilitada, un cambio en el Nombre del servidor o Inicio de sesión en la conexión de un punto de conexión requerirá que los usuarios vuelvan 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 usando 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 de base de datos.

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables del proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que elegir.

  • Nombre de la conexión: Ingresa un nombre para identificar la conexión de base de datos. El nombre debe ser único para cada conexión de base de datos y no debe contener barras diagonales (/) ni dos puntos (:). Este nombre también se usa para identificar el punto de conexión de 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, selecciona el botón del tipo de controlador apropiado. Los agentes en la nube admiten solo un conjunto limitado de controladores JDBC, mientras que los agentes privados admiten tanto controladores ODBC como JDBC y puedes instalar controladores adicionales (consulta Controladores de base de datos en agentes privados de Jitterbit para obtener más información).

  • Controlador: Usa la lista para seleccionar el controlador de base de datos. Los controladores disponibles dependen de si usas agentes en la nube o agentes privados (consulta Controladores de base de datos). Cuando seleccionas 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: Ingresa el nombre, URL o dirección IP del servidor de base de datos.

    Precaución

    La versión 12.10 del agente y posteriores bloquean una conexión de base de datos a localhost o 127.0.0.1 de forma predeterminada, por seguridad. En un agente privado, consulta [JdbcSecurity] en el archivo de configuración del agente para permitir una base de datos que se ejecute en el mismo host que el agente.

  • Nombre de la base de datos: Si aplica, ingresa el nombre de la base de datos. Este campo puede no estar presente para controladores de base de datos en los que no es aplicable, como Oracle.

  • Usuario y Contraseña: Si aplica, ingresa un nombre de usuario y contraseña que permitan acceder a la base de datos. Puedes dejar estos campos en blanco si no se requiere nombre de usuario o contraseña.

  • Usar puerto predeterminado: Mantén esta casilla seleccionada para usar el puerto predeterminado. El puerto predeterminado varía según el controlador seleccionado. Si no deseas usar el puerto predeterminado, desactiva la casilla Usar puerto predeterminado e ingresa el puerto a usar en el campo Puerto a continuación.

  • Puerto: (Este campo se habilita solo si la casilla Usar puerto predeterminado está desactivada.) Ingresa un puerto personalizado solo si el servidor de base de datos está escuchando en un puerto no predeterminado.

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

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

      Importante

      Para el controlador JDBC de MySQL, también agrega rewriteBatchedStatements=true a Parámetros adicionales de cadena de conexión a continuación para obtener el beneficio completo de rendimiento de Habilitar lote.

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

    • Nivel de aislamiento de transacción: Si aplica, usa el menú desplegable para seleccionar el nivel de aislamiento de transacción. No se admiten niveles de aislamiento de transacción específicos del controlador. La opción PREDETERMINADO usa el nivel de aislamiento de transacción predeterminado del controlador o 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, ingresa aquí un número de segundos. El valor predeterminado es 300 segundos (5 minutos).

    • Tamaño de búsqueda: Si usas un controlador JDBC, esto le indica al controlador cuántas filas deben recuperarse cuando se requieren más filas. Esto se puede usar para mejorar el procesamiento de conjuntos de datos grandes.

    • Parámetros adicionales de cadena de conexión: Ingresa aquí cualquier parámetro adicional para la cadena de conexión de la base de datos. Este campo se deshabilita cuando se usa la opción de cadena de conexión a continuación.

      Consejo

      Cuando uses SQL Server MS JDBC (controlador JDBC de Microsoft para SQL Server), ingresa authentication=ActiveDirectoryPassword en este campo para autenticación de Microsoft Entra. Este campo también controla el cifrado de conexión, descrito en Cifrado de conexión y certificados de servidor.

      Precaución

      La versión 12.10 del agente y posteriores bloquean o restringen parámetros específicos aquí de forma predeterminada, por seguridad, para los controladores de MySQL, PostgreSQL, Oracle y SQL Server. En un agente privado, consulta [JdbcSecurity] en el archivo de configuración del agente para ver los parámetros restringidos y cómo permitir uno que necesites.

    • Usar cadena de conexión: Selecciona esta casilla para ingresar una cadena de conexión en el campo a continuación. Si se selecciona, esto deshabilita e invalida los Parámetros adicionales de cadena de conexión anteriores. Si se selecciona y el campo Cadena de conexión se deja en blanco, se usan el Nombre del servidor, Usuario y Contraseña configurados anteriormente.

  • Cadena de conexión: Si aplica, ingresa 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.

    !!! tip "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](https://www.connectionstrings.com).

!!! note "Nota"
    La cadena de conexión será visible en texto plano durante la configuración, por lo que es posible que no desees incluir el nombre de usuario y la contraseña en la cadena. En lugar de incluir estos parámetros y valores en la cadena, utiliza los campos **Login** y **Password** proporcionados como parte de la interfaz. Se agregarán a la cadena de conexión cuando sea necesario, pero no serán visibles en la pantalla.

!!! caution "Precaución"
    La versión 12.10 del agente y posteriores bloquean o restringen parámetros específicos aquí de forma predeterminada, por seguridad, para los controladores MySQL, PostgreSQL, Oracle y SQL Server. En un agente privado, consulta [`[JdbcSecurity]`](/es/agent/jitterbit-conf/#jdbcsecurity) en el archivo de configuración del agente para ver los parámetros restringidos y cómo permitir los que necesites.

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

  • Save: Haz clic para guardar y cerrar la configuración de conexión.

  • Discard changes: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

  • Delete: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y remoción). Un mensaje te pide 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 obtener más detalles, consulta Menús de acciones en Conceptos básicos de conectores.

Después de configurar una conexión de base de datos, puedes configurar una o más actividades de base de datos asociadas a esa conexión para usarlas como origen para proporcionar datos a una operación o como destino para consumir datos en una operación, o puedes usar la conexión de base de datos en un script.

Configurar actividades

Estos tipos de actividad están disponibles:

  • Query: Consulta datos de un extremo de base de datos y está diseñada para usarse como origen en una operación o llamarse en un script.

  • Insert: Inserta datos nuevos en un extremo de base de datos y está diseñada para usarse como destino en una operación o llamarse en un script.

  • Update: Actualiza datos existentes en un extremo de base de datos y está diseñada para usarse como destino en una operación o llamarse en un script.

  • Upsert: Tanto actualiza datos existentes como inserta datos nuevos en un extremo de base de datos y está diseñada para usarse como destino en una operación o llamarse en un script. (Harmony admite actividades Upsert para bases de datos utilizando una combinación de Query, Insert y Update.)

Usar conexiones de base de datos en scripts

Se puede hacer referencia a las conexiones de base de datos en un script utilizando funciones de script que utilizan un databaseId como parámetro:

Funciones de Jitterbit Script

Funciones JavaScript de Jitterbit

Para más detalles sobre cómo hacer referencia a conectores en scripts, consulta Conectores en Jitterbit Script o Conectores en JavaScript.