Saltar al contenido

Actividad de Actualización o Upsert de la Base de Datos

Introducción

Una actividad de actualización de base de datos actualiza los datos existentes en un extremo de base de datos, mientras que una actividad de inserción y actualización de base de datos actualiza los datos existentes e inserta datos nuevos en un extremo de base de datos. Ambas están pensadas para utilizarse como destino para consumir datos en una operación o para ser llamadas en un secuencia de comandos. (Harmony admite actividades de inserción y actualización para bases de datos mediante una combinación de consulta, inserción y actualización). Después de configurar una conexión de base de datos, puede configurar tantas actividades de base de datos como desee para cada conexión de base de datos.

Estas actividades se cubren juntas, ya que ambas requieren que se seleccione al menos una clave de actualización para usarla como campo o campos para identificar qué registros necesitan actualizarse, y los pasos para configurar una actividad de Actualización de base de datos o Upsert son los mismos.

Crear una Actividad de Base de Datos

Una instancia de una actividad se crea a partir de una conexión utilizando un tipo de actividad.

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

Se puede editar una actividad existente desde estas ubicaciones:

Configurar una Actualización de Base de Datos o una Actividad Upsert

Los pasos para configurar una actividad de actualización o inserción de base de datos son los mismos; sin embargo, estos pasos difieren según si necesita unir varios objetos:

Actualización de un Solo Objeto o Upsert

Siga estos pasos si la actualización o inserción de la base de datos se realiza en un solo objeto y no necesita crear ninguna unión con otros objetos. Si necesita unir varios objetos, consulte en su lugar Actualización o inserción de varios objetos.

Paso 1: Ingrese un Nombre y Seleccione un Objeto

Actividad de actualización de base de datos 1 objeto único

  • Nombre: Ingrese un nombre para identificar la actividad de la base de datos. El nombre debe ser único para cada actividad de actualización o inserción de la base de datos y no debe contener barras diagonales (/) o dos puntos (:).
  • Proporcionar la referencia de nombres de tabla: Esta sección muestra las tablas disponibles en el extremo de la base de datos utilizando cualquier filtro aplicado, después de usar el icono de actualización para la carga inicial de objetos. Si hay una gran cantidad de objetos en la base de datos, se recomienda filtrar los objetos mediante Ver o Buscar antes de actualizar.

    • Ver: Use el menú desplegable para filtrar la lista de objetos mostrados por uno de "Tablas, Vistas", "Tablas", "Vistas" o "Tablas del sistema". De manera predeterminada, 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 se puede filtrar automáticamente o puede que necesites actualizarla, dependiendo de si los objetos ya se han recuperado:

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

      • Si buscas objetos que aún no se han recuperado, por ejemplo, al intentar limitar la cantidad de objetos recuperados para bases de datos con una gran cantidad de objetos, usa el ícono de actualización junto al cuadro de búsqueda para recuperar los objetos de la base de datos usando el filtro.

      Nota

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

    • Actualizar: Haga clic en el icono de actualización para cargar o recargar tablas desde el extremo de la base de datos. Esto se debe utilizar para la carga inicial de cualquier objeto. Además, también puede ser útil si ha agregado objetos recientemente 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.

    • Incluir el esquema/propietario en los nombres de las tablas: Seleccione esta casilla de verificación para incluir el esquema en los nombres de las tablas. Esto puede resultar útil si utiliza el mismo nombre de tabla en varios esquemas (por ejemplo, para desarrollo y producción) para poder ver y seleccionar la tabla en el esquema correcto.

    • Proporcione la referencia de nombres de tabla: La lista de objetos se muestra en una columna a la izquierda. Haga clic en un solo objeto para agregarlo a la tabla de la derecha. Si está actualizando o insertando datos en varios objetos que necesitan unirse, consulte Actualización o inserción de datos en varios objetos.

      Sugerencia

      Si la lista no se completa con los objetos disponibles incluso después de aplicar un filtro, la Conexión de base de datos puede no funcionar correctamente. Asegúrese de estar conectado volviendo a abrir la conexión y probando las credenciales.

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

    • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.
    • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.
    • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 2: Seleccionar Claves de Actualización

Actividad de actualización de base de datos 2 objeto único

  • Seleccionar claves: Seleccione las casillas de verificación de los campos que desee utilizar como claves de actualización. También puede seleccionar un objeto entero para seleccionar todos sus campos a la vez. Las claves de actualización son los campos que se utilizan para identificar qué registros existentes deben actualizarse. Los campos que se seleccionan para utilizar como claves de actualización se enumeran a la derecha.
  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.
  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 3: Revisar el Esquema de Datos

