Saltar al contenido

Actividad de Actualización de Base de Datos en Jitterbit Studio

Introducción

Una actividad de Actualización de Base de Datos, utilizando su conexión de Base de Datos, actualiza datos existentes en una base de datos configurada y está destinada a ser utilizada como un objetivo para consumir datos en una operación.

La actividad de Actualización se utiliza para actualizar registros que ya existen en una base de datos configurada. Si en su lugar desea insertar registros si no existen, así como actualizar registros si existen, utilice una actividad de Upsert de Base de Datos.

Crear una actividad de Actualización de Base de Datos

Una instancia de una actividad de Actualización de Base de Datos se crea a partir de una conexión de Base de Datos utilizando su tipo de actividad Actualización.

Para crear una instancia de una actividad, arrastre el tipo de actividad al lienzo de diseño o copie el tipo de actividad y péguelo en el lienzo de diseño. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de Actualización de Base de Datos existente se puede editar desde estas ubicaciones:

Configurar una actividad de Actualización de Base de Datos

Siga estos pasos para configurar una actividad de Actualización de Base de Datos:

Actualización de un solo objeto

Sigue estos pasos si la actualización de la base de datos es para un solo objeto y no necesitas crear ninguna unión con otros objetos. Si necesitas unir múltiples objetos, consulta en su lugar Actualización de múltiples objetos.

Paso 1: Ingresa un nombre y selecciona un objeto

  • Menú de endpoint: Si tienes múltiples endpoints del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del endpoint actual. Haz clic en el menú para cambiar a un endpoint diferente. Para más información, consulta Cambiar el endpoint asignado en Pantallas de configuración.

    • Editar endpoint: Aparece cuando pasas el cursor sobre el nombre del endpoint actual. Haz clic para editar la configuración de conexión del endpoint seleccionado actualmente.

  • Nombre: Ingresa un nombre para identificar la actividad de la base de datos. El nombre debe ser único para cada actividad de Actualización de la base de datos y no debe contener barras inclinadas (/) o dos puntos (:).

  • Proporciona la referencia de los nombres de las tablas: Esta sección muestra las tablas disponibles en el endpoint de la base de datos utilizando cualquier filtro aplicado, después de usar el ícono de refresco para la carga inicial de objetos. Si hay un gran número de objetos en la base de datos, se recomienda filtrar los objetos utilizando Ver o Buscar antes de refrescar.

    • Ver: Usa el menú desplegable para filtrar la lista de objetos mostrados a uno de "Tablas, Vistas", "Tablas", "Vistas", o "Tablas del sistema". Por defecto, se muestra la vista "Tablas, Vistas".

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas. La lista de objetos puede filtrarse automáticamente o puede ser necesario actualizar la lista, dependiendo de si los objetos ya han sido recuperados:

      • Si se busca en objetos que ya han sido recuperados de la base de datos y ya aparecen en la lista, cualquier término de búsqueda escrito en el cuadro de búsqueda filtra automáticamente la lista.

      • Si se busca en objetos que aún no han sido recuperados, por ejemplo, al intentar limitar el número de objetos recuperados para bases de datos con un gran número de objetos, use el ícono de actualización junto al cuadro de búsqueda para obtener los objetos de la base de datos utilizando el filtro.

      Nota

      Para bases de datos que no admiten la búsqueda de objetos, como Microsoft Access, no se devuelven resultados.

    • Actualizar: Haga clic en el ícono de actualización para cargar o recargar tablas desde el punto final de la base de datos. Esto debe usarse para la carga inicial de cualquier objeto. Además, también puede ser útil si ha agregado recientemente objetos a la base de datos, o si tiene criterios de búsqueda adicionales que desea aplicar antes de recuperar objetos de la base de datos.

    • Permitir la truncación de campos de caracteres para evitar errores de longitud de campo: Seleccione esta casilla para permitir que los campos se trunquen según sea necesario si el campo de destino es más pequeño que el campo de origen. Está desmarcada por defecto para nuevas actividades creadas después de la versión 11.39 de Harmony. Cuando esta casilla se deja desmarcada y datos excesivos pasan, se informa un estado de operación Error. Si la casilla está seleccionada, se informa un estado de Éxito con Información en su lugar, y los registros de operación dirán que Uno o más valores fueron truncados al insertar y/o actualizar el campo.

    • Incluir el esquema/propietario en los nombres de las tablas: Seleccione esta casilla para incluir el esquema en los nombres de las tablas. Esto puede ser útil si utiliza el mismo nombre de tabla en múltiples esquemas (como para desarrollo y producción) para permitirle ver y seleccionar la tabla en el esquema correcto.

  • Proporcionar la referencia de nombres de tabla: La lista de objetos se muestra en una columna a la izquierda. Haz clic en un solo objeto para agregarlo a la tabla a la derecha. Si estás actualizando o insertando múltiples objetos que necesitan ser unidos, consulta Actualización de múltiples objetos.

    !!! tip "Consejo"
    Si la lista no se llena con objetos disponibles incluso después de aplicar un filtro, la [Conexión a la base de datos](/es/integration-studio/design/connectors/database/database-connection) puede no haber sido exitosa. Asegúrate de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Tabla de objetos seleccionados: El objeto seleccionado se muestra en una tabla a la derecha. Las columnas en esta tabla no son relevantes para actualizaciones o inserciones de un solo objeto y no se pueden editar.

  • Guardar y salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Terminado en el último paso.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas descartar los cambios.

