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

Introducción¶

Una actividad de Actualización de base de datos actualiza los datos existentes en un extremo de la base de datos, mientras que una actividad de Actualización de la base de datos actualiza los datos existentes e inserta datos nuevos en un extremo de la base de datos. Ambos están pensados para usarse como destino para consumir datos en una operación o para ser llamados en un secuencia de comandos. (Harmony admite actividades Upsert para bases de datos mediante el uso de una combinación de Consulta, Insertar y Actualizar). 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 actividades requieren que se seleccione al menos una clave de actualización para usarla como campo o campos para identificar qué registros deben 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 cópielo y péguelo en el tela de diseño. Para obtener más información, consulte Creación de una instancia de actividad en Reutilización de componentes.

Una actividad existente se puede editar desde estas ubicaciones:

• El tela de diseño (consulte Menú de acciones del componente en Tela de Diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

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

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

• Para actualizar o insertar solo un objeto, sin uniones, consulte Actualización o inserción de un solo objeto.
• Para actualizar o insertar múltiples objetos, con uniones, consulte Actualización o inserción de múltiples objetos.

Actualización o Upsert de un Solo Objeto¶

Siga estos pasos si la actualización o inserción de la base de datos es para un solo objeto y no necesita crear ninguna combinación con otros objetos. Si necesita unir varios objetos, consulte Actualización o inserción de múltiples objetos.

• Paso 1: Ingrese un nombre y seleccione un objeto
• Paso 2: Seleccionar claves de actualización
• Paso 3: revisar el esquema de datos

Paso 1: Ingrese un Nombre y Seleccione un Objeto¶

• Nombre: Introduzca un nombre que se utilizará para identificar la actividad de la base de datos. El nombre debe ser único para cada actualización de la base de datos o actividad de Upsert y no debe contener barras diagonales (/) o dos puntos (:).

• Proporcione la referencia de nombres de tablas: Esta sección muestra las tablas disponibles en el extremo de la base de datos usando cualquier filtro aplicado, después de usar el í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 usando Ver o Buscar antes de actualizar.

  • Ver: Utilice 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 cualquier parte del nombre del objeto 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 es posible que necesite actualizar la lista, dependiendo de si los objetos ya se han recuperado:

    • Si busca 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 busca objetos que aún no se han recuperado, por ejemplo, cuando intenta limitar la cantidad de objetos recuperados para bases de datos con una gran cantidad de objetos, use el ícono de actualización al lado del cuadro de búsqueda para recuperar los objetos de la base de datos utilizando 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 debe usarse para la carga inicial de cualquier objeto. Además, también puede resultar ú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 permitirle ver y seleccionar la tabla en el esquema correcto.

  • Proporcione la referencia de nombres de tablas: 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 varios objetos que deben unirse, consulte Actualización o inserción de múltiples objetos.

    Consejo

    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 tener éxito. Asegúrese 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 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 para este paso y cerrar la configuración de la actividad.
  • Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente. 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 pide que confirme que desea descartar los cambios.

Paso 2: Seleccione Actualizar Claves¶

• 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 completo para seleccionar todos sus campos a la vez. Las claves de actualización son los campos utilizados para identificar qué registros existentes deben actualizarse. Todos los campos seleccionados para usarse como claves de actualización se enumeran a la derecha.
• Volver: 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 para este paso y continuar con el siguiente. 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 pide que confirme que desea 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 muestran nuevamente 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 de destino, puede utilizar Funciones de cadena para recortar los datos.

  Nota

  Para actualizar un esquema de datos en una actividad existente, debe 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 al final del nombre de la actividad ) para forzar una actualización del esquema.

• Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver 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 cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Actualización o Upsert de Múltiples Objetos¶

Siga estos pasos si la actualización o inserción de la base de datos es para varios objetos y necesita crear uniones entre ellos. Para actualizar o insertar solo un solo objeto, sin uniones, consulte Actualización o inserción de un solo objeto.

• Paso 1: Ingrese un nombre y seleccione objetos
• Paso 2: Seleccionar claves de actualización
• Paso 3: revisar el esquema de datos

Paso 1: Ingrese un Nombre y Seleccione Objetos¶

• Nombre: Introduzca un nombre que se utilizará para identificar la actividad de la base de datos. El nombre debe ser único para cada actualización de la base de datos o actividad de Upsert y no debe contener barras diagonales (/) o dos puntos (:).