Actividad de actualización de base de datos 3, objeto único

  • Esquema de datos: Se muestra el esquema de datos de destino. Si la operación utiliza una transformación, los esquemas de datos se vuelven a mostrar más adelante durante la asignación de transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

    Nota

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

    Nota

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

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

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

  • Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Actualización de Varios Objetos o Upsert

Siga estos pasos si la actualización o inserción de la base de datos se realiza en varios objetos y necesita crear uniones entre ellos. Para actualizar o insertar únicamente en un único objeto, sin uniones, consulte Actualización o inserción de un único objeto.

Paso 1: Ingrese un Nombre y Seleccione Objetos

Actividad de actualización de base de datos 1, varios 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 o inserción de la base de datos y no debe contener barras diagonales (/) o dos puntos (:).
  • Proporcione la referencia de nombres de tabla: Esta sección muestra las tablas disponibles en el extremo de la base de datos utilizando cualquier filtro aplicado, después de usar el ícono de actualización ícono de actualización para la carga inicial de objetos. Si hay una gran cantidad de objetos en la base de datos, se recomienda filtrar los objetos mediante Ver o Buscar antes de actualizar.

    • Ver: Use el menú desplegable para filtrar la lista de objetos mostrados por uno de "Tablas, Vistas", "Tablas", "Vistas" o "Tablas del sistema". De manera predeterminada, 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 se puede filtrar automáticamente o puede que necesites actualizarla, dependiendo de si los objetos ya se han recuperado:

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

      • Si buscas objetos que aún no se han recuperado, por ejemplo, al intentar limitar la cantidad de objetos recuperados para bases de datos con una gran cantidad de objetos, usa el ícono de actualización junto al cuadro de búsqueda para recuperar los objetos de la base de datos usando el filtro.

      Nota

      Para las 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 icono de actualización para cargar o recargar tablas desde el extremo de la base de datos. Esto se debe utilizar para la carga inicial de cualquier objeto. Además, también puede ser útil si ha agregado objetos recientemente 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.

    • Incluir el esquema/propietario en los nombres de las tablas: Seleccione esta casilla de verificación para incluir el esquema en los nombres de las tablas. Esto puede resultar útil si utiliza el mismo nombre de tabla en varios esquemas (por ejemplo, para desarrollo y producción) para poder 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. Haga clic en los objetos de a uno por vez para agregarlos a la tabla de la derecha. Se puede seleccionar cualquier combinación de tablas, vistas y/o tablas del sistema. Si, en cambio, necesita actualizar o insertar un solo objeto sin uniones, consulte Actualización o inserción de un solo objeto.

      Sugerencia

      Si la lista no se completa con los objetos disponibles incluso después de aplicar un filtro, la Conexión de base de datos puede no funcionar correctamente. 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:

      base de datos, varios objetos, tabla 1

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

      • Principal: En cada objeto secundario que se une, use el menú desplegable para seleccionar el nombre del objeto que debe ser el principal. Esto es necesario para aplicar la integridad transaccional de un objeto, así como para derivar las claves de enlace para un objeto secundario.

      • Tipo de unión: En cada objeto secundario que se une, aparece un menú desplegable después de haber asignado Teclas de enlace (que se explican a continuación). Utilice 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 principal tenga al menos 1 registro secundario y posiblemente más registros secundarios.
        • Solo uno: Este tipo de unión requiere que cada registro principal tenga 1 y solo 1 registro secundario.
        • Cero o más: Este tipo de unión permite que cada registro principal tenga 0 o más registros secundarios.
        • Cero o Uno: Este tipo de unión permite que cada registro principal tenga 0 registros secundarios o solo 1 registro secundario.
      • Teclas de enlace: En cada objeto secundario que se une, una vez que se selecciona un objeto como Principal, aparece un enlace rojo Asignar dentro de este campo. Haga clic en Asignar para abrir una ventana independiente donde puede asignar las teclas de enlace:

        claves de enlace de asignación de base de datos

        • Objeto principal: El objeto principal y la lista de campos se muestran en la columna de la izquierda. Los campos utilizados como claves principales dentro de la base de datos se indican con un ícono de llave adjunto. Si tiene una gran cantidad de campos, puede utilizar el cuadro de búsqueda para filtrar los campos por nombre.

        • Objeto secundario: El objeto secundario y la lista de campos se muestran en la columna de la derecha. Si tiene una gran cantidad de campos, puede usar el cuadro de búsqueda para filtrar los campos por nombre.

        • Asignar clave(s) de vínculo: Para asignar un campo como clave de enlace, arrastre un campo desde el objeto principal a la izquierda hasta un campo dentro del objeto secundario a la derecha, o viceversa. Para asignar varias claves de enlace, repita este proceso.

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

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

        • Finalizar: Haga clic en Finalizar para guardar las claves de enlace asignadas y cerrar la ventana. En Claves de vínculo, debería ver ahora la cantidad de claves de enlace asignadas, en las que puede hacer clic para volver a abrir la ventana de asignación de claves de enlace. Además, el menú desplegable Tipo de unión estará disponible para que establezca el tipo de relación (cardinalidad) entre los objetos seleccionados:

          tabla 2 de varios objetos de la base de datos

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

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

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

      • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 2: Seleccionar Claves de Actualización