Paso 2: Seleccionar claves de actualización

  • Seleccionar claves: Selecciona las casillas de verificación de cualquier campo que desees utilizar como claves de actualización. También puedes seleccionar un objeto completo para seleccionar todos sus campos a la vez. La(s) clave(s) de actualización son el(los) campo(s) utilizados para identificar qué registros existentes necesitan ser actualizados. Cualquier campo que se seleccione para ser utilizado como clave de actualización se enumerará a la derecha.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Terminado en el último paso.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 3: Revisar el esquema de datos

  • Esquema de Datos: Se muestra el esquema de datos de destino. Si la operación utiliza una transformación, los esquemas de datos se mostrarán nuevamente más adelante durante el proceso de mapeo de transformación, donde puedes mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más.

    Nota

    Los datos se transfieren tal como se proporcionan. Si hay desajustes en la longitud de los datos entre los campos de origen y destino, puedes usar Funciones de cadena para recortar los datos.

    Nota

    Para actualizar un esquema de datos en una actividad existente, debes avanzar a través de cada paso de configuración de la actividad nuevamente, realizando al menos un cambio (como agregar y eliminar un carácter del final del nombre de la actividad) para forzar una actualización del esquema.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Actualización de múltiples objetos

Sigue estos pasos si la actualización de la base de datos o el upsert es para múltiples objetos y necesitas crear uniones entre ellos. Para actualizar o hacer upsert solo a un objeto, sin uniones, consulta Actualización de un solo objeto.