• Proporcione la referencia de nombres de tablas: Esta sección muestra las tablas disponibles en el extremo de la base de datos usando cualquier filtro aplicado, después de usar el í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 usando Ver o Buscar antes de actualizar.

  • Ver: Utilice 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 cualquier parte del nombre del objeto 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 es posible que necesite actualizar la lista, dependiendo de si los objetos ya se han recuperado:

    • Si busca 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 busca objetos que aún no se han recuperado, por ejemplo, cuando intenta limitar la cantidad de objetos recuperados para bases de datos con una gran cantidad de objetos, use el ícono de actualización al lado del cuadro de búsqueda para recuperar los objetos de la base de datos utilizando 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 debe usarse para la carga inicial de cualquier objeto. Además, también puede resultar ú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 permitirle ver y seleccionar la tabla en el esquema correcto.

  • Proporcione la referencia de nombres de 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 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.

    Consejo

    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 tener éxito. 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.

    • Padre: En cada objeto secundario 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 las claves de enlace para un objeto secundario.

    • Tipo de unión: En cada objeto secundario que se une, aparece un menú desplegable disponible después de haber asignado Claves de enlace (que se explica 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.

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

      

      • Objeto principal: El objeto principal y la lista de campos se muestran en la columna de la izquierda. Cualquier campo utilizado como clave principal dentro de la base de datos se indica mediante un icono de clave . 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 utilizar el cuadro de búsqueda para filtrar los campos por nombre.

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

      • Desasignar clave(s) de enlace: Para cancelar la asignación de claves de enlace, haga clic en cualquier campo que ya haya sido vinculado. Los campos vinculados quedan deseleccionados.

      • 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 enlace, ahora debería ver el número 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 está disponible para que usted establezca el tipo de relación (cardinalidad) entre los objetos seleccionados:

        

    • Eliminar: Para eliminar un objeto seleccionado de la tabla, coloque el cursor sobre la columna situada más a la derecha y haga clic en el icono de eliminación .

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

    • Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente. 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 pide que confirme que desea descartar los cambios.

Paso 2: Seleccione Actualizar Claves¶

• 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 completo para seleccionar todos sus campos a la vez. Las claves de actualización son los campos utilizados para identificar qué registros existentes deben actualizarse. Todos los campos seleccionados para usarse como claves de actualización se enumeran a la derecha.
• Volver: 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 para este paso y continuar con el siguiente. 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 pide que confirme que desea 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 muestran nuevamente 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 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 al final del nombre de la actividad ) para forzar una actualización del esquema.

• Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver 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 cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Próximos Pasos¶

Después de configurar una actualización de la base de datos o una actividad Upsert, puede usarla dentro de una operación o secuencia de comandos como se describe a continuación. Es posible que también desee configurar la fragmentación de datos para dividir los datos en porciones más pequeñas para su procesamiento.

Completa la Operación¶

Después de configurar una actividad de Actualización de base de datos o Upsert, 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 diferentes flujos de trabajo.

Una vez que se ha creado una actividad de Actualización de base de datos o Upsert, 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 actividad para detalles.

Las actividades de Actualización de base de datos o Upsert se pueden utilizar como objetivo con estos patrones de operación:

• Patrón de Transformación
• Patrón de dos transformaciones (solo como segundo objetivo)

Otros patrones no son válidos al utilizar las actividades de Actualización de base de datos o Upsert. 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 para reflejar un esquema proporcionado 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 se asignan campos dentro de este nodo adicional, el nodo se convierte en un nodo de bucle para permitir que se realicen bucles en todos los registros (consulte Nodos de bucle en Nodos y campos).

Además, si une tablas de bases de datos, tenga en cuenta que los valores de los campos unidos de una tabla secundaria son los valores predeterminados de los campos unidos de la tabla principal. No se pueden asignar los campos unidos de una tabla secundaria.

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

Uso de Actividades de Base de Datos en Secuencias de Comandos¶

También se puede hacer referencia a las actividades de actualización de la base de datos o Upsert en un secuencia de comandos para usar con funciones de secuencia de comandos que utilizan una base de datos target como parámetro, incluidos estos:

• 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 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 son de Oracle y que admiten claves de generación automática de números o de identidad. Después de insertar el padre, el hijo puede heredar el número generado del padre asignando esta función a la clave externa en la tabla secundaria.
• <SEQUENCE> realiza una acción similar con las bases de datos Oracle.

Usar Fragmentación¶

Cuando utilice fragmentación de datos en una operación donde el 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). Luego, estos archivos se combinan en un archivo de destino, que se envía a la base de datos para su inserción/actualización.

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

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