Actividad de actualización de base de datos 2 objetos múltiples

  • Seleccionar claves: Seleccione las casillas de verificación de los campos que desee utilizar como claves de actualización. También puede seleccionar un objeto entero para seleccionar todos sus campos a la vez. Las claves de actualización son los campos que se utilizan para identificar qué registros existentes deben actualizarse. Los campos que se seleccionan para utilizar como claves de actualización se enumeran a la derecha.
  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.
  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 3: Revisar el Esquema de Datos

Actividad de actualización de base de datos 3 objetos múltiples

  • Esquema de datos: Se muestra el esquema de datos de destino. Si la operación utiliza una transformación, los esquemas de datos se vuelven a mostrar más adelante durante la asignación de transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

    Nota

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

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

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

  • Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos Pasos

Después de configurar una actividad de actualización de base de datos o de inserción y actualización, puede utilizarla dentro de una operación o secuencia de comandos como se describe a continuación. También puede configurar la fragmentación de datos para dividir los datos en fragmentos más pequeños para su procesamiento.

Completar la Operación

Después de configurar una actividad de actualización de base de datos o de inserción y actualización, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación de una operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Una vez que se ha creado una actividad de actualización de base de datos o de inserción, se puede acceder a las acciones del menú para esa actividad desde el panel del proyecto en las pestañas Flujos de Trabajo o Componentes, y desde el tela de diseño. Consulte menú de acciones de la actividad para más detalles.

Las actividades de actualización o inserción de bases de datos se pueden utilizar como objetivo con estos patrones de operación:

Otros patrones no son válidos si se utilizan actividades de actualización de base de datos o de inserción y actualización. Consulte los patrones de validación en Validez de la operación página.

Dentro de una transformación, si se utiliza la opción duplicar un esquema proporcionada por una actividad de base de datos que utiliza una sola tabla (sin uniones), el esquema reflejado resultante se crea automáticamente con un nodo adicional llamado row cuando se asignan campos dentro de este nodo adicional, el nodo se convierte en un nodo de bucle para permitir que todos los registros pasen por él (consulte Nodos de bucle en Nodos y campos).

Además, si se unen tablas de bases de datos, tenga en cuenta que los valores de los campos unidos de una tabla secundaria son, de manera predeterminada, los valores de los campos unidos de la tabla principal. Los campos unidos de una tabla secundaria no se pueden asignar a.

Cuando esté listo, desplegar y ejecute la operación y valide el comportamiento verificando los registros de operación.

Uso de Actividades de Base de Datos en Secuencias de Comandos

Las actividades de actualización o inserción de bases de datos también se pueden referenciar en un secuencia de comandos para usar con funciones de secuencia de comandos que utilizan una base de datos target como parámetro, incluyendo los siguientes:

  • DBLoad- DBWrite

Para obtener más detalles sobre cómo hacer referencia a actividades en secuencias de comandos, consulte Extremos en Jitterbit Script.

Además, es posible que pueda utilizar funciones de base de datos adicionales en la transformación. Por ejemplo, al asignar a un destino de base de datos, si tiene un destino de varias tablas con relaciones padre-hijo y está actualizando o insertando datos, puede utilizar las funciones de transformación <SQLIDENTITY> y <SEQUENCE>.

  • <SQLIDENTITY>Se utiliza para todas las bases de datos de destino que no sean de Oracle que admitan claves de generación automática de números o de identidad. Una vez que se inserta la base de datos principal, la base de datos secundaria puede heredar el número generado de la base de datos principal asignando esta función a la clave externa en la tabla secundaria.
  • <SEQUENCE> realiza una acción similar con las bases de datos Oracle.

Utilice Fragmentación de Datos

Al utilizar la fragmentación de datos en una operación cuyo objetivo es una actividad de base de datos, tenga 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 archivo de destino, que se envía a la base de datos para su inserción o actualización.

Si configura la variable Jitterbit jitterbit.target.db.commit_chunks a 1 o true cuando se habilita la fragmentación de datos, cada fragmento se envía a la base de datos a medida que está disponible. Esto puede mejorar el rendimiento significativamente, ya que la inserción y actualización de la base de datos se realizan en paralelo.

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