Paso 1: Ingresar un nombre y seleccionar objetos

  • Nombre: Ingrese un nombre para identificar la actividad de la Base de Datos. El nombre debe ser único para cada actividad de Actualización de la Base de Datos y no debe contener barras diagonales (/) ni dos puntos (:).

  • Proporcionar la referencia de los nombres de las tablas: Esta sección muestra las tablas disponibles en el punto final de la Base de Datos utilizando cualquier filtro aplicado, después de usar el ícono de refresco para la carga inicial de objetos. Si hay un gran número de objetos en la base de datos, se recomienda filtrar los objetos utilizando Ver o Buscar antes de refrescar.

    • Ver: Use el menú desplegable para filtrar la lista de objetos mostrados a uno de "Tablas, Vistas", "Tablas", "Vistas", o "Tablas del Sistema". Por defecto, se muestra la vista "Tablas, Vistas".

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas. La lista de objetos puede filtrarse automáticamente o puede que necesite refrescar la lista, dependiendo de si los objetos ya han sido recuperados:

      • Si se busca en objetos que ya han sido recuperados de la base de datos y ya aparecen en la lista, cualquier término de búsqueda escrito en el cuadro de búsqueda filtra automáticamente la lista.

      • Si se busca en objetos que aún no han sido recuperados, por ejemplo, al intentar limitar el número de objetos recuperados para bases de datos con un gran número de objetos, use el ícono de refresco junto al cuadro de búsqueda para obtener los objetos de la base de datos utilizando el filtro.

      Nota

      Para bases de datos que no admiten la búsqueda de objetos, como Microsoft Access, no se devuelven resultados.

    • Refrescar: Haga clic en el ícono de refresco para cargar o recargar tablas desde el punto final de la Base de Datos. Esto debe usarse para la carga inicial de cualquier objeto. Además, también puede ser útil si ha agregado recientemente objetos a la base de datos, o si tiene criterios de búsqueda adicionales que desea aplicar antes de recuperar objetos de la base de datos.

  • Permitir la truncación de campos de caracteres para evitar errores de longitud de campo: Seleccione esta casilla para permitir que los campos se trunquen según sea necesario si el campo de destino es más pequeño que el campo de origen. Está desmarcada por defecto. Cuando esta casilla se deja desmarcada y los datos excedidos pasan, se muestra un estado de Error. Si la casilla está seleccionada, se muestra un estado de Éxito con Información en su lugar, y los registros de operación dirán que Uno o más valores fueron truncados al insertar y/o actualizar el campo.

  • Incluir el esquema/propietario en los nombres de las tablas: Seleccione esta casilla para incluir el esquema en los nombres de las tablas. Esto puede ser útil si utiliza el mismo nombre de tabla en múltiples esquemas (como para desarrollo y producción) para permitirle ver y seleccionar la tabla en el esquema correcto.

  • Proporcionar la referencia de los nombres de las tablas: La lista de objetos se muestra en una columna a la izquierda. Haga clic en los objetos uno a la vez para agregarlos a la tabla a la derecha. Se puede seleccionar cualquier combinación de tablas, vistas y/o tablas del sistema. Si en su lugar necesita actualizar un solo objeto sin uniones, consulte Actualización de un solo objeto.

    !!! tip "Consejo"
    Si la lista no se llena con objetos disponibles incluso después de aplicar un filtro, la [Conexión a la base de datos](/es/integration-studio/design/connectors/database/database-connection) puede no ser exitosa. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Tabla de objetos seleccionados: Los objetos seleccionados se muestran en una tabla a la derecha. Cada columna se detalla a continuación:

    • Tabla: El nombre del objeto seleccionado, una tabla, vista o tabla del sistema.

      Nota

      Los nombres de las tablas con caracteres especiales como + no son compatibles con esta actividad.

    • Padre: En cada objeto hijo que se une, use el menú desplegable para seleccionar el nombre del objeto que debe ser el padre. Esto es necesario para hacer cumplir la integridad transaccional de un objeto, así como para derivar la(s) clave(s) de enlace para un objeto hijo.

      • Tipo de unión: En cada objeto hijo que se une, se habilita un menú desplegable después de haber asignado Claves de enlace (cubierto a continuación). Utiliza el menú desplegable para establecer el tipo de relación entre los objetos seleccionados:

        • Uno o más: Este tipo de unión requiere que cada registro padre tenga al menos 1 registro hijo, y posiblemente más registros hijos.

        • Solo uno: Este tipo de unión requiere que cada registro padre tenga 1 y solo 1 registro hijo.

        • Cero o más: Este tipo de unión permite que cada registro padre tenga 0 o más registros hijos.

        • Cero o uno: Este tipo de unión permite que cada registro padre tenga 0 registros hijos o solo 1 registro hijo.

      • Claves de enlace: En cada objeto hijo que se une, una vez que se selecciona un objeto como Padre, aparece un enlace rojo Asignar dentro de este campo. Haz clic en Asignar para abrir una ventana separada donde asignas las claves de enlace.

        • Objeto padre: El objeto padre y la lista de campos se muestran en la columna izquierda. Cualquier campo utilizado como clave primaria dentro de la base de datos está indicado por un ícono de llave . Si tienes un gran número de campos, puedes utilizar el cuadro de búsqueda para filtrar campos por nombre.

        • Objeto hijo: El objeto hijo y la lista de campos se muestran en la columna derecha. Si tienes un gran número de campos, puedes utilizar el cuadro de búsqueda para filtrar campos por nombre.

        • Asignar clave(s) de enlace: Para asignar un campo como clave de enlace, arrastra un campo del objeto padre a la izquierda a un campo dentro del objeto hijo a la derecha, o viceversa. Para asignar múltiples claves de enlace, repite este proceso.

        • Desasignar clave(s) de enlace: Para desasignar claves de enlace, haz clic en cualquier campo que ya haya sido vinculado. Los campos vinculados se deseleccionan.

        • Comenzar de nuevo: Para borrar todas las claves de enlace asignadas, haz clic en Comenzar de nuevo ubicado debajo de la lista de padres a la izquierda.

        • Finalizar: Haz clic en Finalizar para guardar las claves de enlace asignadas y cerrar la ventana. Bajo Claves de enlace, ahora deberías ver el número de claves de enlace asignadas, que puedes hacer clic para reabrir la ventana de asignación de claves de enlace. Además, el menú desplegable Tipo de unión se habilita para que establezcas el tipo de relación (cardinalidad) entre los objetos seleccionados.

  • Eliminar: Para eliminar un objeto seleccionado de la tabla, pasa el cursor sobre la columna más a la derecha y haz clic en el ícono de eliminar .

  • Guardar y Salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 2: Seleccionar claves de actualización

  • Seleccionar claves: Selecciona las casillas de verificación de los campos que deseas usar como claves de actualización. También puedes seleccionar un objeto completo para seleccionar todos sus campos a la vez. La(s) clave(s) de actualización son el(los) campo(s) utilizados para identificar qué registros existentes necesitan ser actualizados. Cualquier campo que se seleccione para ser utilizado como clave de actualización se lista a la derecha.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 3: Revisar el esquema de datos

  • Esquema de Datos: El esquema de datos de destino se muestra. Si la operación utiliza una transformación, los esquemas de datos se mostrarán nuevamente más adelante durante el proceso de mapeo de transformación, donde puedes mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más.

    Nota

    Para actualizar un esquema de datos en una actividad existente, debes avanzar a través de cada paso de configuración de actividad nuevamente, realizando al menos un cambio (como agregar y eliminar un carácter del final del nombre de la actividad) para forzar una actualización del esquema.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Siguientes pasos

Después de configurar una actividad de Actualización de base de datos, puedes usarla dentro de una operación o script como se describe a continuación.

Completar la operación

Después de configurar una actividad de Actualización de base de datos, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de operación. También puedes configurar la configuración de la operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta el menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades de Actualización de base de datos pueden usarse como un objetivo con estos patrones de operación:

Otros patrones no son válidos utilizando actividades de Actualización de base de datos. Consulta los patrones de validación en la página de Validez de operación.

Dentro de una transformación, si se utiliza la opción de reflejar un esquema proporcionada por una actividad de base de datos utilizando una sola tabla (sin uniones), el esquema reflejado resultante se crea automáticamente con un nodo adicional llamado row. Cuando los campos dentro de este nodo adicional se mapean, el nodo se convierte en un nodo de bucle para permitir que todos los registros sean recorridos (consulta Nodos de bucle bajo Estructuras de datos).

Además, si se están uniendo tablas de base de datos, ten en cuenta que los valores de los campos unidos de una tabla hija se establecen de forma predeterminada a los valores de los campos unidos de la tabla padre. Los campos unidos de una tabla hija no se pueden mapear.

Cuando estés listo, despliega y ejecuta la operación y valida el comportamiento revisando los registros de operación.

Usar actividades de base de datos en scripts

Las actividades de base de datos Actualizar también se pueden referenciar en un script para su uso con funciones de script que utilizan un target de base de datos como parámetro, incluyendo estas:

  • DBLoad
  • DBWrite

Para más detalles sobre cómo referenciar actividades en scripts, consulta Puntos finales en Jitterbit Script.

Además, es posible que puedas utilizar funciones adicionales de base de datos en la transformación. Por ejemplo, al mapear a un objetivo de base de datos, si tienes un objetivo de múltiples tablas con relaciones padre-hijo y estás actualizando o insertando datos, puedes usar las funciones de transformación <SQLIDENTITY> y <SEQUENCE>.

  • <SQLIDENTITY> se utiliza para todas las bases de datos de destino que no son Oracle y que admiten claves de generación de números automáticos o de identidad. Después de que se inserte el padre, el hijo puede heredar el número generado del padre mapeando esta función a la clave externa en la tabla hija.
  • <SEQUENCE> realiza una acción similar con bases de datos Oracle.

Usar fragmentación

Al usar fragmentación en una operación donde el objetivo es una actividad de base de datos, ten en cuenta que los datos de destino se escriben primero en numerosos archivos temporales (uno para cada fragmento). Estos archivos se combinan luego en un solo archivo de destino, que se envía a la base de datos para inserción/actualización.

Si estableces la variable de Jitterbit jitterbit.target.db.commit_chunks en 1 o true cuando la fragmentación está habilitada, cada fragmento se compromete a la base de datos a medida que se vuelve disponible. Esto puede mejorar significativamente el rendimiento, ya que las inserciones/actualizaciones en la base de datos se realizan en paralelo.

Para obtener instrucciones y mejores prácticas sobre el uso de fragmentación, consulte Opciones de operación.